System.Text.Json 命名空間
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
提供高效能、低配置和標準相容的功能來處理 JavaScript 物件表示法 （JSON），其中包括將物件串行化為 JSON 文字，並將 JSON 文字還原串行化為物件，且 UTF-8 支援內建。 它也提供類型來讀取和寫入編碼為 UTF-8 的 JSON 文字，以及建立記憶體內部文件物件模型 （DOM），以在數據的結構化檢視中隨機存取 JSON 元素。
類別
| 名稱 | Description |
|---|---|
| JsonDocument |
提供檢查 JSON 值結構內容的機制，而不需要自動具現化數據值。 |
| JsonException |
定義一個自訂例外物件，當遇到無效的 JSON 文字、傳遞定義的最大深度，或 JSON 文字與物件屬性的型別不相容時，會拋出該物件。 |
| JsonNamingPolicy |
決定將字串為基礎的名稱轉換為其他格式（如駱駝套管格式）所使用的命名政策。 |
| JsonSerializer |
提供將物件或值類型序列化為 JSON 的功能，以及將 JSON 反序列化為物件或值類型。 |
| JsonSerializerOptions |
提供可搭配 JsonSerializer使用的選項。 |
| Utf8JsonWriter |
針對UTF-8編碼 JSON 文字的正向、非快取寫入，提供高效能 API。 |
結構
| 名稱 | Description |
|---|---|
| JsonDocumentOptions |
提供使用者在剖析 JSON 以建立 JsonDocument時定義自定義行為的能力。 |
| JsonElement |
表示 JsonDocument內的特定 JSON 值。 |
| JsonElement.ArrayEnumerator |
表示 JSON 陣列內容的列舉值。 |
| JsonElement.ObjectEnumerator |
表示 JSON 物件屬性的列舉值。 |
| JsonEncodedText |
提供將UTF-8或UTF-16編碼文字轉換成適合JSON之窗體的方法。 |
| JsonProperty |
表示 JSON 物件的單一屬性。 |
| JsonReaderOptions |
讓用戶能夠在讀取 JSON 時定義自定義行為。 |
| JsonReaderState |
定義不透明的類型，以保存並儲存所有相關的狀態資訊，必須提供給 Utf8JsonReader，才能在處理不完整的數據之後繼續讀取。 |
| JsonWriterOptions |
允許使用者在使用 Utf8JsonWriter撰寫 JSON 時定義自訂行為。 |
| Utf8JsonReader |
針對UTF-8編碼 JSON 文字的正向唯讀取，提供高效能 API。 |
列舉
| 名稱 | Description |
|---|---|
| JsonCommentHandling |
定義 Utf8JsonReader 結構如何處理批注。 |
| JsonSerializerDefaults |
指定案例型預設串行化選項，可用來建構 JsonSerializerOptions 實例。 |
| JsonTokenType |
定義組成 JSON 文字的各種 JSON 令牌。 |
| JsonValueKind |
指定 JSON 值的數據類型。 |
備註
另 System.Text.Json.Serialization 見命名空間，其中包含針對序列化與反序列化的高級情境及自訂的屬性與API。
欲了解更多資訊，請參閱 System.Text.Json 概述。
