Utf8JsonWriter.WriteNumberValue 方法

定義

命名空間:

System.Text.Json

組件:

System.Text.Json.dll

多載

名稱	Description
WriteNumberValue(Single)	它會寫入一個 Single 值（以 JSON 編號形式）。
WriteNumberValue(UInt64)	它會寫入一個 UInt64 值（以 JSON 編號形式）。
WriteNumberValue(UInt32)	它會寫入一個 UInt32 值（以 JSON 編號形式）。
WriteNumberValue(Int64)	它會寫入一個 Int64 值（以 JSON 編號形式）。
WriteNumberValue(Double)	它會寫入一個 Double 值（以 JSON 編號形式）。
WriteNumberValue(Decimal)	它會寫入一個 Decimal 值（以 JSON 編號形式）。
WriteNumberValue(Int32)	它會寫入一個 Int32 值（以 JSON 編號形式）。

WriteNumberValue(Single)

來源:

Utf8JsonWriter.WriteValues.Float.cs

它會寫入一個 Single 值（以 JSON 編號形式）。

public:
 void WriteNumberValue(float value);

public void WriteNumberValue(float value);

member this.WriteNumberValue : single -> unit

Public Sub WriteNumberValue (value As Single)

參數

value

Single

這個數值會寫成 JSON 數字。

例外狀況

InvalidOperationException

啟用驗證，操作會導致寫入無效的 JSON。

備註

此方法以以下格式寫入 Single 該值：

• 在 .NET Core 3.0 及以後版本中，預設（ StandardFormat 也就是 'G'）。
• 在其他所有框架上，都是「G9」。

WriteNumberValue(UInt64)

來源:

Utf8JsonWriter.WriteValues.UnsignedNumber.cs

重要

此 API 不符合 CLS 規範。

它會寫入一個 UInt64 值（以 JSON 編號形式）。

public:
 void WriteNumberValue(System::UInt64 value);

[System.CLSCompliant(false)]
public void WriteNumberValue(ulong value);

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

Public Sub WriteNumberValue (value As ULong)

參數

value

UInt64

這個數值會寫成 JSON 數字。

屬性

CLSCompliantAttribute

例外狀況

InvalidOperationException

啟用驗證，操作會導致寫入無效的 JSON。

備註

此方法使用預設StandardFormat值（即「G」）來寫入UInt64該值。 例如，32767。

WriteNumberValue(UInt32)

來源:

Utf8JsonWriter.WriteValues.UnsignedNumber.cs

重要

此 API 不符合 CLS 規範。

它會寫入一個 UInt32 值（以 JSON 編號形式）。

public:
 void WriteNumberValue(System::UInt32 value);

[System.CLSCompliant(false)]
public void WriteNumberValue(uint value);

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

Public Sub WriteNumberValue (value As UInteger)

參數

value

UInt32

這個數值會寫成 JSON 數字。

屬性

CLSCompliantAttribute

例外狀況

InvalidOperationException

啟用驗證，操作會導致寫入無效的 JSON。

備註

此方法使用預設StandardFormat值（即「G」）來寫入UInt32該值。 例如，32767。

WriteNumberValue(Int64)

來源:

Utf8JsonWriter.WriteValues.SignedNumber.cs

它會寫入一個 Int64 值（以 JSON 編號形式）。

public:
 void WriteNumberValue(long value);

public void WriteNumberValue(long value);

member this.WriteNumberValue : int64 -> unit

Public Sub WriteNumberValue (value As Long)

參數

value

Int64

這個數值會寫成 JSON 數字。

例外狀況

InvalidOperationException

啟用驗證，操作會導致寫入無效的 JSON。

備註

此方法使用預設StandardFormat值（即「G」）來寫入Int64該值。 例如，32767。

WriteNumberValue(Double)

來源:

Utf8JsonWriter.WriteValues.Double.cs

它會寫入一個 Double 值（以 JSON 編號形式）。

public:
 void WriteNumberValue(double value);

public void WriteNumberValue(double value);

member this.WriteNumberValue : double -> unit

Public Sub WriteNumberValue (value As Double)

參數

value

Double

這個數值會寫成 JSON 數字。

例外狀況

InvalidOperationException

啟用驗證，操作會導致寫入無效的 JSON。

備註

此方法以以下格式寫入 Double 該值：

• 在 .NET Core 3.0 及以後版本中，預設（ StandardFormat 也就是 'G'）。
• 在其他所有框架上，標示為「G17」。

WriteNumberValue(Decimal)

來源:

Utf8JsonWriter.WriteValues.Decimal.cs

它會寫入一個 Decimal 值（以 JSON 編號形式）。

public:
 void WriteNumberValue(System::Decimal value);

public void WriteNumberValue(decimal value);

member this.WriteNumberValue : decimal -> unit

Public Sub WriteNumberValue (value As Decimal)

參數

value

Decimal

這個數值會寫成 JSON 數字。

例外狀況

InvalidOperationException

啟用驗證，操作會導致寫入無效的 JSON。

備註

此方法使用預設StandardFormat值（即「G」）來寫入Decimal該值。

WriteNumberValue(Int32)

來源:

Utf8JsonWriter.WriteValues.SignedNumber.cs

它會寫入一個 Int32 值（以 JSON 編號形式）。

public:
 void WriteNumberValue(int value);

public void WriteNumberValue(int value);

member this.WriteNumberValue : int -> unit

Public Sub WriteNumberValue (value As Integer)

參數

value

Int32

這個數值會寫成 JSON 數字。

例外狀況

InvalidOperationException

啟用驗證，操作會導致寫入無效的 JSON。

備註

此方法使用預設StandardFormat值（即「G」）來寫入Int32該值。 例如，32767。