Utf8JsonWriter.WriteStringValue Yöntem

Tanım

Ad Alanı:

System.Text.Json

Bütünleştirilmiş Kod:

System.Text.Json.dll

Paket:

System.Text.Json v9.0.0-preview.3.24172.9

Aşırı Yüklemeler

WriteStringValue(String)	JSON dizisinin öğesi olarak bir dize metin değeri (JSON dizesi olarak) yazar.
WriteStringValue(DateTime)	JSON dizisinin öğesi olarak bir DateTime değer (JSON dizesi olarak) yazar.
WriteStringValue(DateTimeOffset)	JSON dizisinin öğesi olarak bir DateTimeOffset değer (JSON dizesi olarak) yazar.
WriteStringValue(Guid)	JSON dizisinin öğesi olarak bir Guid değer (JSON dizesi olarak) yazar.
WriteStringValue(ReadOnlySpan<Byte>)	JSON dizisinin öğesi olarak UTF-8 metin değerini (JSON dizesi olarak) yazar.
WriteStringValue(ReadOnlySpan<Char>)	JSON dizisinin öğesi olarak UTF-16 metin değerini (JSON dizesi olarak) yazar.
WriteStringValue(JsonEncodedText)	Önceden kodlanmış metin değerini (JSON dizesi olarak) bir JSON dizisinin öğesi olarak yazar.

WriteStringValue(String)

Kaynak:

Utf8JsonWriter.WriteValues.String.cs

JSON dizisinin öğesi olarak bir dize metin değeri (JSON dizesi olarak) yazar.

public:
 void WriteStringValue(System::String ^ value);

public void WriteStringValue (string? value);

member this.WriteStringValue : string -> unit

Public Sub WriteStringValue (value As String)

Parametreler

value

String

UTF-16 kodlanmış değeri, bir JSON dizisinin UTF-8 kodlanmış JSON dize öğesi olarak yazılacaktır.

Özel durumlar

ArgumentException

Belirtilen değer çok büyük.

InvalidOperationException

Doğrulama etkinleştirilir ve yazma işlemi geçersiz JSON üretir.

Açıklamalar

Yazmadan önce değerden kaçınılır.

ise valuenull, JSON null değeri, yöntemi çağrılır gibi WriteNullValue() yazılır.

WriteStringValue(DateTime)

Kaynak:

Utf8JsonWriter.WriteValues.DateTime.cs

JSON dizisinin öğesi olarak bir DateTime değer (JSON dizesi olarak) yazar.

public:
 void WriteStringValue(DateTime value);

public void WriteStringValue (DateTime value);

member this.WriteStringValue : DateTime -> unit

Public Sub WriteStringValue (value As DateTime)

Parametreler

value

DateTime

JSON dizisinin bir öğesi olarak JSON dizesi olarak yazılacak değer.

Özel durumlar

InvalidOperationException

Doğrulama etkinleştirilir ve işlem geçersiz JSON yazmayla sonuçlanır.

Açıklamalar

Bu yöntem, ISO 8601-1 genişletilmiş biçimini kullanarak yazar DateTime (bkz . System.Text.Json'da DateTime ve DateTimeOffset desteği); örneğin, 2017-06-12T05:30:45.7680000.

WriteStringValue(DateTimeOffset)

Kaynak:

Utf8JsonWriter.WriteValues.DateTimeOffset.cs

JSON dizisinin öğesi olarak bir DateTimeOffset değer (JSON dizesi olarak) yazar.

public:
 void WriteStringValue(DateTimeOffset value);

public void WriteStringValue (DateTimeOffset value);

member this.WriteStringValue : DateTimeOffset -> unit

Public Sub WriteStringValue (value As DateTimeOffset)

Parametreler

value

DateTimeOffset

JSON dizisinin bir öğesi olarak JSON dizesi olarak yazılacak değer.

Özel durumlar

InvalidOperationException

Doğrulama etkinleştirilir ve işlem geçersiz JSON yazmayla sonuçlanır.

Açıklamalar

Bu yöntem, ISO 8601-1 genişletilmiş biçimini kullanarak yazar DateTimeOffset (bkz . System.Text.Json'da DateTime ve DateTimeOffset desteği); örneğin, 2017-06-12T05:30:45.7680000-07:00.

WriteStringValue(Guid)

Kaynak:

Utf8JsonWriter.WriteValues.Guid.cs

JSON dizisinin öğesi olarak bir Guid değer (JSON dizesi olarak) yazar.

public:
 void WriteStringValue(Guid value);

public void WriteStringValue (Guid value);

member this.WriteStringValue : Guid -> unit

Public Sub WriteStringValue (value As Guid)

Parametreler

value

Guid

JSON dizisinin bir öğesi olarak JSON dizesi olarak yazılacak değer.

Özel durumlar

InvalidOperationException

Doğrulama etkinleştirilir ve işlem geçersiz JSON yazmayla sonuçlanır.

Açıklamalar

Bu yöntem, varsayılan StandardFormat değeri ('D') kullanarak değeri şu biçimde yazarGuid: nnnnnnnnn-nn-nn-nn-nnnn.

WriteStringValue(ReadOnlySpan<Byte>)

Kaynak:

Utf8JsonWriter.WriteValues.String.cs

JSON dizisinin öğesi olarak UTF-8 metin değerini (JSON dizesi olarak) yazar.

public:
 void WriteStringValue(ReadOnlySpan<System::Byte> utf8Value);

public void WriteStringValue (ReadOnlySpan<byte> utf8Value);

member this.WriteStringValue : ReadOnlySpan<byte> -> unit

Public Sub WriteStringValue (utf8Value As ReadOnlySpan(Of Byte))

Parametreler

utf8Value

ReadOnlySpan<Byte>

BIR JSON dizisinin JSON dize öğesi olarak yazılacak UTF-8 kodlanmış değeri.

Özel durumlar

ArgumentException

Belirtilen değer çok büyük.

InvalidOperationException

Doğrulama etkinleştirilir ve yazma işlemi geçersiz JSON üretir.

Açıklamalar

Yazmadan önce değerden kaçınılır.

WriteStringValue(ReadOnlySpan<Char>)

Kaynak:

Utf8JsonWriter.WriteValues.String.cs

JSON dizisinin öğesi olarak UTF-16 metin değerini (JSON dizesi olarak) yazar.

public:
 void WriteStringValue(ReadOnlySpan<char> value);

public void WriteStringValue (ReadOnlySpan<char> value);

member this.WriteStringValue : ReadOnlySpan<char> -> unit

Public Sub WriteStringValue (value As ReadOnlySpan(Of Char))

Parametreler

value

ReadOnlySpan<Char>

UTF-16 kodlanmış değeri, bir JSON dizisinin UTF-8 kodlanmış JSON dize öğesi olarak yazılacaktır.

Özel durumlar

ArgumentException

Belirtilen değer çok büyük.

InvalidOperationException

Doğrulama etkinleştirilir ve yazma işlemi geçersiz JSON üretir.

Açıklamalar

Yazmadan önce değerden kaçınılır.

WriteStringValue(JsonEncodedText)

Kaynak:

Utf8JsonWriter.WriteValues.String.cs

Önceden kodlanmış metin değerini (JSON dizesi olarak) bir JSON dizisinin öğesi olarak yazar.

public:
 void WriteStringValue(System::Text::Json::JsonEncodedText value);

public void WriteStringValue (System.Text.Json.JsonEncodedText value);

member this.WriteStringValue : System.Text.Json.JsonEncodedText -> unit

Public Sub WriteStringValue (value As JsonEncodedText)

Parametreler

value

JsonEncodedText

JSON kodlanmış değeri, bir JSON dizisinin UTF-8 kodlanmış JSON dize öğesi olarak yazılacaktır.

Özel durumlar

InvalidOperationException

Doğrulama etkinleştirilir ve yazma işlemi geçersiz JSON üretir.

Açıklamalar

örneği JsonEncodedText oluşturulduğunda değerin zaten kaçış karakterine sahip olması gerekir.