Utf8JsonWriter.WriteNumber Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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)
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 -> unitPublic 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
The specified property name is too large.
Validation is enabled, and the write operation would produce invalid JSON.
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.
Applies to
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.
public:
void WriteNumber(System::String ^ propertyName, long value);public void WriteNumber (string propertyName, long value);member this.WriteNumber : string * int64 -> unitPublic 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
The specified property name is too large.
Validation is enabled, and the write operation would produce invalid JSON.
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.
Applies to
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.
public:
void WriteNumber(System::String ^ propertyName, float value);public void WriteNumber (string propertyName, float value);member this.WriteNumber : string * single -> unitPublic 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
The specified property name is too large.
Validation is enabled, and the write operation would produce invalid JSON.
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.
Applies to
WriteNumber(String, UInt32)
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 -> unitPublic 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
Exceptions
The specified property name is too large.
Validation is enabled, and the write operation would produce invalid JSON.
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.
Applies to
WriteNumber(String, UInt64)
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 -> unitPublic 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
Exceptions
The specified property name is too large.
Validation is enabled, and the write operation would produce invalid JSON.
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.
Applies to
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.
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 -> unitPublic 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
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.
Applies to
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.
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 -> unitPublic 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
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.
Applies to
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.
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 -> unitPublic 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
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.
Applies to
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.
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 -> unitPublic 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
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.
Applies to
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.
public:
void WriteNumber(System::String ^ propertyName, double value);public void WriteNumber (string propertyName, double value);member this.WriteNumber : string * double -> unitPublic 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
The specified property name is too large.
Validation is enabled, and the write operation would produce invalid JSON.
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.
Applies to
WriteNumber(JsonEncodedText, UInt32)
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 -> unitPublic 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
Exceptions
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.
Applies to
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.
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 -> unitPublic 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
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.
Applies to
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.
public:
void WriteNumber(System::String ^ propertyName, System::Decimal value);public void WriteNumber (string propertyName, decimal value);member this.WriteNumber : string * decimal -> unitPublic 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
The specified property name is too large.
Validation is enabled, and the write operation would produce invalid JSON.
The propertyName parameter is null.
Remarks
Writes the Decimal using the default StandardFormat (that is, 'G').
The property name is escaped before writing.
Applies to
WriteNumber(JsonEncodedText, UInt64)
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 -> unitPublic 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
Exceptions
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.
Applies to
WriteNumber(ReadOnlySpan<Char>, UInt32)
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 -> unitPublic 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
Exceptions
The specified property name is too large.
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.
Applies to
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.
public:
void WriteNumber(ReadOnlySpan<System::Byte> utf8PropertyName, System::Decimal value);public void WriteNumber (ReadOnlySpan<byte> utf8PropertyName, decimal value);member this.WriteNumber : ReadOnlySpan<byte> * decimal -> unitPublic 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
The specified property name is too large.
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.
Applies to
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.
public:
void WriteNumber(ReadOnlySpan<System::Byte> utf8PropertyName, double value);public void WriteNumber (ReadOnlySpan<byte> utf8PropertyName, double value);member this.WriteNumber : ReadOnlySpan<byte> * double -> unitPublic 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
The specified property name is too large.
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.
Applies to
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.
public:
void WriteNumber(ReadOnlySpan<System::Byte> utf8PropertyName, int value);public void WriteNumber (ReadOnlySpan<byte> utf8PropertyName, int value);member this.WriteNumber : ReadOnlySpan<byte> * int -> unitPublic 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
The specified property name is too large.
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.
Applies to
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.
public:
void WriteNumber(ReadOnlySpan<System::Byte> utf8PropertyName, long value);public void WriteNumber (ReadOnlySpan<byte> utf8PropertyName, long value);member this.WriteNumber : ReadOnlySpan<byte> * int64 -> unitPublic 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
The specified property name is too large.
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.
Applies to
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.
public:
void WriteNumber(ReadOnlySpan<System::Byte> utf8PropertyName, float value);public void WriteNumber (ReadOnlySpan<byte> utf8PropertyName, float value);member this.WriteNumber : ReadOnlySpan<byte> * single -> unitPublic 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
The specified property name is too large.
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.
Applies to
WriteNumber(ReadOnlySpan<Byte>, UInt32)
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 -> unitPublic 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
Exceptions
The specified property name is too large.
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.
Applies to
WriteNumber(ReadOnlySpan<Char>, UInt64)
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 -> unitPublic 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
Exceptions
The specified property name is too large.
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.
Applies to
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.
public:
void WriteNumber(ReadOnlySpan<char> propertyName, System::Decimal value);public void WriteNumber (ReadOnlySpan<char> propertyName, decimal value);member this.WriteNumber : ReadOnlySpan<char> * decimal -> unitPublic 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
The specified property name is too large.
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.
Applies to
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.
public:
void WriteNumber(ReadOnlySpan<char> propertyName, double value);public void WriteNumber (ReadOnlySpan<char> propertyName, double value);member this.WriteNumber : ReadOnlySpan<char> * double -> unitPublic 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
The specified property name is too large.
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.
Applies to
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.
public:
void WriteNumber(ReadOnlySpan<char> propertyName, int value);public void WriteNumber (ReadOnlySpan<char> propertyName, int value);member this.WriteNumber : ReadOnlySpan<char> * int -> unitPublic 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
The specified property name is too large.
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.
Applies to
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.
public:
void WriteNumber(ReadOnlySpan<char> propertyName, long value);public void WriteNumber (ReadOnlySpan<char> propertyName, long value);member this.WriteNumber : ReadOnlySpan<char> * int64 -> unitPublic 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
The specified property name is too large.
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.
Applies to
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.
public:
void WriteNumber(ReadOnlySpan<char> propertyName, float value);public void WriteNumber (ReadOnlySpan<char> propertyName, float value);member this.WriteNumber : ReadOnlySpan<char> * single -> unitPublic 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
The specified property name is too large.
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.
Applies to
WriteNumber(ReadOnlySpan<Byte>, UInt64)
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 -> unitPublic 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
Exceptions
The specified property name is too large.
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.
