WebUtility.UrlEncodeToBytes(Byte[], Int32, Int32) メソッド

定義

名前空間:

System.Net

アセンブリ:

netstandard.dll, System.Runtime.dll

ソース:

WebUtility.cs

バイト配列を URL でエンコードされたバイト配列に変換します。

public:
 static cli::array <System::Byte> ^ UrlEncodeToBytes(cli::array <System::Byte> ^ value, int offset, int count);

public static byte[]? UrlEncodeToBytes(byte[]? value, int offset, int count);

static member UrlEncodeToBytes : byte[] * int * int -> byte[]

Public Shared Function UrlEncodeToBytes (value As Byte(), offset As Integer, count As Integer) As Byte()

パラメーター

value

Byte[]

URL エンコードする Byte 配列。

offset

Int32

エンコードする Byte 配列の先頭からのオフセット (バイト単位)。

count

Int32

Byte配列からエンコードするカウント (バイト単位)。

返品

Byte[]

エンコードされた Byte 配列。

注釈

空白や句読点などの文字が HTTP ストリームで渡されると、受信側で誤って解釈される可能性があります。 URL エンコードは、URL で許可されていない文字を、16 進数のエスケープ シーケンスで構成される文字エンティティに置き換えます。 変換された文字列は、UTF-8 形式に準拠している必要があります。

URL エンコードは、文字、数字、および次の句読点文字を除くすべての文字コードを置き換えます。

• - (負符号)

• _ (アンダースコア)

• . (期間)

• ! (感嘆符)

• * (アスタリスク)

• ' (単一引用符)

• ( および ) (開始かっこと終わりかっこ)

各 ' ' (スペース) 文字は、 + (プラス) 文字に変換されます。

Note

'' (スペース) を '+' (プラス) 記号に置き換えることは、URI のクエリ部分 (標準ではなく慣例による) または HTTP コンテンツ application/x-www-form-urlencoded でのみ想定されます。 また、上記の置換 されない 文字の一覧は、 URL 仕様 と URI RFC 3986 のどちらにも対応していません。 RFC 準拠の変換には EscapeDataString を使用します。

たとえば、URL で送信されるテキスト ブロックに埋め込まれる場合、文字 < と > は %3c および %3eとしてエンコードされます。

UrlDecodeToBytesメソッドはエンコードを反転します。