Uri.EscapeUriString(String) メソッド

定義

名前空間:

System

アセンブリ:

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

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

    Note: In <a href="https://learn.microsoft.com/previous-versions/br230232(v=vs.110)">.NET for Windows Store apps</a> or the <a href="https://learn.microsoft.com/dotnet/standard/cross-platform/cross-platform-development-with-the-portable-class-library">Portable Class Library</a>, catch the base class exception, <xref data-throw-if-not-resolved="true" uid="System.FormatException"></xref>, instead.

注釈

コンストラクターの 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 参照してください。