HttpEncoder.HeaderNameValueEncode(String, String, String, String) メソッド

定義

名前空間:
System.Web.Util
アセンブリ:
System.Web.dll, System.Web.Services.dll

ヘッダー名と値を、HTTP ヘッダーとして使用できる文字列にエンコードします。

protected public:
 virtual void HeaderNameValueEncode(System::String ^ headerName, System::String ^ headerValue, [Runtime::InteropServices::Out] System::String ^ % encodedHeaderName, [Runtime::InteropServices::Out] System::String ^ % encodedHeaderValue);
protected internal virtual void HeaderNameValueEncode(string headerName, string headerValue, out string encodedHeaderName, out string encodedHeaderValue);
abstract member HeaderNameValueEncode : string * string * string * string -> unit
override this.HeaderNameValueEncode : string * string * string * string -> unit
Protected Friend Overridable Sub HeaderNameValueEncode (headerName As String, headerValue As String, ByRef encodedHeaderName As String, ByRef encodedHeaderValue As String)

パラメーター

headerName
String

エンコードする HTTP ヘッダー名。

headerValue
String

エンコードする HTTP ヘッダー値。

encodedHeaderName
String

このメソッドから制御が戻るときに、HTTP ヘッダーに使用するエンコードされた名前が含まれます。 このパラメーターは初期化せずに渡されます。

encodedHeaderValue
String

このメソッドから制御が戻るときに、HTTP ヘッダーに使用するエンコードされた値が格納されます。 このパラメーターは初期化せずに渡されます。

注釈

HeaderNameValueEncode メソッドは、headerNameから入力文字列を受け取り、パラメーターをheaderValueしてエンコードします。 エンコードされた値は out パラメーターとして返されます。

HeaderNameValueEncode メソッドでは、次のロジックを使用してヘッダーの名前と値をエンコードします。

  • Unicode 値が ASCII 文字 32 より小さい文字 (ASCII 文字 9 を除く) はすべて、%NN文字が 16 進値を表すN形式に URL エンコードされます。

  • ASCII 文字 9 (水平タブ文字) は URL エンコードされていません。

  • ASCII 文字 127 は、 %7Fとしてエンコードされます。

  • 他のすべての文字はエンコードされません。

    Note

    このメソッドは Unicode 値に使用できますが、通常は ASCII 範囲の値に使用されます。

HeaderNameValueEncodeがheaderValueまたは空の文字列の場合、encodedHeaderValue メソッドの既定の実装では、headerValue内のnullの値が返されます。 同様に、既定の実装では、headerNameがencodedHeaderNameまたは空の文字列の場合、headerNameでnullの値が返されます。

適用対象