Utf8JsonWriter.WriteStringValue Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Przeciążenia
| WriteStringValue(String) |
Zapisuje wartość tekstową ciągu (jako ciąg JSON) jako element tablicy JSON. |
| WriteStringValue(DateTime) |
DateTime Zapisuje wartość (jako ciąg JSON) jako element tablicy JSON. |
| WriteStringValue(DateTimeOffset) |
DateTimeOffset Zapisuje wartość (jako ciąg JSON) jako element tablicy JSON. |
| WriteStringValue(Guid) |
Guid Zapisuje wartość (jako ciąg JSON) jako element tablicy JSON. |
| WriteStringValue(ReadOnlySpan<Byte>) |
Zapisuje wartość tekstową UTF-8 (jako ciąg JSON) jako element tablicy JSON. |
| WriteStringValue(ReadOnlySpan<Char>) |
Zapisuje wartość tekstową UTF-16 (jako ciąg JSON) jako element tablicy JSON. |
| WriteStringValue(JsonEncodedText) |
Zapisuje wstępnie zakodowaną wartość tekstową (jako ciąg JSON) jako element tablicy JSON. |
WriteStringValue(String)
Zapisuje wartość tekstową ciągu (jako ciąg JSON) jako element tablicy JSON.
public:
void WriteStringValue(System::String ^ value);public void WriteStringValue (string? value);public void WriteStringValue (string value);member this.WriteStringValue : string -> unitPublic Sub WriteStringValue (value As String)Parametry
- value
- String
Zakodowana w formacie UTF-16 wartość, która ma być zapisywana jako transkodowany element ciągu JSON utF-8 tablicy JSON.
Wyjątki
Określona wartość jest za duża.
Walidacja jest włączona, a operacja zapisu spowoduje wygenerowanie nieprawidłowego kodu JSON.
Uwagi
Wartość zostanie uniknięta przed zapisem.
Jeśli value jest to null, wartość null JSON jest zapisywana, tak jakby WriteNullValue() metoda została wywołana.
Dotyczy
WriteStringValue(DateTime)
DateTime Zapisuje wartość (jako ciąg JSON) jako element tablicy JSON.
public:
void WriteStringValue(DateTime value);public void WriteStringValue (DateTime value);member this.WriteStringValue : DateTime -> unitPublic Sub WriteStringValue (value As DateTime)Parametry
- value
- DateTime
Wartość, która ma być zapisywana jako ciąg JSON jako element tablicy JSON.
Wyjątki
Walidacja jest włączona, a operacja spowoduje zapisanie nieprawidłowego kodu JSON.
Uwagi
Ta metoda zapisuje DateTime format rozszerzony ISO 8601-1 (zobacz obsługę dateTime i DateTimeOffset w pliku System.Text.Json); na przykład 2017-06-12T05:30:45.7680000.
Dotyczy
WriteStringValue(DateTimeOffset)
DateTimeOffset Zapisuje wartość (jako ciąg JSON) jako element tablicy JSON.
public:
void WriteStringValue(DateTimeOffset value);public void WriteStringValue (DateTimeOffset value);member this.WriteStringValue : DateTimeOffset -> unitPublic Sub WriteStringValue (value As DateTimeOffset)Parametry
- value
- DateTimeOffset
Wartość, która ma być zapisywana jako ciąg JSON jako element tablicy JSON.
Wyjątki
Walidacja jest włączona, a operacja spowoduje zapisanie nieprawidłowego kodu JSON.
Uwagi
Ta metoda zapisuje DateTimeOffset format rozszerzony ISO 8601-1 (zobacz obsługa typu DateTime i DateTimeOffset w pliku System.Text.Json); na przykład 2017-06-12T05:30:45.7680000-07:00.
Dotyczy
WriteStringValue(Guid)
Guid Zapisuje wartość (jako ciąg JSON) jako element tablicy JSON.
public:
void WriteStringValue(Guid value);public void WriteStringValue (Guid value);member this.WriteStringValue : Guid -> unitPublic Sub WriteStringValue (value As Guid)Parametry
- value
- Guid
Wartość, która ma być zapisywana jako ciąg JSON jako element tablicy JSON.
Wyjątki
Walidacja jest włączona, a operacja spowoduje zapisanie nieprawidłowego kodu JSON.
Uwagi
Ta metoda zapisuje Guid wartość przy użyciu wartości domyślnej StandardFormat (czyli "D") jako formularza: nnnnnn-nnnn-nnnn-nn.
Dotyczy
WriteStringValue(ReadOnlySpan<Byte>)
Zapisuje wartość tekstową UTF-8 (jako ciąg JSON) jako element tablicy JSON.
public:
void WriteStringValue(ReadOnlySpan<System::Byte> utf8Value);public void WriteStringValue (ReadOnlySpan<byte> utf8Value);member this.WriteStringValue : ReadOnlySpan<byte> -> unitPublic Sub WriteStringValue (utf8Value As ReadOnlySpan(Of Byte))Parametry
- utf8Value
- ReadOnlySpan<Byte>
Zakodowana w formacie UTF-8 wartość do zapisania jako element ciągu JSON tablicy JSON.
Wyjątki
Określona wartość jest za duża.
Walidacja jest włączona, a operacja zapisu spowoduje wygenerowanie nieprawidłowego kodu JSON.
Uwagi
Wartość zostanie uniknięta przed zapisem.
Dotyczy
WriteStringValue(ReadOnlySpan<Char>)
Zapisuje wartość tekstową UTF-16 (jako ciąg JSON) jako element tablicy JSON.
public:
void WriteStringValue(ReadOnlySpan<char> value);public void WriteStringValue (ReadOnlySpan<char> value);member this.WriteStringValue : ReadOnlySpan<char> -> unitPublic Sub WriteStringValue (value As ReadOnlySpan(Of Char))Parametry
- value
- ReadOnlySpan<Char>
Zakodowana w formacie UTF-16 wartość, która ma być zapisywana jako transkodowany element ciągu JSON utF-8 tablicy JSON.
Wyjątki
Określona wartość jest za duża.
Walidacja jest włączona, a operacja zapisu spowoduje wygenerowanie nieprawidłowego kodu JSON.
Uwagi
Wartość zostanie uniknięta przed zapisem.
Dotyczy
WriteStringValue(JsonEncodedText)
Zapisuje wstępnie zakodowaną wartość tekstową (jako ciąg JSON) jako element tablicy JSON.
public:
void WriteStringValue(System::Text::Json::JsonEncodedText value);public void WriteStringValue (System.Text.Json.JsonEncodedText value);member this.WriteStringValue : System.Text.Json.JsonEncodedText -> unitPublic Sub WriteStringValue (value As JsonEncodedText)Parametry
- value
- JsonEncodedText
Zakodowana w formacie JSON wartość do zapisania jako transkodowany element ciągu JSON w formacie UTF-8 tablicy JSON.
Wyjątki
Walidacja jest włączona, a operacja zapisu spowoduje wygenerowanie nieprawidłowego kodu JSON.
Uwagi
Wartość powinna zostać już uniknięta po utworzeniu JsonEncodedText wystąpienia.
