Uri.EscapeUriString(String) メソッド

定義

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

エスケープする文字列。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.

注釈

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. 国際化リソース識別子 (虹彩) または国際化ドメイン名 (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. 国際化リソース識別子 (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.

適用対象