Uri.EscapeUriString(String) メソッド

定義

名前空間:

System

アセンブリ:

netstandard.dll, System.Runtime.dll

ソース:

UriExt.cs

注意事項

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

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

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

[System.Obsolete("Uri.EscapeUriString can corrupt the Uri string in some cases. Consider using Uri.EscapeDataString for query string components instead.", DiagnosticId="SYSLIB0013", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
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 instead.", 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のエスケープされた表現。

属性

ObsoleteAttribute

例外

ArgumentNullException

stringToEscape は nullです。

UriFormatException

.NET Framework のみ: stringToEscape の長さが 32766 文字を超えています。

注釈

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

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

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

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

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