Utf8JsonWriter.WriteStringValue Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Overload
| Nama | Deskripsi |
|---|---|
| WriteStringValue(DateTime) |
DateTime Menulis nilai (sebagai string JSON). |
| WriteStringValue(DateTimeOffset) |
DateTimeOffset Menulis nilai (sebagai string JSON). |
| WriteStringValue(Guid) |
Guid Menulis nilai (sebagai string JSON). |
| WriteStringValue(ReadOnlySpan<Byte>) |
Menulis nilai teks UTF-8 (sebagai string JSON). |
| WriteStringValue(ReadOnlySpan<Char>) |
Menulis nilai teks UTF-16 (sebagai string JSON). |
| WriteStringValue(String) |
Menulis nilai teks string (sebagai string JSON). |
| WriteStringValue(JsonEncodedText) |
Menulis nilai teks yang telah dikodekan sebelumnya (sebagai string JSON). |
WriteStringValue(DateTime)
DateTime Menulis nilai (sebagai string JSON).
public:
void WriteStringValue(DateTime value);
public void WriteStringValue(DateTime value);
member this.WriteStringValue : DateTime -> unit
Public Sub WriteStringValue (value As DateTime)
Parameter
- value
- DateTime
Nilai yang akan ditulis sebagai string JSON.
Pengecualian
Validasi diaktifkan, dan operasi akan menghasilkan JSON yang tidak valid secara tertulis.
Keterangan
Metode ini menulis DateTime menggunakan format yang diperluas ISO 8601-1 (lihat dukungan DateTime dan DateTimeOffset di System.Text.Json); misalnya, 2017-06-12T05:30:45.7680000.
Berlaku untuk
WriteStringValue(DateTimeOffset)
DateTimeOffset Menulis nilai (sebagai string JSON).
public:
void WriteStringValue(DateTimeOffset value);
public void WriteStringValue(DateTimeOffset value);
member this.WriteStringValue : DateTimeOffset -> unit
Public Sub WriteStringValue (value As DateTimeOffset)
Parameter
- value
- DateTimeOffset
Nilai yang akan ditulis sebagai string JSON.
Pengecualian
Validasi diaktifkan, dan operasi akan menghasilkan JSON yang tidak valid secara tertulis.
Keterangan
Metode ini menulis DateTimeOffset menggunakan format yang diperluas ISO 8601-1 (lihat dukungan DateTime dan DateTimeOffset di System.Text.Json); misalnya, 2017-06-12T05:30:45.7680000-07:00.
Berlaku untuk
WriteStringValue(Guid)
Guid Menulis nilai (sebagai string JSON).
public:
void WriteStringValue(Guid value);
public void WriteStringValue(Guid value);
member this.WriteStringValue : Guid -> unit
Public Sub WriteStringValue (value As Guid)
Parameter
- value
- Guid
Nilai yang akan ditulis sebagai string JSON.
Pengecualian
Validasi diaktifkan, dan operasi akan menghasilkan JSON yang tidak valid secara tertulis.
Keterangan
Metode ini menulis Guid nilai menggunakan default StandardFormat (yaitu, 'D'), sebagai formulir: nnnnnnnn-nnnn-nnnn-nnnn-nnnn-nnnnnnnnnnnnnn.
Berlaku untuk
WriteStringValue(ReadOnlySpan<Byte>)
Menulis nilai teks UTF-8 (sebagai string JSON).
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))
Parameter
- utf8Value
- ReadOnlySpan<Byte>
Nilai yang dikodekan UTF-8 untuk ditulis sebagai string JSON.
Pengecualian
Nilai yang ditentukan terlalu besar.
Validasi diaktifkan, dan operasi tulis akan menghasilkan JSON yang tidak valid.
Keterangan
Nilai lolos sebelum menulis.
Berlaku untuk
WriteStringValue(ReadOnlySpan<Char>)
Menulis nilai teks UTF-16 (sebagai string JSON).
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))
Parameter
- value
- ReadOnlySpan<Char>
Nilai yang dikodekan UTF-16 untuk ditulis sebagai string JSON yang ditranskodekan UTF-8.
Pengecualian
Nilai yang ditentukan terlalu besar.
Validasi diaktifkan, dan operasi tulis akan menghasilkan JSON yang tidak valid.
Keterangan
Nilai lolos sebelum menulis.
Berlaku untuk
WriteStringValue(String)
Menulis nilai teks string (sebagai string JSON).
public:
void WriteStringValue(System::String ^ value);
public void WriteStringValue(string? value);
public void WriteStringValue(string value);
member this.WriteStringValue : string -> unit
Public Sub WriteStringValue (value As String)
Parameter
- value
- String
Nilai yang dikodekan UTF-16 untuk ditulis sebagai string JSON yang ditranskodekan UTF-8.
Pengecualian
Nilai yang ditentukan terlalu besar.
Validasi diaktifkan, dan operasi tulis akan menghasilkan JSON yang tidak valid.
Keterangan
Nilai lolos sebelum menulis.
Jika value adalah , nilai null JSON ditulis, seolah-olah WriteNullValue()nullmetode dipanggil.
Berlaku untuk
WriteStringValue(JsonEncodedText)
Menulis nilai teks yang telah dikodekan sebelumnya (sebagai string JSON).
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)
Parameter
- value
- JsonEncodedText
Nilai yang dikodekan JSON untuk ditulis sebagai string JSON yang ditranskodekan UTF-8.
Pengecualian
Validasi diaktifkan, dan operasi tulis akan menghasilkan JSON yang tidak valid.
Keterangan
Nilai harus sudah diloloskan ketika instans JsonEncodedText dibuat.