サンプルコードで学ぶASP

(PWS4 IIS4 IIS5)
CacheControl — プロキシ サーバーが ASP の出力をキャッシュできるかどうかを示します。

Response.CacheControl[= Cache Control Header]
Cache Control Header：Public または Private のいずれかの値をとるキャッシュ制御ヘッダーです。

説明

CacheControl プロパティは、既定値の Private を上書きします。このプロパティを Public に設定すると、プロキシ サーバーは ASP が生成した出力をキャッシュすることができます。

CacheControl を Public に設定すると、.asp ファイルのパフォーマンスが向上することがあります。.asp ファイルが要求ごとにカスタム HTML を生成する場合は、CacheControl を Public に設定しても、パフォーマンスは変化しません。Private および Public は文字列の値であるため、引用符 (” “) で囲む必要があります。

(PWS4 IIS4 IIS5)
Buffer — ページ出力をバッファに格納するかどうかを示します。

Response.Buffer[= flag]
flag：ページ出力をバッファに格納するかどうかを指定します。次のいずれかの値を指定できます。

説明

Buffer プロパティは、ページ出力をバッファに格納するかどうかを示します。ページ出力がバッファに格納されると、サーバーは現在のページのサーバースクリプトの処理がすべて完了するまで、あるいは Flush メソッドまたは End メソッドが呼び出されるまで、クライアントに応答を送信しません。
Buffer プロパティは、サーバーがクライアントに出力を送信した後で設定することはできません。このため、Response.Buffer の呼び出しは、.asp ファイルの先頭行に記述してください。

現在の .asp ファイルのバッファ処理が TRUE に設定されている場合、Flush メソッドを呼び出さなければ、サーバーはクライアントからのキープアライブ要求を優先します。これにより、サーバーはクライアント要求ごとに新しい接続を作成する必要がなくなるため、動作が速くなります。
ただし、バッファ処理を行うと、サーバーが現在のページのスクリプト処理をすべて完了するまで、クライアントに応答が表示されなくなります。このため、長いスクリプトでは処理の遅れが目立つことがあります。
メタベース内の ASPBufferingOn プロパティを使用すると、スクリプトのバッファ処理の既定値を設定できます。メタベースの使い方の詳細については、「IIS Admin オブジェクトを使用する」を参照してください。

Flush、End も参照ください。

(PWS4 IIS4 IIS5)
Cookies — このコレクションを使用して cookie の値を設定できます。

Response.Cookies( cookie )[( key )|.attribute] = value
cookie：cookie の名前です。
Key：省略可能なパラメータです。key を指定した場合、cookie は辞書とみなされ、key には value が設定されます。
attribute：cookie に関する情報を指定します。次のいずれかを属性パラメータに指定できます。

* Domain
* Expires
* HasKeys
* Path
* Secure

Value：key または attribute に割り当てる値を指定します。

説明

Cookies コレクションは cookie の値を設定します。指定された cookie が存在しない場合は、新しい cookie が作成されます。cookie が存在する場合は、新しい値を受け取り、古い値を破棄します。

例1.Cookiesの例

次のスクリプトのように、キーを付けて cookie を作成したとします。

すると、次のヘッダーが送信されます。

Set-Cookie:MYCOOKIE=TYPE1=sugar&TYPE2=ginger+snap

この後、キーを指定せずに myCookie への割り当てを行うと、type1 および type2 は破棄されます。この例を次に示します。

この例で、type1 と type2 のキーおよびその値は破棄され、myCookie という cookie の値は chocolate chip になります。
逆に、キーを付けて cookie を呼び出すと、cookie に含まれているキー以外の値が破棄されます。たとえば、上のコードの後で次のように Response.Cookies を呼び出します。

すると、値 chocolate chip は破棄され、newType に peanut butter が設定されます。
cookie がキーを持っているかどうかを調べるには、次の構文を使います。

myCookie が cookie 辞書であれば前の値は TRUE に評価され、そうでなければ FALSE に評価されます。
ループを使用すると cookie の属性を設定できます。たとえば、すべての cookie の有効期限が特定の日付に切れるように設定するには、次の構文を使います。

また、ループを使って、コレクション内のすべての cookie の値や、cookie 内のすべてのキーを設定することもできます。ただし、キーを持っていない cookie に対してはループが実行されません。これを防ぐには、.HasKeys の構文を使用して cookie がキーを持っているかどうかを先にチェックしておきます。以上の例を次に示します。

Cookiesコネクション,HasKeys も参照ください。

Response オブジェクトは、クライアントに出力を送信します。

* Cookies
* Buffer
* CacheControl
* Charset
* ContentTyep
* Domain
* Expires
* ExpiresAbsolute
* HasKeys
* IsClientConnected
* Path
* PICS
* Secure
* Status
* AddHeader
* AppendToLog
* BinaryWrite
* Clear
* End
* Flush
* Redirect
* Write

(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 も参照ください。

(PWS4 IIS4 IIS5)
HasKeys — 読み取り専用です。cookie にキーが含まれているかどうかを指定します。

Request.Cookies( cookie )[( key )|.HasKeys]
cookie：値を取得する cookie を指定します。
Key：cookie 辞書からサブキーの値を取得するために使用する省略可能なパラメータです。
説明

cookie が cookie 辞書であるかどうか (cookie がキーを持っているかどうか) を調べます。

myCookie が cookie 辞書であれば、上のスクリプトの値は TRUE に評価され、そうでなければ FALSE に評価されます。

Cookiesコネクション も参照ください。

(PWS4 IIS4 IIS5)
TotalBytes — 読み取り専用です。クライアントが要求本体の中で送信した合計バイト数を指定します。

Counter = Request.TotalBytes
Counter：クライアントが要求の中で送信する合計バイト数を取得するための変数を指定します。
説明

TotalBytes プロパティは、クライアントが要求本体の中で送信した合計バイト数を指定します。このプロパティは、読み取り専用です。

例1.TotalBytesの例

次のスクリプトは、要求オブジェクトに含まれる合計バイト数を変数に設定します。

BinaryRead も参照ください。

(PWS4 IIS4 IIS5)
Count — コレクション要素の数を返す

Request.Contents.Count

説明

コレクション中の要素を返します。Countプロパティは数を表示しますが、Keyプロパティではコレクションの要素名を確認することができます。 ASP3.0(IIS5.0)では、RemoveメソッドやRemoveAllメソッドを実行することで、追加した変数を削除することもできます。

例1.Countの例

Remove,RemoveAllも参照ください。

(PWS4 IIS4 IIS5)
ServerVariables — HTTP クエリ文字列内の変数の値を取得します。

Request.ServerVariables( server environment variable )
server environment variable：取得するサーバー環境変数の名前を指定します。次のいずれかの値を指定できます。

説明

ServerVariables コレクションは、定義済み環境変数の値を取得します

ループを使用して個々のサーバー変数名を解析できます。たとえば、次のスクリプトはすべてのサーバー変数名を表形式で出力します。

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

(PWS4 IIS4 IIS5)
QueryString — HTTP クエリ文字列内の変数の値を取得します。

Request.QueryString( variable )[( index )|.Count]
variable：HTTP クエリ文字列内にある、取得する変数の名前を指定します。
index：variable の複数の値のうちの 1 つを取得できるようにするための省略可能なパラメータです。1 ～ Request.QueryString( variable ).Count までの整数値を指定できます。

説明

QueryString コレクションは、ServerVariables コレクション内の変数 QUERY_STRING が解析されたものであり、QUERY_STRING の各変数を名前で参照することができます。Request.QueryString( parameter ) の値は、QUERY_STRING に出現するすべての parameter の値の配列になります。パラメータの値の数は、Request.QueryString( parameter ).Count を呼び出して調べることができます。変数に関連付けられているデータ セットが複数でない場合は、個数は 1 になります。変数が見つからない場合には、個数は 0 になります。
複数のデータ セットのうちの 1 つにある QueryString 変数を参照するには、index の値を指定します。パラメータ index には 1 ～ Request.QueryString( variable ).Count までの値を指定できます。index の値を指定せずに複数の QueryString 変数の 1 つを参照した場合、データはカンマで区切られた文字列として返されます。
Request.QueryString でパラメータを使用すると、サーバーはその要求に送られたパラメータを解析して、指定されたデータを返します。未解析の QueryString データがアプリケーションで必要な場合は、パラメータを指定せずに Request.QueryString を呼び出すことで取得できます。
ループを使用することで、クエリ文字列内のすべてのデータ値を解析できます。たとえば、次のような要求が送られたとします。

http://localhost/script/directory/NAMES.ASP?Q=Fred&Q=Sally

そして、Names.asp に次のスクリプトが記述されているとします。

すると、Names.asp には次のように表示されます。

上のスクリプトは、次のように Count を使用して記述することも可能です。

Formコレクション も参照ください。