Utf8JsonReader.ValueTextEquals 方法

定義

命名空間:

System.Text.Json

組件:

System.Text.Json.dll

多載

ValueTextEquals(ReadOnlySpan<Byte>)	將唯讀位元組範圍中的 UTF-8 編碼文字與來源中未逸出的 JSON 權杖值比較，並傳回指出它們是否相符的值。
ValueTextEquals(ReadOnlySpan<Char>)	將唯讀字元範圍中的文字與來源中未逸出的 JSON 權杖值進行比較，並傳回指出它們是否相符的值。
ValueTextEquals(String)	將字串文字與來源中未逸出的 JSON 權杖值進行比較，並傳回指出它們是否相符的值。

ValueTextEquals(ReadOnlySpan<Byte>)

來源:

Utf8JsonReader.cs

將唯讀位元組範圍中的 UTF-8 編碼文字與來源中未逸出的 JSON 權杖值比較，並傳回指出它們是否相符的值。

public:
 bool ValueTextEquals(ReadOnlySpan<System::Byte> utf8Text);

public readonly bool ValueTextEquals (ReadOnlySpan<byte> utf8Text);

member this.ValueTextEquals : ReadOnlySpan<byte> -> bool

Public Function ValueTextEquals (utf8Text As ReadOnlySpan(Of Byte)) As Boolean

參數

utf8Text

ReadOnlySpan<Byte>

要用來比較的 UTF-8 編碼文字。

傳回

Boolean

若來源中的 JSON 權杖值符合 UTF-8 編碼查閱文字，即為 true；否則為 false。

例外狀況

InvalidOperationException

JSON 權杖不是 JSON 字串 (亦即，它不是 String 或 PropertyName)。

備註

查閱文字必須是有效的 UTF-8 文字。 否則，如果來源有包含相符之 UTF-8 文字不正確字串標記，這個方法可能會傳回 true 。

來源中的 JSON 權杖值比較，並視需要先取消擷取來源中的 JSON 值，即可完成查閱文字。 查閱文字會依原樣比對，而不需進行任何修改。

ValueTextEquals(ReadOnlySpan<Char>)

來源:

Utf8JsonReader.cs

將唯讀字元範圍中的文字與來源中未逸出的 JSON 權杖值進行比較，並傳回指出它們是否相符的值。

public:
 bool ValueTextEquals(ReadOnlySpan<char> text);

public readonly bool ValueTextEquals (ReadOnlySpan<char> text);

member this.ValueTextEquals : ReadOnlySpan<char> -> bool

Public Function ValueTextEquals (text As ReadOnlySpan(Of Char)) As Boolean

參數

text

ReadOnlySpan<Char>

要比較的文字。

傳回

Boolean

若來源中的 JSON 權杖值符合查閱文字，即為 true；否則為 false。

例外狀況

InvalidOperationException

JSON 權杖不是 JSON 字串 (亦即，它不是 String 或 PropertyName)。

備註

如果查閱文字無效或不完整的 UTF-16 文字 (也就是未配對的 Surrogates) ，則方法會傳回 false ，因為 JSON 承載內不能有不正確 UTF-16。

來源中的 JSON 權杖值比較，並視需要先取消擷取來源中的 JSON 值，即可完成查閱文字。 查閱文字會依原樣比對，而不需進行任何修改。

ValueTextEquals(String)

來源:

Utf8JsonReader.cs

將字串文字與來源中未逸出的 JSON 權杖值進行比較，並傳回指出它們是否相符的值。

public:
 bool ValueTextEquals(System::String ^ text);

public readonly bool ValueTextEquals (string? text);

member this.ValueTextEquals : string -> bool

Public Function ValueTextEquals (text As String) As Boolean

參數

text

String

要比較的文字。

傳回

Boolean

若來源中的 JSON 權杖值符合查閱文字，即為 true；否則為 false。

例外狀況

InvalidOperationException

JSON 權杖不是 JSON 字串 (亦即，它不是 String 或 PropertyName)。

備註

如果查閱文字無效或不完整的 UTF-16 文字 (也就是未配對的 Surrogates) ，則方法會傳回 false ，因為 JSON 承載內不能有不正確 UTF-16。

來源中的 JSON 權杖值比較，並視需要先取消擷取來源中的 JSON 值，即可完成查閱文字。 查閱文字會依原樣比對，而不需進行任何修改。