サンプルコードで学ぶASP

(PWS4 IIS4 IIS5)
BinaryRead — POST 要求の一部としてクライアントからサーバーに送信されたデータを取得します。

variant = Request.BinaryRead( count )
variant：このメソッドが返す符合なしバイトの配列を含みます。このパラメータの型は、VT_ARRAY | VT_UI1 になります。これは、符号なし 1 バイト文字の可変配列です。
count：メソッドを実行する前に、クライアントから読み取るバイト数を指定します。メソッドを実行した後の count には、クライアントから正常に読み取ったバイト数が設定されます。実際にクライアントから読み取られるバイト数の合計は、 Request.TotalBytes と等しいか、またはこれより少なくなります。

説明

BinaryRead メソッドは、POST 要求の一部としてクライアントからサーバーに送信されたデータを取得します。このメソッドは、クライアントからデータを取得し、取得したデータをセーフ配列に格納します。セーフ配列は、次元の数と各次元の上限および下限に関する情報を含む配列です。

BinaryRead メソッドは、POST 要求の一部としてクライアントから送信された生のデータを読み取るときに使用します。BinaryRead メソッドは、データへの下位レベルのアクセスを行うときに使用するメソッドであり、Request.Form コレクションを使用して POST 要求で送信されたフォーム データを表示する場合などとは使用目的が異なります。BinaryRead を呼び出した後で Request.Form コレクション内のいずれかの変数を参照すると、エラーが発生します。同様に、Request.Form コレクション内の変数を参照した後で BinaryWrite を呼び出すと、エラーが発生します。このため、変数がどのサブコレクションに属しているかを指定せずに Request コレクション内の変数にアクセスする場合は注意が必要です。Request.Form コレクションが検索の対象になると、エラーが発生するからです。

例1.BinaryReadの例

次の例は、BinaryRead メソッドを使用して、要求の内容をセーフ配列に格納します。

TotalBytes、ClientCertificate、Cookies、Form、QueryString、ServerVariables も参照ください。