/// <summary>
/// Writes the UTF-8 property name and UTF-8 text value (as a JSON string) as part of a name/value pair of a JSON object.
/// </summary>
/// <param name="utf8PropertyName">The UTF-8 encoded property name of the JSON object to be written.</param>
/// <param name="utf8Value">The UTF-8 encoded value to be written as a JSON string as part of the name/value pair.</param>
/// <remarks>
/// The property name and value is escaped before writing.
/// </remarks>
/// <exception cref="ArgumentException">
/// Thrown when the specified property name or value is too large.
/// </exception>
/// <exception cref="InvalidOperationException">
/// Thrown if this would result in an invalid JSON to be written (while validation is enabled).
/// </exception>
public void WriteString(ReadOnlySpan <byte> utf8PropertyName, ReadOnlySpan <byte> utf8Value)
{
JsonWriterHelper.ValidatePropertyAndValue(utf8PropertyName, utf8Value);
WriteStringEscape(utf8PropertyName, utf8Value);
SetFlagToAddListSeparatorBeforeNextItem();
_tokenType = JsonTokenType.String;
}
/// <summary>
/// Writes the UTF-16 property name and UTF-16 text value (as a JSON string) as part of a name/value pair of a JSON object.
/// </summary>
/// <param name="propertyName">The UTF-16 encoded property name of the JSON object to be transcoded and written as UTF-8.</param>
/// <param name="value">The UTF-16 encoded value to be written as a UTF-8 transcoded JSON string as part of the name/value pair.</param>
/// <param name="escape">If this is set to false, the writer assumes the property name is properly escaped and skips the escaping step.
/// The value is always escaped</param>
/// <exception cref="ArgumentException">
/// Thrown when the specified property name or value is too large.
/// </exception>
/// <exception cref="InvalidOperationException">
/// Thrown if this would result in an invalid JSON to be written (while validation is enabled).
/// </exception>
public void WriteString(ReadOnlySpan <char> propertyName, ReadOnlySpan <char> value, bool escape = true)
{
JsonWriterHelper.ValidatePropertyAndValue(propertyName, value);
if (escape)
{
WriteStringEscape(propertyName, value);
}
else
{
WriteStringDontEscape(propertyName, value);
}
SetFlagToAddListSeparatorBeforeNextItem();
_tokenType = JsonTokenType.String;
}