Utf8JsonReader.CopyString Yöntem

Tanım

Ad Alanı:

System.Text.Json

Bütünleştirilmiş Kod:

System.Text.Json.dll

Paket:

System.Text.Json v9.0.0-rc.2.24473.5

Aşırı Yüklemeler

CopyString(Span<Byte>)	Geçerli JSON belirteci değerini kaynaktan ayırmadan UTF-8 bayt olarak arabelleğe kopyalar.
CopyString(Span<Char>)	Geçerli JSON belirteci değerini kaynaktan ayırmadan UTF-16 karakter olarak arabelleğe kopyalar.

CopyString(Span<Byte>)

Kaynak:

Utf8JsonReader.TryGet.cs

Geçerli JSON belirteci değerini kaynaktan ayırmadan UTF-8 bayt olarak arabelleğe kopyalar.

public:
 int CopyString(Span<System::Byte> utf8Destination);

public readonly int CopyString (Span<byte> utf8Destination);

member this.CopyString : Span<byte> -> int

Public Function CopyString (utf8Destination As Span(Of Byte)) As Integer

Parametreler

utf8Destination

Span<Byte>

Ayarlanmamış UTF-8 baytlarının yazıldığı arabellek.

Döndürülenler

Int32

öğesine yazılan utf8Destinationbayt sayısı.

Özel durumlar

InvalidOperationException

JSON belirteci bir dize değildir, yani veya PropertyNamedeğildirString.

-veya-

JSON dizesi geçersiz UTF-8 bayt veya geçersiz UTF-16 vekilleri içeriyor.

ArgumentException

Hedef arabellek, ayarlanmamış değeri barındıramayacak kadar küçük.

Açıklamalar

'nin aksine GetString(), bu yöntem desteklemez Null.

Hedef arabellek, ayarlanmamış değeri tutmak için çok küçükse bu yöntem bir ArgumentException oluşturur. Ya da ValueSpanValueSequenceuzunluğuna bakarak uygun şekilde boyutlandırılmış bir arabellek belirleyebilirsiniz çünkü sıralanmamış sonuç her zaman kodlanmış dizelerin uzunluğuna eşit veya daha küçüktür.

Ayrıca bkz.

• TokenType

CopyString(Span<Char>)

Kaynak:

Utf8JsonReader.TryGet.cs

Geçerli JSON belirteci değerini kaynaktan ayırmadan UTF-16 karakter olarak arabelleğe kopyalar.

public:
 int CopyString(Span<char> destination);

public readonly int CopyString (Span<char> destination);

member this.CopyString : Span<char> -> int

Public Function CopyString (destination As Span(Of Char)) As Integer

Parametreler

destination

Span<Char>

Dönüştürülen UTF-16 karakterlerinin yazıldığı arabellek.

Döndürülenler

Int32

öğesine yazılan destinationkarakter sayısı.

Özel durumlar

InvalidOperationException

JSON belirteci bir dize değildir, yani veya PropertyNamedeğildirString.

-veya-

JSON dizesi geçersiz UTF-8 bayt veya geçersiz UTF-16 vekilleri içeriyor.

ArgumentException

Hedef arabellek, ayarlanmamış değeri barındıramayacak kadar küçük.

Açıklamalar

'nin aksine GetString(), bu yöntem desteklemez Null.

Hedef arabellek, ayarlanmamış değeri tutmak için çok küçükse bu yöntem bir ArgumentException oluşturur. Ya da ValueSpanValueSequenceuzunluğuna bakarak uygun şekilde boyutlandırılmış bir arabellek belirleyebilirsiniz çünkü sıralanmamış sonuç her zaman kodlanmış dizelerin uzunluğuna eşit veya daha küçüktür.

Ayrıca bkz.

• TokenType