JsonElement.ValueEquals Method

Definition

Namespace:

System.Text.Json

Assembly:

System.Text.Json.dll

Overloads

ValueEquals(ReadOnlySpan<Byte>)	Compares the text represented by a UTF8-encoded byte span to the string value of this element.
ValueEquals(ReadOnlySpan<Char>)	Compares a specified read-only character span to the string value of this element.
ValueEquals(String)	Compares a specified string to the string value of this element.

ValueEquals(ReadOnlySpan<Byte>)

Source:

JsonElement.cs

Compares the text represented by a UTF8-encoded byte span to the string value of this element.

C#

public bool ValueEquals(ReadOnlySpan<byte> utf8Text);

Parameters

utf8Text

ReadOnlySpan<Byte>

The UTF-8 encoded text to compare against.

Returns

Boolean

true if the string value of this element has the same UTF-8 encoding as utf8Text; otherwise, false.

Exceptions

InvalidOperationException

This value's ValueKind is not String.

Remarks

This method is functionally equal to doing an ordinal comparison of the string produced by UTF-8 decoding utf8Text with the result of calling GetString(), but avoids creating the string instances.

ValueEquals(ReadOnlySpan<Char>)

Source:

JsonElement.cs

Compares a specified read-only character span to the string value of this element.

C#

public bool ValueEquals(ReadOnlySpan<char> text);

Parameters

text

ReadOnlySpan<Char>

The text to compare against.

Returns

Boolean

true if the string value of this element matches text; otherwise, false.

Exceptions

InvalidOperationException

This value's ValueKind is not String.

Remarks

This method is functionally equal to doing an ordinal comparison of text and the result of calling GetString(), but avoids creating the string instance.

ValueEquals(String)

Source:

JsonElement.cs

Compares a specified string to the string value of this element.

C#

public bool ValueEquals(string? text);

Parameters

text

String

The text to compare against.

Returns

Boolean

true if the string value of this element matches text; otherwise, false.

Exceptions

InvalidOperationException

This value's ValueKind is not String.

Remarks

This method is functionally equal to doing an ordinal comparison of text and the result of calling GetString(), but avoids creating the string instance.