From eda78aa70dad85b8984c79cde91ee2aa47c6e2b9 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Thu, 19 Jun 2025 06:42:55 +0000
Subject: [PATCH 1/2] Initial plan for issue
From e9c2b6f08f5b4770396378139faddc7f1ebf8784 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Thu, 19 Jun 2025 06:48:34 +0000
Subject: [PATCH 2/2] Fix WriteXValue method documentation to remove
array-specific language
Co-authored-by: jeffhandley <1031940+jeffhandley@users.noreply.github.com>
---
xml/System.Text.Json/Utf8JsonWriter.xml | 66 ++++++++++++-------------
1 file changed, 33 insertions(+), 33 deletions(-)
diff --git a/xml/System.Text.Json/Utf8JsonWriter.xml b/xml/System.Text.Json/Utf8JsonWriter.xml
index dba64dd07f6..b7de000ea3e 100644
--- a/xml/System.Text.Json/Utf8JsonWriter.xml
+++ b/xml/System.Text.Json/Utf8JsonWriter.xml
@@ -781,8 +781,8 @@ The bytes are encoded before writing.
- The binary data to be written as a Base64 encoded JSON string element of a JSON array.
- Writes the raw bytes value as a Base64 encoded JSON string as an element of a JSON array.
+ The binary data to be written as a Base64 encoded JSON string.
+ Writes the raw bytes value as a Base64 encoded JSON string.
- The value to be written as a JSON literal true or false as an element of a JSON array.
- Writes a value (as a JSON literal true or false) as an element of a JSON array.
+ The value to be written as a JSON literal true or false.
+ Writes a value (as a JSON literal true or false).
To be added.
Validation is enabled, and the operation would result in writing invalid JSON.
@@ -1381,7 +1381,7 @@ The property name should already be escaped when the instance of
- Writes the JSON literal null as an element of a JSON array.
+ Writes the JSON literal null.
To be added.
Validation is enabled, and the operation would result in writing invalid JSON.
@@ -2720,8 +2720,8 @@ The property name should already be escaped when the instance of
- The value to be written as a JSON number as an element of a JSON array.
- Writes a value (as a JSON number) as an element of a JSON array.
+ The value to be written as a JSON number.
+ Writes a value (as a JSON number).
value using the default
- The value to be written as a JSON number as an element of a JSON array.
- Writes a value (as a JSON number) as an element of a JSON array.
+ The value to be written as a JSON number.
+ Writes a value (as a JSON number).
value using the default
- The value to be written as a JSON number as an element of a JSON array.
- Writes an value (as a JSON number) as an element of a JSON array.
+ The value to be written as a JSON number.
+ Writes an value (as a JSON number).
value using the default
- The value to be written as a JSON number as an element of a JSON array.
- Writes an value (as a JSON number) as an element of a JSON array.
+ The value to be written as a JSON number.
+ Writes an value (as a JSON number).
value using the default
- The value to be written as a JSON number as an element of a JSON array.
- Writes a value (as a JSON number) as an element of a JSON array.
+ The value to be written as a JSON number.
+ Writes a value (as a JSON number).
value using the default
- The value to be written as a JSON number as an element of a JSON array.
- Writes a value (as a JSON number) as an element of a JSON array.
+ The value to be written as a JSON number.
+ Writes a value (as a JSON number).
value using the default
- The value to be written as a JSON number as an element of a JSON array.
- Writes a value (as a JSON number) as an element of a JSON array.
+ The value to be written as a JSON number.
+ Writes a value (as a JSON number).
- The value to be written as a JSON string as an element of a JSON array.
- Writes a value (as a JSON string) as an element of a JSON array.
+ The value to be written as a JSON string.
+ Writes a value (as a JSON string).
- The value to be written as a JSON string as an element of a JSON array.
- Writes a value (as a JSON string) as an element of a JSON array.
+ The value to be written as a JSON string.
+ Writes a value (as a JSON string).
using the ISO 8601-1 extende
- The value to be written as a JSON string as an element of a JSON array.
- Writes a value (as a JSON string) as an element of a JSON array.
+ The value to be written as a JSON string.
+ Writes a value (as a JSON string).
value using the default
- The UTF-8 encoded value to be written as a JSON string element of a JSON array.
- Writes a UTF-8 text value (as a JSON string) as an element of a JSON array.
+ The UTF-8 encoded value to be written as a JSON string.
+ Writes a UTF-8 text value (as a JSON string).
- The UTF-16 encoded value to be written as a UTF-8 transcoded JSON string element of a JSON array.
- Writes a UTF-16 text value (as a JSON string) as an element of a JSON array.
+ The UTF-16 encoded value to be written as a UTF-8 transcoded JSON string.
+ Writes a UTF-16 text value (as a JSON string).
- The UTF-16 encoded value to be written as a UTF-8 transcoded JSON string element of a JSON array.
- Writes a string text value (as a JSON string) as an element of a JSON array.
+ The UTF-16 encoded value to be written as a UTF-8 transcoded JSON string.
+ Writes a string text value (as a JSON string).
- The JSON encoded value to be written as a UTF-8 transcoded JSON string element of a JSON array.
- Writes the pre-encoded text value (as a JSON string) as an element of a JSON array.
+ The JSON encoded value to be written as a UTF-8 transcoded JSON string.
+ Writes the pre-encoded text value (as a JSON string).