Utf8JsonWriter.WriteString Metoda

Definicja

Przestrzeń nazw:

System.Text.Json

Zestaw:

System.Text.Json.dll

Pakiet:

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

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)

Źródło:

Utf8JsonWriter.WriteProperties.String.cs

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

InvalidOperationException

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.

WriteString(JsonEncodedText, String)

Źródło:

Utf8JsonWriter.WriteProperties.String.cs

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);

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

ArgumentException

Określona wartość jest za duża.

InvalidOperationException

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.

WriteString(JsonEncodedText, ReadOnlySpan<Char>)

Źródło:

Utf8JsonWriter.WriteProperties.String.cs

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

ArgumentException

Określona wartość jest za duża.

InvalidOperationException

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.

WriteString(JsonEncodedText, ReadOnlySpan<Byte>)

Źródło:

Utf8JsonWriter.WriteProperties.String.cs

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

ArgumentException

Określona wartość jest za duża.

InvalidOperationException

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.

WriteString(JsonEncodedText, Guid)

Źródło:

Utf8JsonWriter.WriteProperties.Guid.cs

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

InvalidOperationException

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.

WriteString(JsonEncodedText, DateTimeOffset)

Źródło:

Utf8JsonWriter.WriteProperties.DateTimeOffset.cs

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

InvalidOperationException

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.

WriteString(JsonEncodedText, DateTime)

Źródło:

Utf8JsonWriter.WriteProperties.DateTime.cs

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

InvalidOperationException

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 .

WriteString(String, JsonEncodedText)

Źródło:

Utf8JsonWriter.WriteProperties.String.cs

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

ArgumentException

Określona nazwa właściwości jest zbyt duża.

InvalidOperationException

Walidacja jest włączona, a operacja zapisu spowoduje wygenerowanie nieprawidłowego kodu JSON.

ArgumentNullException

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.

WriteString(String, String)

Źródło:

Utf8JsonWriter.WriteProperties.String.cs

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);

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

ArgumentException

Określona nazwa lub wartość właściwości jest za duża.

InvalidOperationException

Walidacja jest włączona, a operacja zapisu spowoduje wygenerowanie nieprawidłowego kodu JSON.

ArgumentNullException

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 nullwartość , jest zapisywana wartość null JSON, tak jakby WriteNull(String) metoda została wywołana.

WriteString(String, ReadOnlySpan<Char>)

Źródło:

Utf8JsonWriter.WriteProperties.String.cs

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

ArgumentException

Określona nazwa lub wartość właściwości jest za duża.

InvalidOperationException

Walidacja jest włączona, a operacja zapisu spowoduje wygenerowanie nieprawidłowego kodu JSON.

ArgumentNullException

Parametr propertyName ma wartość null.

Uwagi

Przed zapisaniem nazwy właściwości i wartości są usuwane znaki ucieczki.

WriteString(String, ReadOnlySpan<Byte>)

Źródło:

Utf8JsonWriter.WriteProperties.String.cs

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

ArgumentException

Określona nazwa lub wartość właściwości jest za duża.

InvalidOperationException

Walidacja jest włączona, a operacja zapisu spowoduje wygenerowanie nieprawidłowego kodu JSON.

ArgumentNullException

Parametr propertyName ma wartość null.

Uwagi

Przed zapisaniem nazwy właściwości i wartości są usuwane znaki ucieczki.

WriteString(String, DateTimeOffset)

Źródło:

Utf8JsonWriter.WriteProperties.DateTimeOffset.cs

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

ArgumentException

Określona nazwa właściwości jest zbyt duża.

InvalidOperationException

Walidacja jest włączona, a operacja zapisu spowoduje wygenerowanie nieprawidłowego kodu JSON.

ArgumentNullException

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.

WriteString(String, DateTime)

Źródło:

Utf8JsonWriter.WriteProperties.DateTime.cs

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

ArgumentException

Określona nazwa właściwości jest zbyt duża.

InvalidOperationException

Walidacja jest włączona, a operacja zapisu spowoduje wygenerowanie nieprawidłowego kodu JSON.

ArgumentNullException

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.

WriteString(String, Guid)

Źródło:

Utf8JsonWriter.WriteProperties.Guid.cs

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

ArgumentException

Określona nazwa właściwości jest zbyt duża.

InvalidOperationException

Walidacja jest włączona, a operacja zapisu spowoduje wygenerowanie nieprawidłowego kodu JSON.

ArgumentNullException

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.

WriteString(ReadOnlySpan<Char>, String)

Źródło:

Utf8JsonWriter.WriteProperties.String.cs

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);

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

ArgumentException

Określona nazwa lub wartość właściwości jest za duża.

InvalidOperationException

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 nullwartość , jest zapisywana wartość null JSON, tak jakby WriteNull(ReadOnlySpan<Char>) metoda została wywołana.

WriteString(ReadOnlySpan<Byte>, DateTime)

Źródło:

Utf8JsonWriter.WriteProperties.DateTime.cs

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

ArgumentException

Określona nazwa właściwości jest zbyt duża.

InvalidOperationException

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.

WriteString(ReadOnlySpan<Byte>, DateTimeOffset)

Źródło:

Utf8JsonWriter.WriteProperties.DateTimeOffset.cs

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

ArgumentException

Określona nazwa właściwości jest zbyt duża.

InvalidOperationException

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.

WriteString(ReadOnlySpan<Char>, JsonEncodedText)

Źródło:

Utf8JsonWriter.WriteProperties.String.cs

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

ArgumentException

Określona nazwa właściwości jest zbyt duża.

InvalidOperationException

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.

WriteString(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>)

Źródło:

Utf8JsonWriter.WriteProperties.String.cs

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

ArgumentException

Określona nazwa lub wartość właściwości jest za duża.

InvalidOperationException

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.

WriteString(ReadOnlySpan<Byte>, ReadOnlySpan<Char>)

Źródło:

Utf8JsonWriter.WriteProperties.String.cs

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

ArgumentException

Określona nazwa lub wartość właściwości jest za duża.

InvalidOperationException

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.

WriteString(ReadOnlySpan<Byte>, String)

Źródło:

Utf8JsonWriter.WriteProperties.String.cs

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);

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

ArgumentException

Określona nazwa lub wartość właściwości jest za duża.

InvalidOperationException

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 nullwartość , jest zapisywana wartość null JSON, tak jakby WriteNull(ReadOnlySpan<Byte>) metoda została wywołana.

WriteString(ReadOnlySpan<Byte>, Guid)

Źródło:

Utf8JsonWriter.WriteProperties.Guid.cs

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

ArgumentException

Określona nazwa właściwości jest zbyt duża.

InvalidOperationException

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.

WriteString(ReadOnlySpan<Char>, DateTime)

Źródło:

Utf8JsonWriter.WriteProperties.DateTime.cs

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

ArgumentException

Określona nazwa właściwości jest zbyt duża.

InvalidOperationException

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.

WriteString(ReadOnlySpan<Char>, DateTimeOffset)

Źródło:

Utf8JsonWriter.WriteProperties.DateTimeOffset.cs

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

ArgumentException

Określona nazwa właściwości jest zbyt duża.

InvalidOperationException

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.

WriteString(ReadOnlySpan<Char>, Guid)

Źródło:

Utf8JsonWriter.WriteProperties.Guid.cs

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

ArgumentException

Określona nazwa właściwości jest zbyt duża.

InvalidOperationException

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.

WriteString(ReadOnlySpan<Char>, ReadOnlySpan<Byte>)

Źródło:

Utf8JsonWriter.WriteProperties.String.cs

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

ArgumentException

Określona nazwa lub wartość właściwości jest za duża.

InvalidOperationException

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.

WriteString(ReadOnlySpan<Char>, ReadOnlySpan<Char>)

Źródło:

Utf8JsonWriter.WriteProperties.String.cs

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

ArgumentException

Określona nazwa lub wartość właściwości jest za duża.

InvalidOperationException

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.

WriteString(ReadOnlySpan<Byte>, JsonEncodedText)

Źródło:

Utf8JsonWriter.WriteProperties.String.cs

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

ArgumentException

Określona nazwa właściwości jest zbyt duża.

InvalidOperationException

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.