Utf8JsonReader.ValueTextEquals 方法

定義

命名空間:

System.Text.Json

組件:

System.Text.Json.dll

套件:

System.Text.Json v11.0.0-preview.7.26381.103

多載

名稱	Description
ValueTextEquals(ReadOnlySpan<Byte>)	將只讀位元組區間的 UTF-8 編碼文字與原始碼中未逃脫的 JSON token 值比較，並回傳一個表示兩者是否相符的值。
ValueTextEquals(ReadOnlySpan<Char>)	將只讀字元區間的文字與原始碼中未跳脫的 JSON token 值比較，並回傳一個表示兩者是否相符的值。
ValueTextEquals(String)	將字串文字與原始碼中未跳脫的 JSON token 值比較，並回傳一個表示是否相符的值。

ValueTextEquals(ReadOnlySpan<Byte>)

來源:

Utf8JsonReader.cs

將只讀位元組區間的 UTF-8 編碼文字與原始碼中未逃脫的 JSON token 值比較，並回傳一個表示兩者是否相符的值。

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

true如果來源中的 JSON 標記值與 UTF-8 編碼的查找文字相符;否則，。 false

例外狀況

InvalidOperationException

JSON 標記不是 JSON 字串（也就是說，它不是 String JSON PropertyName或）。

備註

查詢文字必須是有效的 UTF-8 文字。 否則，若來源有包含無效 UTF-8 文字的字串標記且匹配，此方法可能會回傳 true 。

如果需要，將原始碼中的 JSON token 值與查找文字進行比較，會先從原始碼中解脫 JSON 值來完成。 查詢文字是原樣匹配的，沒有任何修改。

ValueTextEquals(ReadOnlySpan<Char>)

來源:

Utf8JsonReader.cs

將只讀字元區間的文字與原始碼中未跳脫的 JSON token 值比較，並回傳一個表示兩者是否相符的值。

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

true如果原始碼中的 JSON 標記值與查詢文字相符;否則，。 false

例外狀況

InvalidOperationException

JSON 標記不是 JSON 字串（也就是說，它不是 String JSON PropertyName或）。

備註

如果查詢文字是無效或不完整的 UTF-16 文字（即未配對的替代），該方法會回傳 false ，因為 JSON 有效載荷中不可能有無效的 UTF-16。

如果需要，將原始碼中的 JSON token 值與查找文字進行比較，會先從原始碼中解脫 JSON 值來完成。 查詢文字是原樣匹配的，沒有任何修改。

ValueTextEquals(String)

來源:

Utf8JsonReader.cs

將字串文字與原始碼中未跳脫的 JSON token 值比較，並回傳一個表示是否相符的值。

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

true如果原始碼中的 JSON 標記值與查詢文字相符;否則，。 false

例外狀況

InvalidOperationException

JSON 標記不是 JSON 字串（也就是說，它不是 String JSON PropertyName或）。

備註

如果查詢文字是無效或不完整的 UTF-16 文字（即未配對的替代），該方法會回傳 false ，因為 JSON 有效載荷中不可能有無效的 UTF-16。

如果需要，將原始碼中的 JSON token 值與查找文字進行比較，會先從原始碼中解脫 JSON 值來完成。 查詢文字是原樣匹配的，沒有任何修改。