Sys.Net.WebRequest の httpVerb プロパティ
更新 : 2007 年 11 月
Web 要求を発行するために Sys.Net.WebRequest クラスによって使用された HTTP 動詞を取得または設定します。
.gif "メモ") メモ : |
|---|
クライアント API プロパティのプロパティ値を取得または設定するには、名前のプレフィックスが get_ および set_ のプロパティ アクセサ メソッドを呼び出す必要があります。たとえば、cancel のプロパティの値を取得または設定するには、get_cancel メソッドまたは set_cancel メソッドを呼び出します。 |
var verb = MyWebRequest.get_httpVerb();
MyWebRequest.set_httpVerb(value);
パラメータ
パラメータ |
説明 |
|---|---|
value |
Web 要求で使用する HTTP 動詞が格納された文字列。value は、"GET" や "POST" など、Web サーバーが認識する HTTP 動詞である必要があります。 |
戻り値
現在の Web 要求動詞。
例外
例外の種類 |
条件 |
|---|---|
value を null または空の文字列 ("") にすることはできません。 |
解説
HTTP 動詞が一度も設定されたことがない場合、httpVerb プロパティ値は次のロジックに基づいて決定されます。
body プロパティの値が null の場合、WebRequest インスタンスは "GET" を返します。
body プロパティの値が null ではない場合、WebRequest インスタンスは "POST" を返します。返された body が空の文字列 ("") だった場合、これは null ではなく、"POST" が返されたものと見なされます。
使用例
Web 要求の HTTP 動詞を設定する方法を次の例に示します。このコードは、WebRequest クラスの概要で説明しているコード例の一部分です。
// Set the request verb.
wRequest.set_httpVerb("POST");