Uri.EscapeDataString 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
多載
EscapeDataString(ReadOnlySpan<Char>) |
將範圍轉換為其逸出表示法。 |
EscapeDataString(String) |
將字串轉換成其逸出表示法。 |
EscapeDataString(ReadOnlySpan<Char>)
將範圍轉換為其逸出表示法。
public:
static System::String ^ EscapeDataString(ReadOnlySpan<char> charsToEscape);
public static string EscapeDataString (ReadOnlySpan<char> charsToEscape);
static member EscapeDataString : ReadOnlySpan<char> -> string
Public Shared Function EscapeDataString (charsToEscape As ReadOnlySpan(Of Char)) As String
參數
- charsToEscape
- ReadOnlySpan<Char>
要逸出的範圍。
傳回
charsToEscape
的逸出表示。
適用於
EscapeDataString(String)
- 來源:
- UriExt.cs
- 來源:
- UriExt.cs
- 來源:
- UriExt.cs
將字串轉換成其逸出表示法。
public:
static System::String ^ EscapeDataString(System::String ^ stringToEscape);
public static string EscapeDataString (string stringToEscape);
static member EscapeDataString : string -> string
Public Shared Function EscapeDataString (stringToEscape As String) As String
參數
- stringToEscape
- String
要逸出的字串。
傳回
stringToEscape
的逸出表示。
例外狀況
stringToEscape
null
。
注意:在適用於 Windows 市集應用程式的 .NET 中, 或 可攜式類別庫,改為攔截基類例外狀況,FormatException。
stringToEscape
長度超過 32766 個字元。
備註
根據預設,EscapeDataString 方法會將 RFC 2396 未保留字元以外的所有字元轉換成其十六進位表示法。 如果已啟用國際資源標識碼(IRI)或國際化功能變數名稱(IDN)剖析,則 EscapeDataString 方法會將 RFC 3986 未保留字元以外的所有字元轉換為其十六進位表示法。 所有 Unicode 字元都會在逸出之前轉換成 UTF-8 格式。
此方法假設 stringToEscape
中沒有逸出序列。
根據預設,字串會根據 RFC 2396 逸出。 如果已啟用國際資源標識碼 (IRIS) 或國際化功能變數名稱 (IDN) 剖析,則會根據 RFC 3986 和 RFC 3987 逸出字串。 如需保留和未保留字元的定義,請參閱這些 RFC。
如需 IRI 支援的詳細資訊,請參閱 Uri 類別的一節。