Uri.EscapeDataString メソッド

定義

名前空間:

System

アセンブリ:

System.Runtime.dll

オーバーロード

EscapeDataString(String)

文字列をエスケープ表現に変換します。

EscapeDataString(String)

ソース:

UriExt.cs

文字列をエスケープ表現に変換します。

public:
 static System::String ^ EscapeDataString(System::String ^ stringToEscape);

public static string EscapeDataString (string stringToEscape);

static member EscapeDataString : string -> string

Public Shared Function EscapeDataString (stringToEscape As String) As String

パラメーター

stringToEscape

String

エスケープする文字列。

戻り値

String

stringToEscapeのエスケープ表現。

例外

ArgumentNullException

stringToEscape は nullです。

UriFormatException

注: Windows ストア アプリ用の .NET または ポータブル クラス ライブラリでは、代わりに基底クラスの例外である FormatExceptionをキャッチします。

stringToEscape の長さが 32766 文字を超えています。

注釈

既定では、EscapeDataString メソッドは、RFC 2396 の予約されていない文字を除くすべての文字を 16 進数表現に変換します。 国際リソース識別子 (IRI) または国際化ドメイン名 (IDN) の解析が有効になっている場合、EscapeDataString メソッドは、RFC 3986 の予約されていない文字を除くすべての文字を 16 進数表現に変換します。 エスケープされる前に、すべての Unicode 文字が UTF-8 形式に変換されます。

このメソッドは、stringToEscape にエスケープ シーケンスがないことを前提としています。

既定では、文字列は RFC 2396 に従ってエスケープされます。 国際リソース識別子 (IRI) または国際化ドメイン名 (IDN) の解析が有効になっている場合、文字列は RFC 3986 および RFC 3987 に従ってエスケープされます。 予約文字と予約されていない文字の定義については、これらの RFC を参照してください。

IRI サポートの詳細については、Uri クラスの「解説」セクションを参照してください。