Uri.EscapeUriString(String) Uri.EscapeUriString(String) Uri.EscapeUriString(String) Uri.EscapeUriString(String) Method

定義

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

public:
 static System::String ^ EscapeUriString(System::String ^ stringToEscape);
public static string EscapeUriString (string stringToEscape);
static member EscapeUriString : string -> string
Public Shared Function EscapeUriString (stringToEscape As String) As String
パラメーター
stringToEscape
String String String String

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

戻り値

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

例外

stringToEscapenull です。 stringToEscape is null.

Windows ストア アプリ用 .NET またはポータブル クラス ライブラリでは、基本クラスの例外である FormatException を代わりにキャッチします。 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.

注釈

使用して、EscapeUriStringメソッドにパラメーター エスケープされていない URI 文字列を準備する、Uriコンス トラクター。Use the EscapeUriString method to prepare an unescaped URI string to be a parameter to the Uri constructor.

既定で、EscapeUriStringメソッドは、RFC 2396 予約されていない文字を除く、すべての文字を 16 進数表記に変換します。By default, the EscapeUriString method converts all characters, except RFC 2396 unreserved characters, to their hexadecimal representation. International Resource Identifier (Iri) や国際化ドメイン名 (IDN) 解析が有効になっている場合、EscapeUriStringすべてのメソッドに変換文字を除き RFC 3986 の予約文字の 16 進数表現をします。If International Resource Identifiers (IRIs) or Internationalized Domain Name (IDN) parsing is enabled, the EscapeUriString 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. International Resource Identifier (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.

適用対象