Utf8JsonReader.ValueTextEquals Método

Definição

Namespace:

System.Text.Json

Assembly:

System.Text.Json.dll

Sobrecargas

ValueTextEquals(ReadOnlySpan<Byte>)	Compara o texto codificado em UTF-8 em um intervalo de bytes somente leitura com o valor do token JSON sem escape na origem e retorna um valor que indica se eles são correspondentes.
ValueTextEquals(ReadOnlySpan<Char>)	Compara o texto em um intervalo de caracteres somente leitura com o valor do token JSON sem escape na origem e retorna um valor que indica se eles são correspondentes.
ValueTextEquals(String)	Compara o texto da cadeia de caracteres com o valor do token JSON sem escape na origem e retorna um valor que indica se eles são correspondentes.

ValueTextEquals(ReadOnlySpan<Byte>)

Compara o texto codificado em UTF-8 em um intervalo de bytes somente leitura com o valor do token JSON sem escape na origem e retorna um valor que indica se eles são correspondentes.

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

public bool ValueTextEquals (ReadOnlySpan<byte> utf8Text);

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

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

Parâmetros

utf8Text

ReadOnlySpan<Byte>

O texto codificado em UTF-8 a ser comparado.

Retornos

Boolean

true se o valor do token JSON na origem corresponder ao texto de pesquisa codificado em UTF-8; caso contrário, false.

Exceções

InvalidOperationException

O token JSON não é uma cadeia de caracteres JSON (ou seja, não é String nem PropertyName).

Comentários

O texto de pesquisa deve ser texto UTF-8 válido. Caso contrário, esse método poderá retornar true se a origem tiver um token de cadeia de caracteres contendo texto UTF-8 inválido correspondente.

A comparação do valor do token JSON na origem e do texto de pesquisa é feita primeiro desescaping do valor JSON na origem, se necessário. O texto de pesquisa é correspondido como está, sem nenhuma modificação nele.

ValueTextEquals(ReadOnlySpan<Char>)

Compara o texto em um intervalo de caracteres somente leitura com o valor do token JSON sem escape na origem e retorna um valor que indica se eles são correspondentes.

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

public bool ValueTextEquals (ReadOnlySpan<char> text);

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

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

Parâmetros

text

ReadOnlySpan<Char>

O texto para comparação.

Retornos

Boolean

true se o valor do token JSON na origem corresponder ao texto de pesquisa; caso contrário, false.

Exceções

InvalidOperationException

O token JSON não é uma cadeia de caracteres JSON (ou seja, não é String nem PropertyName).

Comentários

Se o texto de pesquisa for um texto UTF-16 inválido ou incompleto (ou seja, substitutos não pagos), o método retornará false , pois você não pode ter UTF-16 inválido dentro do conteúdo JSON.

A comparação do valor do token JSON na origem e do texto de pesquisa é feita primeiro desescaping do valor JSON na origem, se necessário. O texto de pesquisa é correspondido como está, sem nenhuma modificação nele.

ValueTextEquals(String)

Compara o texto da cadeia de caracteres com o valor do token JSON sem escape na origem e retorna um valor que indica se eles são correspondentes.

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

public bool ValueTextEquals (string? text);

public bool ValueTextEquals (string text);

member this.ValueTextEquals : string -> bool

Public Function ValueTextEquals (text As String) As Boolean

Parâmetros

text

String

O texto para comparação.

Retornos

Boolean

true se o valor do token JSON na origem corresponder ao texto de pesquisa; caso contrário, false.

Exceções

InvalidOperationException

O token JSON não é uma cadeia de caracteres JSON (ou seja, não é String nem PropertyName).

Comentários

Se o texto de pesquisa for um texto UTF-16 inválido ou incompleto (ou seja, substitutos não pagos), o método retornará false , pois você não pode ter UTF-16 inválido dentro do conteúdo JSON.

A comparação do valor do token JSON na origem e do texto de pesquisa é feita primeiro desescaping do valor JSON na origem, se necessário. O texto de pesquisa é correspondido como está, sem nenhuma modificação nele.