Utf8JsonWriter.WriteNumber Method

Definition

Namespace:

System.Text.Json

Assembly:

System.Text.Json.dll

Overloads

WriteNumber(String, Int32)	Writes a property name specified as a string and an Int32 value (as a JSON number) as part of a name/value pair of a JSON object.
WriteNumber(String, Int64)	Writes a property name specified as a string and an Int64 value (as a JSON number) as part of a name/value pair of a JSON object.
WriteNumber(String, Single)	Writes a property name specified as a string and a Single value (as a JSON number) as part of a name/value pair of a JSON object.
WriteNumber(String, UInt32)	Writes a property name specified as a string and a UInt32 value (as a JSON number) as part of a name/value pair of a JSON object.
WriteNumber(String, UInt64)	Writes a property name specified as a string and a UInt64 value (as a JSON number) as part of a name/value pair of a JSON object.
WriteNumber(JsonEncodedText, Single)	Writes the pre-encoded property name and Single value (as a JSON number) as part of a name/value pair of a JSON object.
WriteNumber(JsonEncodedText, Double)	Writes the pre-encoded property name and Double value (as a JSON number) as part of a name/value pair of a JSON object.
WriteNumber(JsonEncodedText, Int32)	Writes the pre-encoded property name and Int32 value (as a JSON number) as part of a name/value pair of a JSON object.
WriteNumber(JsonEncodedText, Int64)	Writes the pre-encoded property name and Int64 value (as a JSON number) as part of a name/value pair of a JSON object.
WriteNumber(String, Double)	Writes a property name specified as a string and a Double value (as a JSON number) as part of a name/value pair of a JSON object.
WriteNumber(JsonEncodedText, UInt32)	Writes the pre-encoded property name and UInt32 value (as a JSON number) as part of a name/value pair of a JSON object.
WriteNumber(JsonEncodedText, Decimal)	Writes the pre-encoded property name and Decimal value (as a JSON number) as part of a name/value pair of a JSON object.
WriteNumber(String, Decimal)	Writes a property name specified as a string and a Decimal value (as a JSON number) as part of a name/value pair of a JSON object.
WriteNumber(JsonEncodedText, UInt64)	Writes the pre-encoded property name and UInt64 value (as a JSON number) as part of a name/value pair of a JSON object.
WriteNumber(ReadOnlySpan<Char>, UInt32)	Writes a property name specified as a read-only character span and a UInt32 value (as a JSON number) as part of a name/value pair of a JSON object.
WriteNumber(ReadOnlySpan<Byte>, Decimal)	Writes a property name specified as a read-only span of bytes and a Decimal value (as a JSON number) as part of a name/value pair of a JSON object.
WriteNumber(ReadOnlySpan<Byte>, Double)	Writes a property name specified as a read-only span of bytes and a Double value (as a JSON number) as part of a name/value pair of a JSON object.
WriteNumber(ReadOnlySpan<Byte>, Int32)	Writes a property name specified as a read-only span of bytes and an Int32 value (as a JSON number) as part of a name/value pair of a JSON object.
WriteNumber(ReadOnlySpan<Byte>, Int64)	Writes a property name specified as a read-only span of bytes and an Int64 value (as a JSON number) as part of a name/value pair of a JSON object.
WriteNumber(ReadOnlySpan<Byte>, Single)	Writes a property name specified as a read-only span of bytes and a Single value (as a JSON number) as part of a name/value pair of a JSON object.
WriteNumber(ReadOnlySpan<Byte>, UInt32)	Writes a property name specified as a read-only span of bytes and a UInt32 value (as a JSON number) as part of a name/value pair of a JSON object.
WriteNumber(ReadOnlySpan<Char>, UInt64)	Writes a property name specified as a read-only character span and a UInt64 value (as a JSON number) as part of a name/value pair of a JSON object.
WriteNumber(ReadOnlySpan<Char>, Decimal)	Writes a property name specified as a read-only character span and a Decimal value (as a JSON number) as part of a name/value pair of a JSON object.
WriteNumber(ReadOnlySpan<Char>, Double)	Writes a property name specified as a read-only character span and a Double value (as a JSON number) as part of a name/value pair of a JSON object.
WriteNumber(ReadOnlySpan<Char>, Int32)	Writes a property name specified as a read-only character span and an Int32 value (as a JSON number) as part of a name/value pair of a JSON object.
WriteNumber(ReadOnlySpan<Char>, Int64)	Writes a property name specified as a read-only character span and an Int64 value (as a JSON number) as part of a name/value pair of a JSON object.
WriteNumber(ReadOnlySpan<Char>, Single)	Writes a property name specified as a read-only character span and a Single value (as a JSON number) as part of a name/value pair of a JSON object.
WriteNumber(ReadOnlySpan<Byte>, UInt64)	Writes a property name specified as a read-only span of bytes and a UInt64 value (as a JSON number) as part of a name/value pair of a JSON object.

WriteNumber(String, Int32)

Source:

Utf8JsonWriter.WriteProperties.SignedNumber.cs

Writes a property name specified as a string and an Int32 value (as a JSON number) as part of a name/value pair of a JSON object.

public:
 void WriteNumber(System::String ^ propertyName, int value);

public void WriteNumber (string propertyName, int value);

member this.WriteNumber : string * int -> unit

Public Sub WriteNumber (propertyName As String, value As Integer)

Parameters

propertyName

String

The UTF-16 encoded property name of the JSON object to be transcoded and written as UTF-8.

value

Int32

The value to be written as a JSON number as part of the name/value pair.

Exceptions

ArgumentException

The specified property name is too large.

InvalidOperationException

Validation is enabled, and the write operation would produce invalid JSON.

ArgumentNullException

The propertyName parameter is null.

Remarks

Writes the Int32 using the default StandardFormat (that is, 'G'); for example, 32767.

The property name is escaped before writing.

WriteNumber(String, Int64)

Source:

Utf8JsonWriter.WriteProperties.SignedNumber.cs

Writes a property name specified as a string and an Int64 value (as a JSON number) as part of a name/value pair of a JSON object.

public:
 void WriteNumber(System::String ^ propertyName, long value);

public void WriteNumber (string propertyName, long value);

member this.WriteNumber : string * int64 -> unit

Public Sub WriteNumber (propertyName As String, value As Long)

Parameters

propertyName

String

The UTF-16 encoded property name of the JSON object to be transcoded and written as UTF-8.

value

Int64

The value to be written as a JSON number as part of the name/value pair.

Exceptions

ArgumentException

The specified property name is too large.

InvalidOperationException

Validation is enabled, and the write operation would produce invalid JSON.

ArgumentNullException

The propertyName parameter is null.

Remarks

Writes the Int64 using the default StandardFormat (that is, 'G'); for example, 32767.

The property name is escaped before writing.

WriteNumber(String, Single)

Source:

Utf8JsonWriter.WriteProperties.Float.cs

Writes a property name specified as a string and a Single value (as a JSON number) as part of a name/value pair of a JSON object.

public:
 void WriteNumber(System::String ^ propertyName, float value);

public void WriteNumber (string propertyName, float value);

member this.WriteNumber : string * single -> unit

Public Sub WriteNumber (propertyName As String, value As Single)

Parameters

propertyName

String

The UTF-16 encoded property name of the JSON object to be transcoded and written as UTF-8.

value

Single

The value to be written as a JSON number as part of the name/value pair.

Exceptions

ArgumentException

The specified property name is too large.

InvalidOperationException

Validation is enabled, and the write operation would produce invalid JSON.

ArgumentNullException

The propertyName parameter is null.

Remarks

Writes the Single using the default StandardFormat (that is, 'G') on .NET Core 3.0 or later versions. Uses 'G9' on any other framework.

The property name is escaped before writing.

WriteNumber(String, UInt32)

Source:

Utf8JsonWriter.WriteProperties.UnsignedNumber.cs

Important

This API is not CLS-compliant.

Writes a property name specified as a string and a UInt32 value (as a JSON number) as part of a name/value pair of a JSON object.

public:
 void WriteNumber(System::String ^ propertyName, System::UInt32 value);

[System.CLSCompliant(false)]
public void WriteNumber (string propertyName, uint value);

[<System.CLSCompliant(false)>]
member this.WriteNumber : string * uint32 -> unit

Public Sub WriteNumber (propertyName As String, value As UInteger)

Parameters

propertyName

String

The UTF-16 encoded property name of the JSON object to be transcoded and written as UTF-8.

value

UInt32

The value to be written as a JSON number as part of the name/value pair.

Attributes

CLSCompliantAttribute

Exceptions

ArgumentException

The specified property name is too large.

InvalidOperationException

Validation is enabled, and the write operation would produce invalid JSON.

ArgumentNullException

The propertyName parameter is null.

Remarks

Writes the UInt32 using the default StandardFormat (that is, 'G'); for example, 32767.

The property name is escaped before writing.

WriteNumber(String, UInt64)

Source:

Utf8JsonWriter.WriteProperties.UnsignedNumber.cs

Important

This API is not CLS-compliant.

Writes a property name specified as a string and a UInt64 value (as a JSON number) as part of a name/value pair of a JSON object.

public:
 void WriteNumber(System::String ^ propertyName, System::UInt64 value);

[System.CLSCompliant(false)]
public void WriteNumber (string propertyName, ulong value);

[<System.CLSCompliant(false)>]
member this.WriteNumber : string * uint64 -> unit

Public Sub WriteNumber (propertyName As String, value As ULong)

Parameters

propertyName

String

The UTF-16 encoded property name of the JSON object to be transcoded and written as UTF-8.

value

UInt64

The value to be written as a JSON number as part of the name/value pair.

Attributes

CLSCompliantAttribute

Exceptions

ArgumentException

The specified property name is too large.

InvalidOperationException

Validation is enabled, and the write operation would produce invalid JSON.

ArgumentNullException

The propertyName parameter is null.

Remarks

Writes the UInt64 using the default StandardFormat (that is, 'G'); for example, 32767.

The property name is escaped before writing.

WriteNumber(JsonEncodedText, Single)

Source:

Utf8JsonWriter.WriteProperties.Float.cs

Writes the pre-encoded property name and Single value (as a JSON number) as part of a name/value pair of a JSON object.

public:
 void WriteNumber(System::Text::Json::JsonEncodedText propertyName, float value);

public void WriteNumber (System.Text.Json.JsonEncodedText propertyName, float value);

member this.WriteNumber : System.Text.Json.JsonEncodedText * single -> unit

Public Sub WriteNumber (propertyName As JsonEncodedText, value As Single)

Parameters

propertyName

JsonEncodedText

The JSON encoded property name of the JSON object to be transcoded and written as UTF-8.

value

Single

The value to be written as a JSON number as part of the name/value pair.

Exceptions

InvalidOperationException

Validation is enabled, and this method would result in writing invalid JSON.

Remarks

Writes the Single using the default StandardFormat (that is, 'G') on .NET Core 3.0 or later versions. Uses 'G9' on any other framework.

The property name should already be escaped when the instance of JsonEncodedText was created.

WriteNumber(JsonEncodedText, Double)

Source:

Utf8JsonWriter.WriteProperties.Double.cs

Writes the pre-encoded property name and Double value (as a JSON number) as part of a name/value pair of a JSON object.

public:
 void WriteNumber(System::Text::Json::JsonEncodedText propertyName, double value);

public void WriteNumber (System.Text.Json.JsonEncodedText propertyName, double value);

member this.WriteNumber : System.Text.Json.JsonEncodedText * double -> unit

Public Sub WriteNumber (propertyName As JsonEncodedText, value As Double)

Parameters

propertyName

JsonEncodedText

The JSON encoded property name of the JSON object to be transcoded and written as UTF-8.

value

Double

The value to be written as a JSON number as part of the name/value pair.

Exceptions

InvalidOperationException

Validation is enabled, and this method would result in writing invalid JSON.

Remarks

Writes the Double using the default StandardFormat (that is, 'G') on .NET Core 3.0 or later versions. Uses 'G17' on any other framework.

The property name should already be escaped when the instance of JsonEncodedText was created.

WriteNumber(JsonEncodedText, Int32)

Source:

Utf8JsonWriter.WriteProperties.SignedNumber.cs

Writes the pre-encoded property name and Int32 value (as a JSON number) as part of a name/value pair of a JSON object.

public:
 void WriteNumber(System::Text::Json::JsonEncodedText propertyName, int value);

public void WriteNumber (System.Text.Json.JsonEncodedText propertyName, int value);

member this.WriteNumber : System.Text.Json.JsonEncodedText * int -> unit

Public Sub WriteNumber (propertyName As JsonEncodedText, value As Integer)

Parameters

propertyName

JsonEncodedText

The JSON encoded property name of the JSON object to be transcoded and written as UTF-8.

value

Int32

The value to be written as a JSON number as part of the name/value pair.

Exceptions

InvalidOperationException

Validation is enabled, and this method would result in writing invalid JSON.

Remarks

Writes the Int32 using the default StandardFormat (that is, 'G'); for example, 32767.

The property name should already be escaped when the instance of JsonEncodedText was created.

WriteNumber(JsonEncodedText, Int64)

Source:

Utf8JsonWriter.WriteProperties.SignedNumber.cs

Writes the pre-encoded property name and Int64 value (as a JSON number) as part of a name/value pair of a JSON object.

public:
 void WriteNumber(System::Text::Json::JsonEncodedText propertyName, long value);

public void WriteNumber (System.Text.Json.JsonEncodedText propertyName, long value);

member this.WriteNumber : System.Text.Json.JsonEncodedText * int64 -> unit

Public Sub WriteNumber (propertyName As JsonEncodedText, value As Long)

Parameters

propertyName

JsonEncodedText

The JSON encoded property name of the JSON object to be transcoded and written as UTF-8.

value

Int64

The value to be written as a JSON number as part of the name/value pair.

Exceptions

InvalidOperationException

Validation is enabled, and this method would result in writing invalid JSON.

Remarks

Writes the Int64 using the default StandardFormat (this is, 'G'); for example, 32767.

The property name should already be escaped when the instance of JsonEncodedText was created.

WriteNumber(String, Double)

Source:

Utf8JsonWriter.WriteProperties.Double.cs

Writes a property name specified as a string and a Double value (as a JSON number) as part of a name/value pair of a JSON object.

public:
 void WriteNumber(System::String ^ propertyName, double value);

public void WriteNumber (string propertyName, double value);

member this.WriteNumber : string * double -> unit

Public Sub WriteNumber (propertyName As String, value As Double)

Parameters

propertyName

String

The UTF-16 encoded property name of the JSON object to be transcoded and written as UTF-8.

value

Double

The value to be written as a JSON number as part of the name/value pair.

Exceptions

ArgumentException

The specified property name is too large.

InvalidOperationException

Validation is enabled, and the write operation would produce invalid JSON.

ArgumentNullException

The propertyName parameter is null.

Remarks

Writes the Double using the default StandardFormat (that is, 'G') on .NET Core 3.0 or later versions. Uses 'G17' on any other framework.

The property name is escaped before writing.

WriteNumber(JsonEncodedText, UInt32)

Source:

Utf8JsonWriter.WriteProperties.UnsignedNumber.cs

Important

This API is not CLS-compliant.

Writes the pre-encoded property name and UInt32 value (as a JSON number) as part of a name/value pair of a JSON object.

public:
 void WriteNumber(System::Text::Json::JsonEncodedText propertyName, System::UInt32 value);

[System.CLSCompliant(false)]
public void WriteNumber (System.Text.Json.JsonEncodedText propertyName, uint value);

[<System.CLSCompliant(false)>]
member this.WriteNumber : System.Text.Json.JsonEncodedText * uint32 -> unit

Public Sub WriteNumber (propertyName As JsonEncodedText, value As UInteger)

Parameters

propertyName

JsonEncodedText

The JSON encoded property name of the JSON object to be transcoded and written as UTF-8.

value

UInt32

The value to be written as a JSON number as part of the name/value pair.

Attributes

CLSCompliantAttribute

Exceptions

InvalidOperationException

Validation is enabled, and this method would result in writing invalid JSON.

Remarks

Writes the UInt32 using the default StandardFormat (that is, 'G'); for example, 32767.

The property name should already be escaped when the instance of JsonEncodedText was created.

WriteNumber(JsonEncodedText, Decimal)

Source:

Utf8JsonWriter.WriteProperties.Decimal.cs

Writes the pre-encoded property name and Decimal value (as a JSON number) as part of a name/value pair of a JSON object.

public:
 void WriteNumber(System::Text::Json::JsonEncodedText propertyName, System::Decimal value);

public void WriteNumber (System.Text.Json.JsonEncodedText propertyName, decimal value);

member this.WriteNumber : System.Text.Json.JsonEncodedText * decimal -> unit

Public Sub WriteNumber (propertyName As JsonEncodedText, value As Decimal)

Parameters

propertyName

JsonEncodedText

The JSON encoded property name of the JSON object to be transcoded and written as UTF-8.

value

Decimal

The value to be written as a JSON number as part of the name/value pair.

Exceptions

InvalidOperationException

Validation is enabled, and this method would result in writing invalid JSON.

Remarks

Writes the Decimal using the default StandardFormat (that is, 'G').

The property name should already be escaped when the instance of JsonEncodedText was created.

WriteNumber(String, Decimal)

Source:

Utf8JsonWriter.WriteProperties.Decimal.cs

Writes a property name specified as a string and a Decimal value (as a JSON number) as part of a name/value pair of a JSON object.

public:
 void WriteNumber(System::String ^ propertyName, System::Decimal value);

public void WriteNumber (string propertyName, decimal value);

member this.WriteNumber : string * decimal -> unit

Public Sub WriteNumber (propertyName As String, value As Decimal)

Parameters

propertyName

String

The UTF-16 encoded property name of the JSON object to be transcoded and written as UTF-8.

value

Decimal

The value to be written as a JSON number as part of the name/value pair.

Exceptions

ArgumentException

The specified property name is too large.

InvalidOperationException

Validation is enabled, and the write operation would produce invalid JSON.

ArgumentNullException

The propertyName parameter is null.

Remarks

Writes the Decimal using the default StandardFormat (that is, 'G').

The property name is escaped before writing.

WriteNumber(JsonEncodedText, UInt64)

Source:

Utf8JsonWriter.WriteProperties.UnsignedNumber.cs

Important

This API is not CLS-compliant.

Writes the pre-encoded property name and UInt64 value (as a JSON number) as part of a name/value pair of a JSON object.

public:
 void WriteNumber(System::Text::Json::JsonEncodedText propertyName, System::UInt64 value);

[System.CLSCompliant(false)]
public void WriteNumber (System.Text.Json.JsonEncodedText propertyName, ulong value);

[<System.CLSCompliant(false)>]
member this.WriteNumber : System.Text.Json.JsonEncodedText * uint64 -> unit

Public Sub WriteNumber (propertyName As JsonEncodedText, value As ULong)

Parameters

propertyName

JsonEncodedText

The JSON encoded property name of the JSON object to be transcoded and written as UTF-8.

value

UInt64

The value to be written as a JSON number as part of the name/value pair.

Attributes

CLSCompliantAttribute

Exceptions

InvalidOperationException

Validation is enabled, and this method would result in writing invalid JSON.

Remarks

Writes the UInt64 using the default StandardFormat (that is, 'G'); for example, 32767.

The property name should already be escaped when the instance of JsonEncodedText was created.

WriteNumber(ReadOnlySpan<Char>, UInt32)

Source:

Utf8JsonWriter.WriteProperties.UnsignedNumber.cs

Important

This API is not CLS-compliant.

Writes a property name specified as a read-only character span and a UInt32 value (as a JSON number) as part of a name/value pair of a JSON object.

public:
 void WriteNumber(ReadOnlySpan<char> propertyName, System::UInt32 value);

[System.CLSCompliant(false)]
public void WriteNumber (ReadOnlySpan<char> propertyName, uint value);

[<System.CLSCompliant(false)>]
member this.WriteNumber : ReadOnlySpan<char> * uint32 -> unit

Public Sub WriteNumber (propertyName As ReadOnlySpan(Of Char), value As UInteger)

Parameters

propertyName

ReadOnlySpan<Char>

The UTF-16 encoded property name of the JSON object to be transcoded and written as UTF-8.

value

UInt32

The value to be written as a JSON number as part of the name/value pair.

Attributes

CLSCompliantAttribute

Exceptions

ArgumentException

The specified property name is too large.

InvalidOperationException

Validation is enabled, and the write operation would produce invalid JSON.

Remarks

Writes the UInt32 using the default StandardFormat (that is, 'G'); for example, 32767.

The property name is escaped before writing.

WriteNumber(ReadOnlySpan<Byte>, Decimal)

Source:

Utf8JsonWriter.WriteProperties.Decimal.cs

Writes a property name specified as a read-only span of bytes and a Decimal value (as a JSON number) as part of a name/value pair of a JSON object.

public:
 void WriteNumber(ReadOnlySpan<System::Byte> utf8PropertyName, System::Decimal value);

public void WriteNumber (ReadOnlySpan<byte> utf8PropertyName, decimal value);

member this.WriteNumber : ReadOnlySpan<byte> * decimal -> unit

Public Sub WriteNumber (utf8PropertyName As ReadOnlySpan(Of Byte), value As Decimal)

Parameters

utf8PropertyName

ReadOnlySpan<Byte>

The UTF-8 encoded property name of the JSON object to be written.

value

Decimal

The value to be written as a JSON number as part of the name/value pair.

Exceptions

ArgumentException

The specified property name is too large.

InvalidOperationException

Validation is enabled, and the write operation would produce invalid JSON.

Remarks

Writes the Decimal using the default StandardFormat (that is, 'G').

The property name is escaped before writing.

WriteNumber(ReadOnlySpan<Byte>, Double)

Source:

Utf8JsonWriter.WriteProperties.Double.cs

Writes a property name specified as a read-only span of bytes and a Double value (as a JSON number) as part of a name/value pair of a JSON object.

public:
 void WriteNumber(ReadOnlySpan<System::Byte> utf8PropertyName, double value);

public void WriteNumber (ReadOnlySpan<byte> utf8PropertyName, double value);

member this.WriteNumber : ReadOnlySpan<byte> * double -> unit

Public Sub WriteNumber (utf8PropertyName As ReadOnlySpan(Of Byte), value As Double)

Parameters

utf8PropertyName

ReadOnlySpan<Byte>

The UTF-8 encoded property name of the JSON object to be written.

value

Double

The value to be written as a JSON number as part of the name/value pair.

Exceptions

ArgumentException

The specified property name is too large.

InvalidOperationException

Validation is enabled, and the write operation would produce invalid JSON.

Remarks

Writes the Double using the default StandardFormat (that is, 'G') on .NET Core 3.0 or later versions. Uses 'G17' on any other framework.

The property name is escaped before writing.

WriteNumber(ReadOnlySpan<Byte>, Int32)

Source:

Utf8JsonWriter.WriteProperties.SignedNumber.cs

Writes a property name specified as a read-only span of bytes and an Int32 value (as a JSON number) as part of a name/value pair of a JSON object.

public:
 void WriteNumber(ReadOnlySpan<System::Byte> utf8PropertyName, int value);

public void WriteNumber (ReadOnlySpan<byte> utf8PropertyName, int value);

member this.WriteNumber : ReadOnlySpan<byte> * int -> unit

Public Sub WriteNumber (utf8PropertyName As ReadOnlySpan(Of Byte), value As Integer)

Parameters

utf8PropertyName

ReadOnlySpan<Byte>

The UTF-8 encoded property name of the JSON object to be written.

value

Int32

The value to be written as a JSON number as part of the name/value pair.

Exceptions

ArgumentException

The specified property name is too large.

InvalidOperationException

Validation is enabled, and the write operation would produce invalid JSON.

Remarks

Writes the Int32 using the default StandardFormat (that is, 'G'); for example, 32767.

The property name is escaped before writing.

WriteNumber(ReadOnlySpan<Byte>, Int64)

Source:

Utf8JsonWriter.WriteProperties.SignedNumber.cs

Writes a property name specified as a read-only span of bytes and an Int64 value (as a JSON number) as part of a name/value pair of a JSON object.

public:
 void WriteNumber(ReadOnlySpan<System::Byte> utf8PropertyName, long value);

public void WriteNumber (ReadOnlySpan<byte> utf8PropertyName, long value);

member this.WriteNumber : ReadOnlySpan<byte> * int64 -> unit

Public Sub WriteNumber (utf8PropertyName As ReadOnlySpan(Of Byte), value As Long)

Parameters

utf8PropertyName

ReadOnlySpan<Byte>

The UTF-8 encoded property name of the JSON object to be written.

value

Int64

The value to be written as a JSON number as part of the name/value pair.

Exceptions

ArgumentException

The specified property name is too large.

InvalidOperationException

Validation is enabled, and the write operation would produce invalid JSON.

Remarks

Writes the Int64 using the default StandardFormat (that is, 'G'); for example, 32767.

The property name is escaped before writing.

WriteNumber(ReadOnlySpan<Byte>, Single)

Source:

Utf8JsonWriter.WriteProperties.Float.cs

Writes a property name specified as a read-only span of bytes and a Single value (as a JSON number) as part of a name/value pair of a JSON object.

public:
 void WriteNumber(ReadOnlySpan<System::Byte> utf8PropertyName, float value);

public void WriteNumber (ReadOnlySpan<byte> utf8PropertyName, float value);

member this.WriteNumber : ReadOnlySpan<byte> * single -> unit

Public Sub WriteNumber (utf8PropertyName As ReadOnlySpan(Of Byte), value As Single)

Parameters

utf8PropertyName

ReadOnlySpan<Byte>

The UTF-8 encoded property name of the JSON object to be written.

value

Single

The value to be written as a JSON number as part of the name/value pair.

Exceptions

ArgumentException

The specified property name is too large.

InvalidOperationException

Validation is enabled, and the write operation would produce invalid JSON.

Remarks

Writes the Single using the default StandardFormat (that is, 'G') on .NET Core 3.0 or later versions. Uses 'G9' on any other framework.

The property name is escaped before writing.

WriteNumber(ReadOnlySpan<Byte>, UInt32)

Source:

Utf8JsonWriter.WriteProperties.UnsignedNumber.cs

Important

This API is not CLS-compliant.

Writes a property name specified as a read-only span of bytes and a UInt32 value (as a JSON number) as part of a name/value pair of a JSON object.

public:
 void WriteNumber(ReadOnlySpan<System::Byte> utf8PropertyName, System::UInt32 value);

[System.CLSCompliant(false)]
public void WriteNumber (ReadOnlySpan<byte> utf8PropertyName, uint value);

[<System.CLSCompliant(false)>]
member this.WriteNumber : ReadOnlySpan<byte> * uint32 -> unit

Public Sub WriteNumber (utf8PropertyName As ReadOnlySpan(Of Byte), value As UInteger)

Parameters

utf8PropertyName

ReadOnlySpan<Byte>

The UTF-8 encoded property name of the JSON object to be written.

value

UInt32

The value to be written as a JSON number as part of the name/value pair.

Attributes

CLSCompliantAttribute

Exceptions

ArgumentException

The specified property name is too large.

InvalidOperationException

Validation is enabled, and the write operation would produce invalid JSON.

Remarks

Writes the UInt32 using the default StandardFormat (that is, 'G'); for example, 32767.

The property name is escaped before writing.

WriteNumber(ReadOnlySpan<Char>, UInt64)

Source:

Utf8JsonWriter.WriteProperties.UnsignedNumber.cs

Important

This API is not CLS-compliant.

Writes a property name specified as a read-only character span and a UInt64 value (as a JSON number) as part of a name/value pair of a JSON object.

public:
 void WriteNumber(ReadOnlySpan<char> propertyName, System::UInt64 value);

[System.CLSCompliant(false)]
public void WriteNumber (ReadOnlySpan<char> propertyName, ulong value);

[<System.CLSCompliant(false)>]
member this.WriteNumber : ReadOnlySpan<char> * uint64 -> unit

Public Sub WriteNumber (propertyName As ReadOnlySpan(Of Char), value As ULong)

Parameters

propertyName

ReadOnlySpan<Char>

The UTF-16 encoded property name of the JSON object to be transcoded and written as UTF-8.

value

UInt64

The value to be written as a JSON number as part of the name/value pair.

Attributes

CLSCompliantAttribute

Exceptions

ArgumentException

The specified property name is too large.

InvalidOperationException

Validation is enabled, and the write operation would produce invalid JSON.

Remarks

Writes the UInt64 using the default StandardFormat (that is, 'G'); for example, 32767.

The property name is escaped before writing.

WriteNumber(ReadOnlySpan<Char>, Decimal)

Source:

Utf8JsonWriter.WriteProperties.Decimal.cs

Writes a property name specified as a read-only character span and a Decimal value (as a JSON number) as part of a name/value pair of a JSON object.

public:
 void WriteNumber(ReadOnlySpan<char> propertyName, System::Decimal value);

public void WriteNumber (ReadOnlySpan<char> propertyName, decimal value);

member this.WriteNumber : ReadOnlySpan<char> * decimal -> unit

Public Sub WriteNumber (propertyName As ReadOnlySpan(Of Char), value As Decimal)

Parameters

propertyName

ReadOnlySpan<Char>

The UTF-16 encoded property name of the JSON object to be transcoded and written as UTF-8.

value

Decimal

The value to be written as a JSON number as part of the name/value pair.

Exceptions

ArgumentException

The specified property name is too large.

InvalidOperationException

Validation is enabled, and the write operation would produce invalid JSON.

Remarks

Writes the Decimal using the default StandardFormat (that is, 'G').

The property name is escaped before writing.

WriteNumber(ReadOnlySpan<Char>, Double)

Source:

Utf8JsonWriter.WriteProperties.Double.cs

Writes a property name specified as a read-only character span and a Double value (as a JSON number) as part of a name/value pair of a JSON object.

public:
 void WriteNumber(ReadOnlySpan<char> propertyName, double value);

public void WriteNumber (ReadOnlySpan<char> propertyName, double value);

member this.WriteNumber : ReadOnlySpan<char> * double -> unit

Public Sub WriteNumber (propertyName As ReadOnlySpan(Of Char), value As Double)

Parameters

propertyName

ReadOnlySpan<Char>

The UTF-16 encoded property name of the JSON object to be transcoded and written as UTF-8.

value

Double

The value to be written as a JSON number as part of the name/value pair.

Exceptions

ArgumentException

The specified property name is too large.

InvalidOperationException

Validation is enabled, and the write operation would produce invalid JSON.

Remarks

Writes the Double using the default StandardFormat (that is, 'G') on .NET Core 3.0 or later versions. Uses 'G17' on any other framework.

The property name is escaped before writing.

WriteNumber(ReadOnlySpan<Char>, Int32)

Source:

Utf8JsonWriter.WriteProperties.SignedNumber.cs

Writes a property name specified as a read-only character span and an Int32 value (as a JSON number) as part of a name/value pair of a JSON object.

public:
 void WriteNumber(ReadOnlySpan<char> propertyName, int value);

public void WriteNumber (ReadOnlySpan<char> propertyName, int value);

member this.WriteNumber : ReadOnlySpan<char> * int -> unit

Public Sub WriteNumber (propertyName As ReadOnlySpan(Of Char), value As Integer)

Parameters

propertyName

ReadOnlySpan<Char>

The UTF-16 encoded property name of the JSON object to be transcoded and written as UTF-8.

value

Int32

The value to be written as a JSON number as part of the name/value pair.

Exceptions

ArgumentException

The specified property name is too large.

InvalidOperationException

Validation is enabled, and the write operation would produce invalid JSON.

Remarks

Writes the Int32 using the default StandardFormat (that is, 'G'); for example, 32767.

The property name is escaped before writing.

WriteNumber(ReadOnlySpan<Char>, Int64)

Source:

Utf8JsonWriter.WriteProperties.SignedNumber.cs

Writes a property name specified as a read-only character span and an Int64 value (as a JSON number) as part of a name/value pair of a JSON object.

public:
 void WriteNumber(ReadOnlySpan<char> propertyName, long value);

public void WriteNumber (ReadOnlySpan<char> propertyName, long value);

member this.WriteNumber : ReadOnlySpan<char> * int64 -> unit

Public Sub WriteNumber (propertyName As ReadOnlySpan(Of Char), value As Long)

Parameters

propertyName

ReadOnlySpan<Char>

The UTF-16 encoded property name of the JSON object to be transcoded and written as UTF-8.

value

Int64

The value to be written as a JSON number as part of the name/value pair.

Exceptions

ArgumentException

The specified property name is too large.

InvalidOperationException

Validation is enabled, and the write operation would produce invalid JSON.

Remarks

Writes the Int64 using the default StandardFormat (that is, 'G'); for example, 32767.

The property name is escaped before writing.

WriteNumber(ReadOnlySpan<Char>, Single)

Source:

Utf8JsonWriter.WriteProperties.Float.cs

Writes a property name specified as a read-only character span and a Single value (as a JSON number) as part of a name/value pair of a JSON object.

public:
 void WriteNumber(ReadOnlySpan<char> propertyName, float value);

public void WriteNumber (ReadOnlySpan<char> propertyName, float value);

member this.WriteNumber : ReadOnlySpan<char> * single -> unit

Public Sub WriteNumber (propertyName As ReadOnlySpan(Of Char), value As Single)

Parameters

propertyName

ReadOnlySpan<Char>

The UTF-16 encoded property name of the JSON object to be transcoded and written as UTF-8.

value

Single

The value to be written as a JSON number as part of the name/value pair.

Exceptions

ArgumentException

The specified property name is too large.

InvalidOperationException

Validation is enabled, and the write operation would produce invalid JSON.

Remarks

Writes the Single using the default StandardFormat (that is, 'G') on .NET Core 3.0 or later versions. Uses 'G9' on any other framework.

The property name is escaped before writing.

WriteNumber(ReadOnlySpan<Byte>, UInt64)

Source:

Utf8JsonWriter.WriteProperties.UnsignedNumber.cs

Important

This API is not CLS-compliant.

Writes a property name specified as a read-only span of bytes and a UInt64 value (as a JSON number) as part of a name/value pair of a JSON object.

public:
 void WriteNumber(ReadOnlySpan<System::Byte> utf8PropertyName, System::UInt64 value);

[System.CLSCompliant(false)]
public void WriteNumber (ReadOnlySpan<byte> utf8PropertyName, ulong value);

[<System.CLSCompliant(false)>]
member this.WriteNumber : ReadOnlySpan<byte> * uint64 -> unit

Public Sub WriteNumber (utf8PropertyName As ReadOnlySpan(Of Byte), value As ULong)

Parameters

utf8PropertyName

ReadOnlySpan<Byte>

The UTF-8 encoded property name of the JSON object to be written.

value

UInt64

The value to be written as a JSON number as part of the name/value pair.

Attributes

CLSCompliantAttribute

Exceptions

ArgumentException

The specified property name is too large.

InvalidOperationException

Validation is enabled, and the write operation would produce invalid JSON.

Remarks

Writes the UInt64 using the default StandardFormat (that is, 'G'); for example, 32767.

The property name is escaped before writing.