Uri.EscapeDataString(String) メソッド


文字列をエスケープ表現に変換します。Converts a string to its escaped representation.

 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



エスケープする文字列。The string to escape.



String のエスケープ表現を格納する stringToEscapeA String that contains the escaped representation of stringToEscape.


stringToEscapenullです。stringToEscape is null.

メモ:Windows ストア アプリ用 .NET またはポータブル クラス ライブラリでは、基本クラスの例外である FormatException を代わりにキャッチします。Note: In the .NET for Windows Store apps or the Portable Class Library, catch the base class exception, FormatException, instead.

stringToEscape の長さが 32766 文字を超えています。The length of stringToEscape exceeds 32766 characters.


既定では、EscapeDataString メソッドは、RFC 2396 の予約されていない文字を除くすべての文字を16進数表記に変換します。By default, the EscapeDataString method converts all characters except for RFC 2396 unreserved characters to their hexadecimal representation. 国際化リソース識別子 (虹彩) または国際化ドメイン名 (IDN) の解析が有効になっている場合、EscapeDataString メソッドは、RFC 3986 の予約されていない文字を除くすべての文字を16進数表記に変換します。If International Resource Identifiers (IRIs) or Internationalized Domain Name (IDN) parsing is enabled, the EscapeDataString method converts all characters, except for RFC 3986 unreserved characters, to their hexadecimal representation. エスケープされる前に、すべての Unicode 文字が UTF-8 形式に変換されます。All Unicode characters are converted to UTF-8 format before being escaped.

このメソッドは、stringToEscape にエスケープシーケンスが含まれていないことを前提としています。This method assumes that stringToEscape has no escape sequences in it.

既定では、文字列は RFC 2396 に従ってエスケープされます。By default, the string is escaped according to RFC 2396. 国際化リソース識別子 (Iri) または国際化ドメイン名 (IDN) の解析が有効になっている場合、文字列は RFC 3986 および RFC 3987 に従ってエスケープされます。If International Resource Identifiers (IRIs) or Internationalized Domain Name (IDN) parsing is enabled, the string is escaped according to RFC 3986 and RFC 3987. 予約文字と予約されていない文字の定義については、次の Rfc を参照してください。See these RFCs for a definition of reserved and unreserved characters.

IRI サポートの詳細については、Uri クラスの「解説」を参照してください。For more information on IRI support, see the Remarks section for the Uri class.