Utf8JsonReader.ValueTextEquals Метод

Определение

Пространство имен:

System.Text.Json

Сборка:

System.Text.Json.dll

Пакет:

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

Перегрузки

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

Значение true, если значение токена JSON в источнике совпадает с текстом поиска в кодировке UTF-8, в противном случае — значение false.

Исключения

InvalidOperationException

Токен JSON не является строкой JSON (т. е. не String или PropertyName).

Комментарии

Текст подстановки должен быть допустимым текстом UTF-8. В противном случае этот метод может возвращать значение true , если источник имеет токен строки, содержащий недопустимый текст UTF-8, который соответствует.

Сравнение значения токена 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

Значение true, если значение токена JSON в источнике совпадает с текстом поиска, в противном случае — значение false.

Исключения

InvalidOperationException

Токен JSON не является строкой JSON (т. е. не String или PropertyName).

Комментарии

Если текст подстановки является недопустимым или неполным текстом UTF-16 (т. е. непарными суррогатами), метод возвращает значение 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

Значение true, если значение токена JSON в источнике совпадает с текстом поиска, в противном случае — значение false.

Исключения

InvalidOperationException

Токен JSON не является строкой JSON (т. е. не String или PropertyName).

Комментарии

Если текст подстановки является недопустимым или неполным текстом UTF-16 (т. е. непарными суррогатами), метод возвращает значение false , так как в полезных данных JSON нельзя использовать недопустимый UTF-16.

Сравнение значения токена JSON в источнике и текста подстановки выполняется путем предварительного отсояния значения JSON в источнике, если это необходимо. Текст подстановки сопоставляется как есть без каких-либо изменений.