Utf8JsonWriter.WriteString 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
WriteString(JsonEncodedText, JsonEncodedText) |
Zapisuje wstępnie zakodowaną nazwę właściwości i wartość wstępnie zakodowaną (jako ciąg JSON) jako część pary nazw/wartości obiektu JSON. |
WriteString(JsonEncodedText, String) |
Zapisuje wstępnie zakodowaną nazwę właściwości i wartość tekstową ciągu (jako ciąg JSON) jako część pary nazw/wartości obiektu JSON. |
WriteString(JsonEncodedText, ReadOnlySpan<Char>) |
Zapisuje wstępnie zakodowaną nazwę właściwości i wartość tekstową (jako ciąg JSON) w ramach pary nazw/wartości obiektu JSON. |
WriteString(JsonEncodedText, ReadOnlySpan<Byte>) |
Zapisuje wstępnie zakodowaną nazwę właściwości i wartość tekstową UTF-8 (jako ciąg JSON) jako część pary nazw/wartości obiektu JSON. |
WriteString(JsonEncodedText, Guid) |
Zapisuje wstępnie zakodowaną nazwę właściwości i Guid wartość (jako ciąg JSON) jako część pary nazw/wartości obiektu JSON. |
WriteString(JsonEncodedText, DateTimeOffset) |
Zapisuje wstępnie zakodowaną nazwę właściwości i DateTimeOffset wartość (jako ciąg JSON) jako część pary nazw/wartości obiektu JSON. |
WriteString(JsonEncodedText, DateTime) |
Zapisuje wstępnie zakodowaną nazwę właściwości i DateTime wartość (jako ciąg JSON) jako część pary nazw/wartości obiektu JSON. |
WriteString(String, JsonEncodedText) |
Zapisuje nazwę właściwości i wstępnie zakodowaną wartość (jako ciąg JSON) jako część pary nazw/wartości obiektu JSON. |
WriteString(String, String) |
Zapisuje nazwę właściwości określoną jako ciąg i wartość tekstową ciągu (jako ciąg JSON) jako część pary nazw/wartości obiektu JSON. |
WriteString(String, ReadOnlySpan<Char>) |
Zapisuje nazwę właściwości określoną jako ciąg i wartość tekstową UTF-16 (jako ciąg JSON) jako część pary nazw/wartości obiektu JSON. |
WriteString(String, ReadOnlySpan<Byte>) |
Zapisuje nazwę właściwości określoną jako ciąg i wartość tekstową UTF-8 (jako ciąg JSON) jako część pary nazw/wartości obiektu JSON. |
WriteString(String, DateTimeOffset) |
Zapisuje nazwę właściwości określoną jako ciąg i DateTimeOffset wartość (jako ciąg JSON) jako część pary nazw/wartości obiektu JSON. |
WriteString(String, DateTime) |
Zapisuje nazwę właściwości określoną jako ciąg i DateTime wartość (jako ciąg JSON) jako część pary nazw/wartości obiektu JSON. |
WriteString(String, Guid) |
Zapisuje nazwę właściwości określoną jako ciąg i Guid wartość (jako ciąg JSON) jako część pary nazw/wartości obiektu JSON. |
WriteString(ReadOnlySpan<Char>, String) |
Zapisuje nazwę właściwości UTF-16 i wartość tekstową ciągu (jako ciąg JSON) jako część pary nazw/wartości obiektu JSON. |
WriteString(ReadOnlySpan<Byte>, DateTime) |
Zapisuje nazwę właściwości UTF-8 i DateTime wartość (jako ciąg JSON) jako część pary nazw/wartości obiektu JSON. |
WriteString(ReadOnlySpan<Byte>, DateTimeOffset) |
Zapisuje nazwę właściwości UTF-8 i DateTimeOffset wartość (jako ciąg JSON) jako część pary nazw/wartości obiektu JSON. |
WriteString(ReadOnlySpan<Char>, JsonEncodedText) |
Zapisuje nazwę właściwości i wstępnie zakodowaną wartość (jako ciąg JSON) jako część pary nazw/wartości obiektu JSON. |
WriteString(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>) |
Zapisuje nazwę właściwości UTF-8 i wartość tekstową UTF-8 (jako ciąg JSON) jako część pary nazw/wartości obiektu JSON. |
WriteString(ReadOnlySpan<Byte>, ReadOnlySpan<Char>) |
Zapisuje nazwę właściwości UTF-8 i wartość tekstową UTF-16 (jako ciąg JSON) jako część pary nazw/wartości obiektu JSON. |
WriteString(ReadOnlySpan<Byte>, String) |
Zapisuje nazwę właściwości UTF-8 i wartość tekstową ciągu (jako ciąg JSON) jako część pary nazw/wartości obiektu JSON. |
WriteString(ReadOnlySpan<Byte>, Guid) |
Zapisuje nazwę właściwości UTF-8 i Guid wartość (jako ciąg JSON) jako część pary nazw/wartości obiektu JSON. |
WriteString(ReadOnlySpan<Char>, DateTime) |
Zapisuje nazwę właściwości określoną jako zakres znaków tylko do odczytu i DateTime wartość (jako ciąg JSON) jako część pary nazw/wartości obiektu JSON. |
WriteString(ReadOnlySpan<Char>, DateTimeOffset) |
Zapisuje nazwę właściwości określoną jako zakres znaków tylko do odczytu i DateTimeOffset wartość (jako ciąg JSON) jako część pary nazw/wartości obiektu JSON. |
WriteString(ReadOnlySpan<Char>, Guid) |
Zapisuje nazwę właściwości określoną jako zakres znaków tylko do odczytu i Guid wartość (jako ciąg JSON) jako część pary nazw/wartości obiektu JSON. |
WriteString(ReadOnlySpan<Char>, ReadOnlySpan<Byte>) |
Zapisuje nazwę właściwości UTF-16 i wartość tekstową UTF-8 (jako ciąg JSON) jako część pary nazw/wartości obiektu JSON. |
WriteString(ReadOnlySpan<Char>, ReadOnlySpan<Char>) |
Zapisuje nazwę właściwości UTF-16 i wartość tekstową UTF-16 (jako ciąg JSON) jako część pary nazw/wartości obiektu JSON. |
WriteString(ReadOnlySpan<Byte>, JsonEncodedText) |
Zapisuje nazwę właściwości UTF-8 i wartość wstępnie zakodowaną (jako ciąg JSON) jako część pary nazw/wartości obiektu JSON. |
WriteString(JsonEncodedText, JsonEncodedText)
Zapisuje wstępnie zakodowaną nazwę właściwości i wartość wstępnie zakodowaną (jako ciąg JSON) jako część pary nazw/wartości obiektu JSON.
public:
void WriteString(System::Text::Json::JsonEncodedText propertyName, System::Text::Json::JsonEncodedText value);
public void WriteString (System.Text.Json.JsonEncodedText propertyName, System.Text.Json.JsonEncodedText value);
member this.WriteString : System.Text.Json.JsonEncodedText * System.Text.Json.JsonEncodedText -> unit
Public Sub WriteString (propertyName As JsonEncodedText, value As JsonEncodedText)
Parametry
- propertyName
- JsonEncodedText
Nazwa właściwości zakodowanej w formacie JSON obiektu JSON, która ma być transkodowana i zapisywana jako UTF-8.
- value
- JsonEncodedText
Zakodowana w formacie JSON wartość, która ma być zapisywana jako transkodowany ciąg JSON UTF-8 w ramach pary nazw/wartości.
Wyjątki
Walidacja jest włączona, a operacja zapisu spowoduje wygenerowanie nieprawidłowego kodu JSON.
Uwagi
Nazwa i wartość właściwości powinny być już ucieczki po utworzeniu JsonEncodedText wystąpienia.
Dotyczy
WriteString(JsonEncodedText, String)
Zapisuje wstępnie zakodowaną nazwę właściwości i wartość tekstową ciągu (jako ciąg JSON) jako część pary nazw/wartości obiektu JSON.
public:
void WriteString(System::Text::Json::JsonEncodedText propertyName, System::String ^ value);
public void WriteString (System.Text.Json.JsonEncodedText propertyName, string? value);
public void WriteString (System.Text.Json.JsonEncodedText propertyName, string value);
member this.WriteString : System.Text.Json.JsonEncodedText * string -> unit
Public Sub WriteString (propertyName As JsonEncodedText, value As String)
Parametry
- propertyName
- JsonEncodedText
Nazwa właściwości zakodowanej w formacie JSON obiektu JSON, która ma być transkodowana i zapisywana jako UTF-8.
- value
- String
Wartość, która ma być zapisywana jako transkodowany ciąg JSON UTF-8 w ramach pary nazw/wartości.
Wyjątki
Określona wartość jest za duża.
Walidacja jest włączona, a operacja zapisu spowoduje wygenerowanie nieprawidłowego kodu JSON.
Uwagi
Nazwa właściwości powinna być już unikniętą po utworzeniu JsonEncodedText wystąpienia.
Wartość zostanie uniknięta przed zapisem.
Jeśli value
jest to null
, wartość null JSON jest zapisywana, tak jakby WriteNull(JsonEncodedText) metoda została wywołana.
Dotyczy
WriteString(JsonEncodedText, ReadOnlySpan<Char>)
Zapisuje wstępnie zakodowaną nazwę właściwości i wartość tekstową (jako ciąg JSON) w ramach pary nazw/wartości obiektu JSON.
public:
void WriteString(System::Text::Json::JsonEncodedText propertyName, ReadOnlySpan<char> value);
public void WriteString (System.Text.Json.JsonEncodedText propertyName, ReadOnlySpan<char> value);
member this.WriteString : System.Text.Json.JsonEncodedText * ReadOnlySpan<char> -> unit
Public Sub WriteString (propertyName As JsonEncodedText, value As ReadOnlySpan(Of Char))
Parametry
- propertyName
- JsonEncodedText
Nazwa właściwości zakodowanej w formacie JSON obiektu JSON, która ma być transkodowana i zapisywana jako UTF-8.
- value
- ReadOnlySpan<Char>
Wartość, która ma być zapisywana jako transkodowany ciąg JSON UTF-8 w ramach pary nazw/wartości.
Wyjątki
Określona wartość jest za duża.
Walidacja jest włączona, a operacja zapisu spowoduje wygenerowanie nieprawidłowego kodu JSON.
Uwagi
Nazwa właściwości powinna być już unikniętą po utworzeniu JsonEncodedText wystąpienia.
Wartość zostanie uniknięta przed zapisem.
Jeśli value
jest to null
, wartość null JSON jest zapisywana, tak jakby WriteNull(JsonEncodedText) metoda została wywołana.
Dotyczy
WriteString(JsonEncodedText, ReadOnlySpan<Byte>)
Zapisuje wstępnie zakodowaną nazwę właściwości i wartość tekstową UTF-8 (jako ciąg JSON) jako część pary nazw/wartości obiektu JSON.
public:
void WriteString(System::Text::Json::JsonEncodedText propertyName, ReadOnlySpan<System::Byte> utf8Value);
public void WriteString (System.Text.Json.JsonEncodedText propertyName, ReadOnlySpan<byte> utf8Value);
member this.WriteString : System.Text.Json.JsonEncodedText * ReadOnlySpan<byte> -> unit
Public Sub WriteString (propertyName As JsonEncodedText, utf8Value As ReadOnlySpan(Of Byte))
Parametry
- propertyName
- JsonEncodedText
Nazwa właściwości zakodowanej w formacie JSON obiektu JSON, która ma być transkodowana i zapisywana jako UTF-8.
- utf8Value
- ReadOnlySpan<Byte>
Zakodowana w formacie UTF-8 wartość, która ma być zapisywana jako ciąg JSON jako część pary nazw/wartości.
Wyjątki
Określona wartość jest za duża.
Walidacja jest włączona, a operacja zapisu spowoduje wygenerowanie nieprawidłowego kodu JSON.
Uwagi
Nazwa właściwości powinna być już unikniętą po utworzeniu JsonEncodedText wystąpienia.
Wartość zostanie uniknięta przed zapisem.
Dotyczy
WriteString(JsonEncodedText, Guid)
Zapisuje wstępnie zakodowaną nazwę właściwości i Guid wartość (jako ciąg JSON) jako część pary nazw/wartości obiektu JSON.
public:
void WriteString(System::Text::Json::JsonEncodedText propertyName, Guid value);
public void WriteString (System.Text.Json.JsonEncodedText propertyName, Guid value);
member this.WriteString : System.Text.Json.JsonEncodedText * Guid -> unit
Public Sub WriteString (propertyName As JsonEncodedText, value As Guid)
Parametry
- propertyName
- JsonEncodedText
Nazwa właściwości zakodowanej w formacie JSON obiektu JSON, która ma być transkodowana i zapisywana jako UTF-8.
- value
- Guid
Wartość, która ma być zapisywana jako ciąg JSON w ramach pary nazw/wartości.
Wyjątki
Walidacja jest włączona, a operacja zapisu spowoduje wygenerowanie nieprawidłowego kodu JSON.
Uwagi
Guid Zapisuje wartość domyślną StandardFormat (czyli "D") w postaci: nn-nnnn-nnnnnnnn.
Nazwa właściwości powinna być już unikniętą po utworzeniu JsonEncodedText wystąpienia.
Dotyczy
WriteString(JsonEncodedText, DateTimeOffset)
Zapisuje wstępnie zakodowaną nazwę właściwości i DateTimeOffset wartość (jako ciąg JSON) jako część pary nazw/wartości obiektu JSON.
public:
void WriteString(System::Text::Json::JsonEncodedText propertyName, DateTimeOffset value);
public void WriteString (System.Text.Json.JsonEncodedText propertyName, DateTimeOffset value);
member this.WriteString : System.Text.Json.JsonEncodedText * DateTimeOffset -> unit
Public Sub WriteString (propertyName As JsonEncodedText, value As DateTimeOffset)
Parametry
- propertyName
- JsonEncodedText
Nazwa właściwości zakodowanej w formacie JSON obiektu JSON, która ma być transkodowana i zapisywana jako UTF-8.
- value
- DateTimeOffset
Wartość, która ma być zapisywana jako ciąg JSON w ramach pary nazw/wartości.
Wyjątki
Walidacja jest włączona, a operacja zapisu spowoduje wygenerowanie nieprawidłowego kodu JSON.
Uwagi
DateTimeOffset Zapisuje 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-07:00.
Nazwa właściwości powinna być już unikniętą po utworzeniu JsonEncodedText wystąpienia.
Dotyczy
WriteString(JsonEncodedText, DateTime)
Zapisuje wstępnie zakodowaną nazwę właściwości i DateTime wartość (jako ciąg JSON) jako część pary nazwa/wartość obiektu JSON.
public:
void WriteString(System::Text::Json::JsonEncodedText propertyName, DateTime value);
public void WriteString (System.Text.Json.JsonEncodedText propertyName, DateTime value);
member this.WriteString : System.Text.Json.JsonEncodedText * DateTime -> unit
Public Sub WriteString (propertyName As JsonEncodedText, value As DateTime)
Parametry
- propertyName
- JsonEncodedText
Nazwa właściwości zakodowanej w formacie JSON obiektu JSON, która ma być transkodowana i zapisywana jako UTF-8.
- value
- DateTime
Wartość do zapisania jako ciąg JSON w ramach pary nazwa/wartość.
Wyjątki
Walidacja jest włączona, a operacja zapisu spowoduje wygenerowanie nieprawidłowego kodu JSON.
Uwagi
Zapisuje przy DateTime użyciu rozszerzonego formatu ISO 8601-1 (zobacz obsługę DateTime i DateTimeOffset w pliku System.Text.Json), na przykład 2017-06-12T05:30:45.7680000.
Nazwa właściwości powinna już zostać uniknięta podczas tworzenia wystąpienia JsonEncodedText klasy .
Dotyczy
WriteString(String, JsonEncodedText)
Zapisuje nazwę właściwości i wartość wstępnie zakodowaną (jako ciąg JSON) w ramach pary nazw/wartości obiektu JSON.
public:
void WriteString(System::String ^ propertyName, System::Text::Json::JsonEncodedText value);
public void WriteString (string propertyName, System.Text.Json.JsonEncodedText value);
member this.WriteString : string * System.Text.Json.JsonEncodedText -> unit
Public Sub WriteString (propertyName As String, value As JsonEncodedText)
Parametry
- propertyName
- String
Nazwa właściwości obiektu JSON, który ma być transkodowany i zapisywany jako UTF-8.
- value
- JsonEncodedText
Zakodowana wartość JSON do zapisania jako transkodowany ciąg JSON UTF-8 w ramach pary nazwa/wartość.
Wyjątki
Określona nazwa właściwości jest zbyt duża.
Walidacja jest włączona, a operacja zapisu spowoduje wygenerowanie nieprawidłowego kodu JSON.
Parametr propertyName
ma wartość null
.
Uwagi
Wartość powinna zostać już uniknięta podczas tworzenia wystąpienia JsonEncodedText .
Przed zapisaniem nazwa właściwości zostanie uniknięta.
Dotyczy
WriteString(String, String)
Zapisuje nazwę właściwości określoną jako ciąg i wartość tekstową ciągu (jako ciąg JSON) w ramach pary nazwa/wartość obiektu JSON.
public:
void WriteString(System::String ^ propertyName, System::String ^ value);
public void WriteString (string propertyName, string? value);
public void WriteString (string propertyName, string value);
member this.WriteString : string * string -> unit
Public Sub WriteString (propertyName As String, value As String)
Parametry
- propertyName
- String
Nazwa właściwości zakodowanej w formacie UTF-16 obiektu JSON, która ma być transkodowana i zapisywana jako UTF-8.
- value
- String
Zakodowana wartość UTF-16 do zapisania jako transkodowany ciąg JSON UTF-8 w ramach pary nazwa/wartość.
Wyjątki
Określona nazwa lub wartość właściwości jest za duża.
Walidacja jest włączona, a operacja zapisu spowoduje wygenerowanie nieprawidłowego kodu JSON.
Parametr propertyName
ma wartość null
.
Uwagi
Przed zapisaniem nazwy właściwości i wartości są usuwane znaki ucieczki.
Jeśli value
parametr ma null
wartość , jest zapisywana wartość null JSON, tak jakby WriteNull(String) metoda została wywołana.
Dotyczy
WriteString(String, ReadOnlySpan<Char>)
Zapisuje nazwę właściwości określoną jako ciąg i wartość tekstową UTF-16 (jako ciąg JSON) jako część pary nazwy/wartości obiektu JSON.
public:
void WriteString(System::String ^ propertyName, ReadOnlySpan<char> value);
public void WriteString (string propertyName, ReadOnlySpan<char> value);
member this.WriteString : string * ReadOnlySpan<char> -> unit
Public Sub WriteString (propertyName As String, value As ReadOnlySpan(Of Char))
Parametry
- propertyName
- String
Nazwa właściwości zakodowanej w formacie UTF-16 obiektu JSON, która ma być transkodowana i zapisywana jako UTF-8.
- value
- ReadOnlySpan<Char>
Zakodowana wartość UTF-16 do zapisania jako transkodowany ciąg JSON UTF-8 w ramach pary nazwa/wartość.
Wyjątki
Określona nazwa lub wartość właściwości jest za duża.
Walidacja jest włączona, a operacja zapisu spowoduje wygenerowanie nieprawidłowego kodu JSON.
Parametr propertyName
ma wartość null
.
Uwagi
Przed zapisaniem nazwy właściwości i wartości są usuwane znaki ucieczki.
Dotyczy
WriteString(String, ReadOnlySpan<Byte>)
Zapisuje nazwę właściwości określoną jako ciąg i wartość tekstową UTF-8 (jako ciąg JSON) jako część pary nazwy/wartości obiektu JSON.
public:
void WriteString(System::String ^ propertyName, ReadOnlySpan<System::Byte> utf8Value);
public void WriteString (string propertyName, ReadOnlySpan<byte> utf8Value);
member this.WriteString : string * ReadOnlySpan<byte> -> unit
Public Sub WriteString (propertyName As String, utf8Value As ReadOnlySpan(Of Byte))
Parametry
- propertyName
- String
Nazwa właściwości zakodowanej w formacie UTF-16 obiektu JSON, która ma być transkodowana i zapisywana jako UTF-8.
- utf8Value
- ReadOnlySpan<Byte>
Zakodowana wartość UTF-8 do zapisania jako ciąg JSON w ramach pary nazwa/wartość.
Wyjątki
Określona nazwa lub wartość właściwości jest za duża.
Walidacja jest włączona, a operacja zapisu spowoduje wygenerowanie nieprawidłowego kodu JSON.
Parametr propertyName
ma wartość null
.
Uwagi
Przed zapisaniem nazwy właściwości i wartości są usuwane znaki ucieczki.
Dotyczy
WriteString(String, DateTimeOffset)
Zapisuje nazwę właściwości określoną jako ciąg i DateTimeOffset wartość (jako ciąg JSON) w ramach pary nazwa/wartość obiektu JSON.
public:
void WriteString(System::String ^ propertyName, DateTimeOffset value);
public void WriteString (string propertyName, DateTimeOffset value);
member this.WriteString : string * DateTimeOffset -> unit
Public Sub WriteString (propertyName As String, value As DateTimeOffset)
Parametry
- propertyName
- String
Nazwa właściwości zakodowanej w formacie UTF-16 obiektu JSON, która ma być transkodowana i zapisywana jako UTF-8.
- value
- DateTimeOffset
Wartość do zapisania jako ciąg JSON w ramach pary nazwa/wartość.
Wyjątki
Określona nazwa właściwości jest zbyt duża.
Walidacja jest włączona, a operacja zapisu spowoduje wygenerowanie nieprawidłowego kodu JSON.
Parametr propertyName
ma wartość null
.
Uwagi
DateTimeOffset Zapisuje przy użyciu rozszerzonego formatu ISO 8601-1 (zobacz obsługę dateTime i DateTimeOffset w pliku System.Text.Json), na przykład 2017-06-12T05:30:45.7680000-07:00.
Przed zapisaniem nazwa właściwości zostanie uniknięta.
Dotyczy
WriteString(String, DateTime)
Zapisuje nazwę właściwości określoną jako ciąg i DateTime wartość (jako ciąg JSON) w ramach pary nazwa/wartość obiektu JSON.
public:
void WriteString(System::String ^ propertyName, DateTime value);
public void WriteString (string propertyName, DateTime value);
member this.WriteString : string * DateTime -> unit
Public Sub WriteString (propertyName As String, value As DateTime)
Parametry
- propertyName
- String
Nazwa właściwości zakodowanej w formacie UTF-16 obiektu JSON, która ma być transkodowana i zapisywana jako UTF-8.
- value
- DateTime
Wartość do zapisania jako ciąg JSON w ramach pary nazwa/wartość.
Wyjątki
Określona nazwa właściwości jest zbyt duża.
Walidacja jest włączona, a operacja zapisu spowoduje wygenerowanie nieprawidłowego kodu JSON.
Parametr propertyName
ma wartość null
.
Uwagi
Zapisuje przy DateTime użyciu rozszerzonego formatu ISO 8601-1 (zobacz obsługę DateTime i DateTimeOffset w pliku System.Text.Json), na przykład 2017-06-12T05:30:45.7680000.
Przed zapisaniem nazwa właściwości zostanie uniknięta.
Dotyczy
WriteString(String, Guid)
Zapisuje nazwę właściwości określoną jako ciąg i Guid wartość (jako ciąg JSON) w ramach pary nazwa/wartość obiektu JSON.
public:
void WriteString(System::String ^ propertyName, Guid value);
public void WriteString (string propertyName, Guid value);
member this.WriteString : string * Guid -> unit
Public Sub WriteString (propertyName As String, value As Guid)
Parametry
- propertyName
- String
Nazwa właściwości zakodowanej w formacie UTF-16 obiektu JSON, która ma być transkodowana i zapisywana jako UTF-8.
- value
- Guid
Wartość do zapisania jako ciąg JSON w ramach pary nazwa/wartość.
Wyjątki
Określona nazwa właściwości jest zbyt duża.
Walidacja jest włączona, a operacja zapisu spowoduje wygenerowanie nieprawidłowego kodu JSON.
Parametr propertyName
ma wartość null
.
Uwagi
Guid Zapisuje przy użyciu wartości domyślnej StandardFormat (czyli "D") w postaci: nnnnnnnn-nnnn-nnnn-nnnn-nnnn-nnnnnnnnnn. Przed zapisaniem nazwa właściwości zostanie uniknięta.
Dotyczy
WriteString(ReadOnlySpan<Char>, String)
Zapisuje nazwę właściwości UTF-16 i wartość tekstową ciągu (jako ciąg JSON) jako część pary nazwy/wartości obiektu JSON.
public:
void WriteString(ReadOnlySpan<char> propertyName, System::String ^ value);
public void WriteString (ReadOnlySpan<char> propertyName, string? value);
public void WriteString (ReadOnlySpan<char> propertyName, string value);
member this.WriteString : ReadOnlySpan<char> * string -> unit
Public Sub WriteString (propertyName As ReadOnlySpan(Of Char), value As String)
Parametry
- propertyName
- ReadOnlySpan<Char>
Nazwa właściwości zakodowanej w formacie UTF-16 obiektu JSON, która ma być transkodowana i zapisywana jako UTF-8.
- value
- String
Zakodowana wartość UTF-16 do zapisania jako transkodowany ciąg JSON UTF-8 w ramach pary nazwa/wartość.
Wyjątki
Określona nazwa lub wartość właściwości jest za duża.
Walidacja jest włączona, a operacja zapisu spowoduje wygenerowanie nieprawidłowego kodu JSON.
Uwagi
Przed zapisaniem nazwy właściwości i wartości są usuwane znaki ucieczki.
Jeśli value
parametr ma null
wartość , jest zapisywana wartość null JSON, tak jakby WriteNull(ReadOnlySpan<Char>) metoda została wywołana.
Dotyczy
WriteString(ReadOnlySpan<Byte>, DateTime)
Zapisuje nazwę właściwości UTF-8 i DateTime wartość (jako ciąg JSON) w ramach pary nazwa/wartość obiektu JSON.
public:
void WriteString(ReadOnlySpan<System::Byte> utf8PropertyName, DateTime value);
public void WriteString (ReadOnlySpan<byte> utf8PropertyName, DateTime value);
member this.WriteString : ReadOnlySpan<byte> * DateTime -> unit
Public Sub WriteString (utf8PropertyName As ReadOnlySpan(Of Byte), value As DateTime)
Parametry
- utf8PropertyName
- ReadOnlySpan<Byte>
Nazwa właściwości zakodowanej w formacie UTF-8 obiektu JSON do zapisania.
- value
- DateTime
Wartość do zapisania jako ciąg JSON w ramach pary nazwa/wartość.
Wyjątki
Określona nazwa właściwości jest zbyt duża.
Walidacja jest włączona, a operacja zapisu spowoduje wygenerowanie nieprawidłowego kodu JSON.
Uwagi
Zapisuje przy DateTime użyciu rozszerzonego formatu ISO 8601-1 (zobacz obsługę DateTime i DateTimeOffset w pliku System.Text.Json), na przykład 2017-06-12T05:30:45.7680000.
Przed zapisaniem nazwa właściwości zostanie uniknięta.
Dotyczy
WriteString(ReadOnlySpan<Byte>, DateTimeOffset)
Zapisuje nazwę właściwości UTF-8 i DateTimeOffset wartość (jako ciąg JSON) w ramach pary nazwa/wartość obiektu JSON.
public:
void WriteString(ReadOnlySpan<System::Byte> utf8PropertyName, DateTimeOffset value);
public void WriteString (ReadOnlySpan<byte> utf8PropertyName, DateTimeOffset value);
member this.WriteString : ReadOnlySpan<byte> * DateTimeOffset -> unit
Public Sub WriteString (utf8PropertyName As ReadOnlySpan(Of Byte), value As DateTimeOffset)
Parametry
- utf8PropertyName
- ReadOnlySpan<Byte>
Nazwa właściwości zakodowanej w formacie UTF-8 obiektu JSON do zapisania.
- value
- DateTimeOffset
Wartość do zapisania jako ciąg JSON w ramach pary nazwa/wartość.
Wyjątki
Określona nazwa właściwości jest zbyt duża.
Walidacja jest włączona, a operacja zapisu spowoduje wygenerowanie nieprawidłowego kodu JSON.
Uwagi
DateTimeOffset Zapisuje przy użyciu rozszerzonego formatu ISO 8601-1 (zobacz obsługę dateTime i DateTimeOffset w pliku System.Text.Json), na przykład 2017-06-12T05:30:45.7680000-07:00.
Przed zapisaniem nazwa właściwości zostanie uniknięta.
Dotyczy
WriteString(ReadOnlySpan<Char>, JsonEncodedText)
Zapisuje nazwę właściwości i wartość wstępnie zakodowaną (jako ciąg JSON) w ramach pary nazw/wartości obiektu JSON.
public:
void WriteString(ReadOnlySpan<char> propertyName, System::Text::Json::JsonEncodedText value);
public void WriteString (ReadOnlySpan<char> propertyName, System.Text.Json.JsonEncodedText value);
member this.WriteString : ReadOnlySpan<char> * System.Text.Json.JsonEncodedText -> unit
Public Sub WriteString (propertyName As ReadOnlySpan(Of Char), value As JsonEncodedText)
Parametry
- propertyName
- ReadOnlySpan<Char>
Nazwa właściwości obiektu JSON, który ma być transkodowany i zapisywany jako UTF-8.
- value
- JsonEncodedText
Zakodowana wartość JSON do zapisania jako transkodowany ciąg JSON UTF-8 w ramach pary nazwa/wartość.
Wyjątki
Określona nazwa właściwości jest zbyt duża.
Walidacja jest włączona, a operacja zapisu spowoduje wygenerowanie nieprawidłowego kodu JSON.
Uwagi
Wartość powinna zostać już uniknięta podczas tworzenia wystąpienia JsonEncodedText .
Przed zapisaniem nazwa właściwości zostanie uniknięta.
Dotyczy
WriteString(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>)
Zapisuje nazwę właściwości UTF-8 i wartość tekstową UTF-8 (jako ciąg JSON) w ramach pary nazw/wartości obiektu JSON.
public:
void WriteString(ReadOnlySpan<System::Byte> utf8PropertyName, ReadOnlySpan<System::Byte> utf8Value);
public void WriteString (ReadOnlySpan<byte> utf8PropertyName, ReadOnlySpan<byte> utf8Value);
member this.WriteString : ReadOnlySpan<byte> * ReadOnlySpan<byte> -> unit
Public Sub WriteString (utf8PropertyName As ReadOnlySpan(Of Byte), utf8Value As ReadOnlySpan(Of Byte))
Parametry
- utf8PropertyName
- ReadOnlySpan<Byte>
Nazwa właściwości zakodowanej w formacie UTF-8 obiektu JSON do zapisania.
- utf8Value
- ReadOnlySpan<Byte>
Zakodowana wartość UTF-8 do zapisania jako ciąg JSON w ramach pary nazwa/wartość.
Wyjątki
Określona nazwa lub wartość właściwości jest za duża.
Walidacja jest włączona, a operacja zapisu spowoduje wygenerowanie nieprawidłowego kodu JSON.
Uwagi
Przed zapisaniem nazwy właściwości i wartości są usuwane znaki ucieczki.
Dotyczy
WriteString(ReadOnlySpan<Byte>, ReadOnlySpan<Char>)
Zapisuje nazwę właściwości UTF-8 i wartość tekstową UTF-16 (jako ciąg JSON) w ramach pary nazw/wartości obiektu JSON.
public:
void WriteString(ReadOnlySpan<System::Byte> utf8PropertyName, ReadOnlySpan<char> value);
public void WriteString (ReadOnlySpan<byte> utf8PropertyName, ReadOnlySpan<char> value);
member this.WriteString : ReadOnlySpan<byte> * ReadOnlySpan<char> -> unit
Public Sub WriteString (utf8PropertyName As ReadOnlySpan(Of Byte), value As ReadOnlySpan(Of Char))
Parametry
- utf8PropertyName
- ReadOnlySpan<Byte>
Nazwa właściwości zakodowanej w formacie UTF-8 obiektu JSON do zapisania.
- value
- ReadOnlySpan<Char>
Zakodowana wartość UTF-16 do zapisania jako transkodowany ciąg JSON UTF-8 w ramach pary nazwa/wartość.
Wyjątki
Określona nazwa lub wartość właściwości jest za duża.
Walidacja jest włączona, a operacja zapisu spowoduje wygenerowanie nieprawidłowego kodu JSON.
Uwagi
Przed zapisaniem nazwy właściwości i wartości są usuwane znaki ucieczki.
Dotyczy
WriteString(ReadOnlySpan<Byte>, String)
Zapisuje nazwę właściwości UTF-8 i wartość tekstową ciągu (jako ciąg JSON) w ramach pary nazwy/wartości obiektu JSON.
public:
void WriteString(ReadOnlySpan<System::Byte> utf8PropertyName, System::String ^ value);
public void WriteString (ReadOnlySpan<byte> utf8PropertyName, string? value);
public void WriteString (ReadOnlySpan<byte> utf8PropertyName, string value);
member this.WriteString : ReadOnlySpan<byte> * string -> unit
Public Sub WriteString (utf8PropertyName As ReadOnlySpan(Of Byte), value As String)
Parametry
- utf8PropertyName
- ReadOnlySpan<Byte>
Nazwa właściwości zakodowanej w formacie UTF-8 obiektu JSON do zapisania.
- value
- String
Zakodowana wartość UTF-16 do zapisania jako transkodowany ciąg JSON UTF-8 w ramach pary nazwa/wartość.
Wyjątki
Określona nazwa lub wartość właściwości jest za duża.
Walidacja jest włączona, a operacja zapisu spowoduje wygenerowanie nieprawidłowego kodu JSON.
Uwagi
Przed zapisaniem nazwy właściwości i wartości są usuwane znaki ucieczki.
Jeśli value
parametr ma null
wartość , jest zapisywana wartość null JSON, tak jakby WriteNull(ReadOnlySpan<Byte>) metoda została wywołana.
Dotyczy
WriteString(ReadOnlySpan<Byte>, Guid)
Zapisuje nazwę właściwości UTF-8 i Guid wartość (jako ciąg JSON) w ramach pary nazwa/wartość obiektu JSON.
public:
void WriteString(ReadOnlySpan<System::Byte> utf8PropertyName, Guid value);
public void WriteString (ReadOnlySpan<byte> utf8PropertyName, Guid value);
member this.WriteString : ReadOnlySpan<byte> * Guid -> unit
Public Sub WriteString (utf8PropertyName As ReadOnlySpan(Of Byte), value As Guid)
Parametry
- utf8PropertyName
- ReadOnlySpan<Byte>
Nazwa właściwości zakodowanej w formacie UTF-8 obiektu JSON do zapisania.
- value
- Guid
Wartość do zapisania jako ciąg JSON w ramach pary nazwa/wartość.
Wyjątki
Określona nazwa właściwości jest zbyt duża.
Walidacja jest włączona, a operacja zapisu spowoduje wygenerowanie nieprawidłowego kodu JSON.
Uwagi
Guid Zapisuje przy użyciu wartości domyślnej StandardFormat (czyli "D") w postaci: nnnnnnnn-nnnn-nnnn-nnnn-nnnn-nnnnnnnnnn. Przed zapisaniem nazwa właściwości zostanie uniknięta.
Dotyczy
WriteString(ReadOnlySpan<Char>, DateTime)
Zapisuje nazwę właściwości określoną jako zakres znaków tylko do odczytu i DateTime wartość (jako ciąg JSON) jako część pary nazwy/wartości obiektu JSON.
public:
void WriteString(ReadOnlySpan<char> propertyName, DateTime value);
public void WriteString (ReadOnlySpan<char> propertyName, DateTime value);
member this.WriteString : ReadOnlySpan<char> * DateTime -> unit
Public Sub WriteString (propertyName As ReadOnlySpan(Of Char), value As DateTime)
Parametry
- propertyName
- ReadOnlySpan<Char>
Nazwa właściwości zakodowanej w formacie UTF-16 obiektu JSON, która ma być transkodowana i zapisywana jako UTF-8.
- value
- DateTime
Wartość do zapisania jako ciąg JSON w ramach pary nazwa/wartość.
Wyjątki
Określona nazwa właściwości jest zbyt duża.
Walidacja jest włączona, a operacja zapisu spowoduje wygenerowanie nieprawidłowego kodu JSON.
Uwagi
Zapisuje przy DateTime użyciu rozszerzonego formatu ISO 8601-1 (zobacz obsługę DateTime i DateTimeOffset w pliku System.Text.Json), na przykład 2017-06-12T05:30:45.7680000.
Przed zapisaniem nazwa właściwości zostanie uniknięta.
Dotyczy
WriteString(ReadOnlySpan<Char>, DateTimeOffset)
Zapisuje nazwę właściwości określoną jako zakres znaków tylko do odczytu i DateTimeOffset wartość (jako ciąg JSON) jako część pary nazwy/wartości obiektu JSON.
public:
void WriteString(ReadOnlySpan<char> propertyName, DateTimeOffset value);
public void WriteString (ReadOnlySpan<char> propertyName, DateTimeOffset value);
member this.WriteString : ReadOnlySpan<char> * DateTimeOffset -> unit
Public Sub WriteString (propertyName As ReadOnlySpan(Of Char), value As DateTimeOffset)
Parametry
- propertyName
- ReadOnlySpan<Char>
Nazwa właściwości zakodowanej w formacie UTF-16 obiektu JSON, która ma być transkodowana i zapisywana jako UTF-8.
- value
- DateTimeOffset
Wartość do zapisania jako ciąg JSON w ramach pary nazwa/wartość.
Wyjątki
Określona nazwa właściwości jest zbyt duża.
Walidacja jest włączona, a operacja zapisu spowoduje wygenerowanie nieprawidłowego kodu JSON.
Uwagi
DateTimeOffset Zapisuje przy użyciu rozszerzonego formatu ISO 8601-1 (zobacz obsługę dateTime i DateTimeOffset w pliku System.Text.Json), na przykład 2017-06-12T05:30:45.7680000-07:00.
Przed zapisaniem nazwa właściwości zostanie uniknięta.
Dotyczy
WriteString(ReadOnlySpan<Char>, Guid)
Zapisuje nazwę właściwości określoną jako zakres znaków tylko do odczytu i Guid wartość (jako ciąg JSON) jako część pary nazwy/wartości obiektu JSON.
public:
void WriteString(ReadOnlySpan<char> propertyName, Guid value);
public void WriteString (ReadOnlySpan<char> propertyName, Guid value);
member this.WriteString : ReadOnlySpan<char> * Guid -> unit
Public Sub WriteString (propertyName As ReadOnlySpan(Of Char), value As Guid)
Parametry
- propertyName
- ReadOnlySpan<Char>
Nazwa właściwości zakodowanej w formacie UTF-16 obiektu JSON, która ma być transkodowana i zapisywana jako UTF-8.
- value
- Guid
Wartość do zapisania jako ciąg JSON w ramach pary nazwa/wartość.
Wyjątki
Określona nazwa właściwości jest zbyt duża.
Walidacja jest włączona, a operacja zapisu spowoduje wygenerowanie nieprawidłowego kodu JSON.
Uwagi
Guid Zapisuje przy użyciu wartości domyślnej StandardFormat (czyli "D") w postaci: nnnnnnnn-nnnn-nnnn-nnnn-nnnn-nnnnnnnnnn. Przed zapisaniem nazwa właściwości zostanie uniknięta.
Dotyczy
WriteString(ReadOnlySpan<Char>, ReadOnlySpan<Byte>)
Zapisuje nazwę właściwości UTF-16 i wartość tekstową UTF-8 (jako ciąg JSON) jako część pary nazwy/wartości obiektu JSON.
public:
void WriteString(ReadOnlySpan<char> propertyName, ReadOnlySpan<System::Byte> utf8Value);
public void WriteString (ReadOnlySpan<char> propertyName, ReadOnlySpan<byte> utf8Value);
member this.WriteString : ReadOnlySpan<char> * ReadOnlySpan<byte> -> unit
Public Sub WriteString (propertyName As ReadOnlySpan(Of Char), utf8Value As ReadOnlySpan(Of Byte))
Parametry
- propertyName
- ReadOnlySpan<Char>
Nazwa właściwości zakodowanej w formacie UTF-16 obiektu JSON, która ma być transkodowana i zapisywana jako UTF-8.
- utf8Value
- ReadOnlySpan<Byte>
Zakodowana wartość UTF-8 do zapisania jako ciąg JSON w ramach pary nazwa/wartość.
Wyjątki
Określona nazwa lub wartość właściwości jest za duża.
Walidacja jest włączona, a operacja zapisu spowoduje wygenerowanie nieprawidłowego kodu JSON.
Uwagi
Przed zapisaniem nazwy właściwości i wartości są usuwane znaki ucieczki.
Dotyczy
WriteString(ReadOnlySpan<Char>, ReadOnlySpan<Char>)
Zapisuje nazwę właściwości UTF-16 i wartość tekstową UTF-16 (jako ciąg JSON) w ramach pary nazw/wartości obiektu JSON.
public:
void WriteString(ReadOnlySpan<char> propertyName, ReadOnlySpan<char> value);
public void WriteString (ReadOnlySpan<char> propertyName, ReadOnlySpan<char> value);
member this.WriteString : ReadOnlySpan<char> * ReadOnlySpan<char> -> unit
Public Sub WriteString (propertyName As ReadOnlySpan(Of Char), value As ReadOnlySpan(Of Char))
Parametry
- propertyName
- ReadOnlySpan<Char>
Nazwa właściwości zakodowanej w formacie UTF-16 obiektu JSON, która ma być transkodowana i zapisywana jako UTF-8.
- value
- ReadOnlySpan<Char>
Zakodowana wartość UTF-16 do zapisania jako transkodowany ciąg JSON UTF-8 w ramach pary nazwa/wartość.
Wyjątki
Określona nazwa lub wartość właściwości jest za duża.
Walidacja jest włączona, a operacja zapisu spowoduje wygenerowanie nieprawidłowego kodu JSON.
Uwagi
Przed zapisaniem nazwy właściwości i wartości są usuwane znaki ucieczki.
Dotyczy
WriteString(ReadOnlySpan<Byte>, JsonEncodedText)
Zapisuje nazwę właściwości UTF-8 i wartość wstępnie zakodowaną (jako ciąg JSON) jako część pary nazwy/wartości obiektu JSON.
public:
void WriteString(ReadOnlySpan<System::Byte> utf8PropertyName, System::Text::Json::JsonEncodedText value);
public void WriteString (ReadOnlySpan<byte> utf8PropertyName, System.Text.Json.JsonEncodedText value);
member this.WriteString : ReadOnlySpan<byte> * System.Text.Json.JsonEncodedText -> unit
Public Sub WriteString (utf8PropertyName As ReadOnlySpan(Of Byte), value As JsonEncodedText)
Parametry
- utf8PropertyName
- ReadOnlySpan<Byte>
Nazwa właściwości zakodowanej w formacie UTF-8 obiektu JSON do zapisania.
- value
- JsonEncodedText
Zakodowana wartość JSON do zapisania jako transkodowany ciąg JSON UTF-8 w ramach pary nazwa/wartość.
Wyjątki
Określona nazwa właściwości jest zbyt duża.
Walidacja jest włączona, a ta metoda spowoduje napisanie nieprawidłowego kodu JSON.
Uwagi
Wartość powinna zostać już uniknięta podczas tworzenia wystąpienia JsonEncodedText .
Przed zapisaniem nazwa właściwości zostanie uniknięta.