Språk

CborReader.ReadDefiniteLengthTextStringBytes Method

Definition

Reads the next data item as a definite-length UTF-8 text string (major type 3).

public:
 ReadOnlyMemory<System::Byte> ReadDefiniteLengthTextStringBytes();
public ReadOnlyMemory<byte> ReadDefiniteLengthTextStringBytes();
member this.ReadDefiniteLengthTextStringBytes : unit -> ReadOnlyMemory<byte>
Public Function ReadDefiniteLengthTextStringBytes () As ReadOnlyMemory(Of Byte)

Returns

A ReadOnlyMemory<T> view of the raw UTF-8 payload.

Exceptions

The next data item does not have the correct major type.

-or-

The data item is an indefinite-length text string.

The next value has an invalid CBOR encoding.

-or-

There was an unexpected end of CBOR encoding data.

-or-

The next value uses a CBOR encoding that is not valid under the current conformance mode.

Remarks

The returned ReadOnlyMemory<T> is a slice over the reader's input buffer. Callers are responsible for preserving the integrity of the value for as long as it is persisted. When using CborReader in streaming mode, callers are advised to read the value immediately, make a defensive copy, or avoid reusing the same memory across calls to SlideData(ReadOnlyMemory<Byte>, Boolean).

Applies to