JsonDocument.Parse 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
多載
| 名稱 | Description |
|---|---|
| Parse(ReadOnlySequence<Byte>, JsonDocumentOptions) |
解析序列為 UTF-8 編碼的文字,代表單一 JSON 值,並建立 JsonDocument。 |
| Parse(Stream, JsonDocumentOptions) |
解析 Stream 一個以 UTF-8 編碼的單一 JSON 值的資料,並解析成 JsonDocument。 串流會被完整讀取。 |
| Parse(ReadOnlyMemory<Byte>, JsonDocumentOptions) |
將記憶體解析為 UTF-8 編碼的文字,代表單一 JSON 值,並建立 JsonDocument。 |
| Parse(ReadOnlyMemory<Char>, JsonDocumentOptions) |
解析代表單一 JSON 值的文字,進入 JsonDocument。 |
| Parse(String, JsonDocumentOptions) |
將代表單一 JSON 字串值的文字解析成 JsonDocument。 |
Parse(ReadOnlySequence<Byte>, JsonDocumentOptions)
解析序列為 UTF-8 編碼的文字,代表單一 JSON 值,並建立 JsonDocument。
public static System.Text.Json.JsonDocument Parse(System.Buffers.ReadOnlySequence<byte> utf8Json, System.Text.Json.JsonDocumentOptions options = default);
static member Parse : System.Buffers.ReadOnlySequence<byte> * System.Text.Json.JsonDocumentOptions -> System.Text.Json.JsonDocument
Public Shared Function Parse (utf8Json As ReadOnlySequence(Of Byte), Optional options As JsonDocumentOptions = Nothing) As JsonDocument
參數
- utf8Json
- ReadOnlySequence<Byte>
要解析的 JSON 文字。
- options
- JsonDocumentOptions
在解析過程中控制讀取器行為的選項。
傳回
JSON 值的 JsonDocument 表示。
例外狀況
utf8Json 不代表有效的單一 JSON 值。
options 包含不支援的選項。
備註
可 ReadOnlySequence<T> 使用該 JsonDocument 物件的整個生命週期,呼叫者必須確保其資料在物件生命週期內不會改變。 由於輸入被視為文字,因此不應包含 UTF-8 位元組Order-Mark(BOM)。
適用於
Parse(Stream, JsonDocumentOptions)
解析 Stream 一個以 UTF-8 編碼的單一 JSON 值的資料,並解析成 JsonDocument。 串流會被完整讀取。
public static System.Text.Json.JsonDocument Parse(System.IO.Stream utf8Json, System.Text.Json.JsonDocumentOptions options = default);
static member Parse : System.IO.Stream * System.Text.Json.JsonDocumentOptions -> System.Text.Json.JsonDocument
Public Shared Function Parse (utf8Json As Stream, Optional options As JsonDocumentOptions = Nothing) As JsonDocument
參數
- utf8Json
- Stream
要解析的 JSON 資料。
- options
- JsonDocumentOptions
在解析過程中控制讀取器行為的選項。
傳回
JSON 值的 JsonDocument 表示。
例外狀況
utf8Json 不代表有效的單一 JSON 值。
options 包含不支援的選項。
適用於
Parse(ReadOnlyMemory<Byte>, JsonDocumentOptions)
將記憶體解析為 UTF-8 編碼的文字,代表單一 JSON 值,並建立 JsonDocument。
public static System.Text.Json.JsonDocument Parse(ReadOnlyMemory<byte> utf8Json, System.Text.Json.JsonDocumentOptions options = default);
static member Parse : ReadOnlyMemory<byte> * System.Text.Json.JsonDocumentOptions -> System.Text.Json.JsonDocument
Public Shared Function Parse (utf8Json As ReadOnlyMemory(Of Byte), Optional options As JsonDocumentOptions = Nothing) As JsonDocument
參數
- utf8Json
- ReadOnlyMemory<Byte>
要解析的 JSON 文字。
- options
- JsonDocumentOptions
在解析過程中控制讀取器行為的選項。
傳回
JSON 值的 JsonDocument 表示。
例外狀況
utf8Json 不代表有效的單一 JSON 值。
options 包含不支援的選項。
備註
該 ReadOnlyMemory<T> 值將持續使用整個 JsonDocument 物件的生命週期,呼叫者必須確保其中的資料在物件生命週期內不會改變。
由於輸入被視為文字,因此不應包含 UTF-8 位元組Order-Mark(BOM)。
適用於
Parse(ReadOnlyMemory<Char>, JsonDocumentOptions)
解析代表單一 JSON 值的文字,進入 JsonDocument。
public static System.Text.Json.JsonDocument Parse(ReadOnlyMemory<char> json, System.Text.Json.JsonDocumentOptions options = default);
static member Parse : ReadOnlyMemory<char> * System.Text.Json.JsonDocumentOptions -> System.Text.Json.JsonDocument
Public Shared Function Parse (json As ReadOnlyMemory(Of Char), Optional options As JsonDocumentOptions = Nothing) As JsonDocument
參數
- json
- ReadOnlyMemory<Char>
要解析的 JSON 文字。
- options
- JsonDocumentOptions
在解析過程中控制讀取器行為的選項。
傳回
JSON 值的 JsonDocument 表示。
例外狀況
json 不代表有效的單一 JSON 值。
options 包含不支援的選項。
備註
該 ReadOnlyMemory<T> 值可持續使用於 JsonDocument 物件的整個生命週期,呼叫者必須確保其資料在物件生命週期內不會改變。
適用於
Parse(String, JsonDocumentOptions)
將代表單一 JSON 字串值的文字解析成 JsonDocument。
public static System.Text.Json.JsonDocument Parse(string json, System.Text.Json.JsonDocumentOptions options = default);
static member Parse : string * System.Text.Json.JsonDocumentOptions -> System.Text.Json.JsonDocument
Public Shared Function Parse (json As String, Optional options As JsonDocumentOptions = Nothing) As JsonDocument
參數
- json
- String
要解析的 JSON 文字。
- options
- JsonDocumentOptions
在解析過程中控制讀取器行為的選項。
傳回
JSON 值的 JsonDocument 表示。
例外狀況
json 不代表有效的單一 JSON 值。
options 包含不支援的選項。