Uri.EscapeUriString(String) メソッド

定義

注意事項

Uri.EscapeUriString can corrupt the Uri string in some cases. Consider using Uri.EscapeDataString for query string components.

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

public:
 static System::String ^ EscapeUriString(System::String ^ stringToEscape);
public static string EscapeUriString (string stringToEscape);
[System.Obsolete("Uri.EscapeUriString can corrupt the Uri string in some cases. Consider using Uri.EscapeDataString for query string components.", DiagnosticId="SYSLIB0013", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public static string EscapeUriString (string stringToEscape);
static member EscapeUriString : string -> string
[<System.Obsolete("Uri.EscapeUriString can corrupt the Uri string in some cases. Consider using Uri.EscapeDataString for query string components.", DiagnosticId="SYSLIB0013", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
static member EscapeUriString : string -> string
Public Shared Function EscapeUriString (stringToEscape As String) As String

パラメーター

stringToEscape
String

エスケープする文字列。

戻り値

String

stringToEscape のエスケープ表現。

属性

例外

stringToEscapenullです。

注: .net で Windows ストアアプリまたはポータブルクラスライブラリを使用する場合は、代わりに基底クラスの例外をキャッチして FormatException ください。

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

注釈

メソッドを使用して、 EscapeUriString エスケープされていない URI 文字列をコンストラクターのパラメーターとして準備し Uri ます。

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

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

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

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

適用対象