Request オブジェクト
Request オブジェクトは、HTTP 要求の中でクライアント ブラウザがサーバーに渡した値を取得します。
構文
Request[.collection|property|method]( variable )
コレクション
ClientCertificate | HTTP 要求の中で送信されたクライアント証明書に格納されているフィールドの値です。 |
Cookies | HTTP 要求の中で送信された cookie の値です。 |
Form | HTTP 要求本体のフォーム要素の値です。 |
QueryString | HTTP クエリ文字列の中の変数の値です。 |
ServerVariables | 定義済み環境変数の値です。 |
プロパティ
TotalBytes | 読み取り専用です。クライアントが要求本体の中で送信した合計バイト数を指定します。 |
メソッド
BinaryRead | POST 要求の一部としてクライアントからサーバーに送信されたデータを取得します。 |
variable パラメータは、コレクションから取得する項目、またはメソッドやプロパティへの入力として使用する項目を指定する文字列です。variable パラメータの詳細については、各コレクションの説明を参照してください。
解説
指定された変数が、上に示した 5 つのコレクションのいずれにもない場合、Request オブジェクトは EMPTY を返します。
コレクション名を指定せずに Request( variable ) という呼び出しを使用して変数に直接アクセスすることもできます。この場合、Web サーバーは次の順序でコレクションを探します。
- QueryString
- Form
- Cookies
- ClientCertificate
- ServerVariables
同じ名前を持つ変数が複数のコレクションにある場合、Request オブジェクトは、最初に見つけたインスタンスを返します。
コレクションのメンバを参照するときは、完全な名前を使用してください。たとえば、Request.( AUTH_USER ) ではなく、Request.ServerVariables( AUTH_USER ) のように指定してください。完全な名前を使用すると、サーバーはより速く項目を探すことができます。