Class MessageExtensions (3.15.8)

public static class MessageExtensions : object

Extension methods on IMessage and IMessage<T>.

Inheritance

Object > MessageExtensions

Namespace

Google.Protobuf

Assembly

Google.Protobuf.dll

Methods

IsInitialized(IMessage)

public static bool IsInitialized(this IMessage message)

Checks if all required fields in a message have values set. For proto3 messages, this returns true

Parameter
NameDescription
messageIMessage
Returns
TypeDescription
Boolean

MergeDelimitedFrom(IMessage, Stream)

public static void MergeDelimitedFrom(this IMessage message, Stream input)

Merges length-delimited data from the given stream into an existing message.

Parameters
NameDescription
messageIMessage

The message to merge the data into.

inputStream

Stream containing the data to merge, which must be protobuf-encoded binary data.

Remarks

The stream is expected to contain a length and then the data. Only the amount of data specified by the length will be consumed.

MergeFrom(IMessage, ByteString)

public static void MergeFrom(this IMessage message, ByteString data)

Merges data from the given byte string into an existing message.

Parameters
NameDescription
messageIMessage

The message to merge the data into.

dataByteString

The data to merge, which must be protobuf-encoded binary data.

MergeFrom(IMessage, Stream)

public static void MergeFrom(this IMessage message, Stream input)

Merges data from the given stream into an existing message.

Parameters
NameDescription
messageIMessage

The message to merge the data into.

inputStream

Stream containing the data to merge, which must be protobuf-encoded binary data.

MergeFrom(IMessage, Byte[])

public static void MergeFrom(this IMessage message, byte[] data)

Merges data from the given byte array into an existing message.

Parameters
NameDescription
messageIMessage

The message to merge the data into.

dataByte[]

The data to merge, which must be protobuf-encoded binary data.

MergeFrom(IMessage, Byte[], Int32, Int32)

public static void MergeFrom(this IMessage message, byte[] data, int offset, int length)

Merges data from the given byte array slice into an existing message.

Parameters
NameDescription
messageIMessage

The message to merge the data into.

dataByte[]

The data containing the slice to merge, which must be protobuf-encoded binary data.

offsetInt32

The offset of the slice to merge.

lengthInt32

The length of the slice to merge.

ToByteArray(IMessage)

public static byte[] ToByteArray(this IMessage message)

Converts the given message into a byte array in protobuf encoding.

Parameter
NameDescription
messageIMessage

The message to convert.

Returns
TypeDescription
Byte[]

The message data as a byte array.

ToByteString(IMessage)

public static ByteString ToByteString(this IMessage message)

Converts the given message into a byte string in protobuf encoding.

Parameter
NameDescription
messageIMessage

The message to convert.

Returns
TypeDescription
ByteString

The message data as a byte string.

WriteDelimitedTo(IMessage, Stream)

public static void WriteDelimitedTo(this IMessage message, Stream output)

Writes the length and then data of the given message to a stream.

Parameters
NameDescription
messageIMessage

The message to write.

outputStream

The output stream to write to.

WriteTo(IMessage, IBufferWriter<Byte>)

public static void WriteTo(this IMessage message, IBufferWriter<byte> output)

Writes the given message data to the given buffer writer in protobuf encoding.

Parameters
NameDescription
messageIMessage

The message to write to the stream.

outputIBufferWriter<Byte>

The stream to write to.

WriteTo(IMessage, Span<Byte>)

public static void WriteTo(this IMessage message, Span<byte> output)

Writes the given message data to the given span in protobuf encoding. The size of the destination span needs to fit the serialized size of the message exactly, otherwise an exception is thrown.

Parameters
NameDescription
messageIMessage

The message to write to the stream.

outputSpan<Byte>

The span to write to. Size must match size of the message exactly.

WriteTo(IMessage, Stream)

public static void WriteTo(this IMessage message, Stream output)

Writes the given message data to the given stream in protobuf encoding.

Parameters
NameDescription
messageIMessage

The message to write to the stream.

outputStream

The stream to write to.