Utf8JsonWriter.WriteStringValue Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Overload
| WriteStringValue(String) |
Scrive un valore stringa di testo (come una stringa JSON) come elemento di una matrice JSON. |
| WriteStringValue(DateTime) |
Scrive un valore DateTime (come una stringa JSON) come elemento di una matrice JSON. |
| WriteStringValue(DateTimeOffset) |
Scrive un valore DateTimeOffset (come una stringa JSON) come elemento di una matrice JSON. |
| WriteStringValue(Guid) |
Scrive un valore Guid (come una stringa JSON) come elemento di una matrice JSON. |
| WriteStringValue(ReadOnlySpan<Byte>) |
Scrive un valore di testo UTF-8 (come stringa JSON) come elemento di una matrice JSON. |
| WriteStringValue(ReadOnlySpan<Char>) |
Scrive un valore di testo UTF-16 (come una stringa JSON) come elemento di una matrice JSON. |
| WriteStringValue(JsonEncodedText) |
Scrive il valore di testo precodificato (come stringa JSON) come elemento di una matrice JSON. |
WriteStringValue(String)
Scrive un valore stringa di testo (come una stringa JSON) come elemento di una matrice 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)Parametri
- value
- String
Valore con codifica UTF-16 da scrivere come elemento di stringa JSON transcodificato UTF-8 di una matrice JSON.
Eccezioni
Il valore specificato è troppo grande.
La convalida è abilitata e l'operazione di scrittura produrrebbe codice JSON non valido.
Commenti
Il valore viene eliminato prima della scrittura.
Se value è null, il valore NULL JSON viene scritto, come se il WriteNullValue() metodo fosse chiamato.
Si applica a
WriteStringValue(DateTime)
Scrive un valore DateTime (come una stringa JSON) come elemento di una matrice JSON.
public:
void WriteStringValue(DateTime value);public void WriteStringValue (DateTime value);member this.WriteStringValue : DateTime -> unitPublic Sub WriteStringValue (value As DateTime)Parametri
- value
- DateTime
Valore da scrivere come stringa JSON come elemento di una matrice JSON.
Eccezioni
La convalida è abilitata e l'operazione produrrebbe la scrittura di codice JSON non valido.
Commenti
Questo metodo scrive l'uso DateTime del formato esteso ISO 8601-1 (vedere Supporto dateTime e DateTimeOffset in System.Text.Json). Ad esempio, 2017-06-12T05:30:45.7680000.
Si applica a
WriteStringValue(DateTimeOffset)
Scrive un valore DateTimeOffset (come una stringa JSON) come elemento di una matrice JSON.
public:
void WriteStringValue(DateTimeOffset value);public void WriteStringValue (DateTimeOffset value);member this.WriteStringValue : DateTimeOffset -> unitPublic Sub WriteStringValue (value As DateTimeOffset)Parametri
- value
- DateTimeOffset
Valore da scrivere come stringa JSON come elemento di una matrice JSON.
Eccezioni
La convalida è abilitata e l'operazione produrrebbe la scrittura di codice JSON non valido.
Commenti
Questo metodo scrive l'uso DateTimeOffset del formato esteso ISO 8601-1 (vedere Supporto dateTime e DateTimeOffset in System.Text.Json). Ad esempio, 2017-06-12T05:30:45.7680000-07:00.
Si applica a
WriteStringValue(Guid)
Scrive un valore Guid (come una stringa JSON) come elemento di una matrice JSON.
public:
void WriteStringValue(Guid value);public void WriteStringValue (Guid value);member this.WriteStringValue : Guid -> unitPublic Sub WriteStringValue (value As Guid)Parametri
- value
- Guid
Valore da scrivere come stringa JSON come elemento di una matrice JSON.
Eccezioni
La convalida è abilitata e l'operazione produrrebbe la scrittura di codice JSON non valido.
Commenti
Questo metodo scrive il Guid valore usando il valore predefinito StandardFormat (ovvero 'D'), come modulo: nn-nn.
Si applica a
WriteStringValue(ReadOnlySpan<Byte>)
Scrive un valore di testo UTF-8 (come stringa JSON) come elemento di una matrice 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))Parametri
- utf8Value
- ReadOnlySpan<Byte>
Valore con codifica UTF-8 da scrivere come elemento di stringa JSON di una matrice JSON.
Eccezioni
Il valore specificato è troppo grande.
La convalida è abilitata e l'operazione di scrittura produrrebbe codice JSON non valido.
Commenti
Il valore viene eliminato prima della scrittura.
Si applica a
WriteStringValue(ReadOnlySpan<Char>)
Scrive un valore di testo UTF-16 (come una stringa JSON) come elemento di una matrice 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))Parametri
- value
- ReadOnlySpan<Char>
Valore con codifica UTF-16 da scrivere come elemento di stringa JSON transcodificato UTF-8 di una matrice JSON.
Eccezioni
Il valore specificato è troppo grande.
La convalida è abilitata e l'operazione di scrittura produrrebbe codice JSON non valido.
Commenti
Il valore viene eliminato prima della scrittura.
Si applica a
WriteStringValue(JsonEncodedText)
Scrive il valore di testo precodificato (come stringa JSON) come elemento di una matrice 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)Parametri
- value
- JsonEncodedText
Valore con codifica JSON da scrivere come elemento di stringa JSON transcodificato UTF-8 di una matrice JSON.
Eccezioni
La convalida è abilitata e l'operazione di scrittura produrrebbe codice JSON non valido.
Commenti
Il valore deve essere già escape quando è stata creata l'istanza di JsonEncodedText .
