Class Metadata (2.48.0)

public sealed class Metadata : IList<Metadata.Entry>

A collection of metadata entries that can be exchanged during a call. gRPC supports these types of metadata:

Request headersare sent by the client at the beginning of a remote call before any request messages are sent.
Response headersare sent by the server at the beginning of a remote call handler before any response messages are sent.
Response trailersare sent by the server at the end of a remote call along with resulting call status.

Inheritance

Object > Metadata

Namespace

Grpc.Core

Assembly

Grpc.Core.Api.dll

Constructors

Metadata()

public Metadata()

Initializes a new instance of Metadata.

Fields

BinaryHeaderSuffix

public const string BinaryHeaderSuffix = null

All binary headers should have this suffix.

Field Value
Type	Description
`String`

Empty

public static readonly Metadata Empty

An read-only instance of metadata containing no entries.

Field Value
Type	Description
`Metadata`

Properties

Count

public int Count { get; }

IList`1

Property Value
Type	Description
`Int32`

IsReadOnly

public bool IsReadOnly { get; }

IList`1

Property Value
Type	Description
`Boolean`

Item[Int32]

public Metadata.Entry this[int index] { get; set; }

IList`1

Parameter
Name	Description
`index`	`Int32`

Property Value
Type	Description
`Metadata.Entry`

Methods

Add(Metadata.Entry)

public void Add(Metadata.Entry item)

IList`1

Parameter
Name	Description
`item`	`Metadata.Entry`

Add(String, Byte[])

public void Add(string key, byte[] valueBytes)

Adds a new binary-valued metadata entry. See Metadata.Entry constructor for params.

Parameters
Name	Description
`key`	`String`
`valueBytes`	`Byte[]`

Add(String, String)

public void Add(string key, string value)

Adds a new ASCII-valued metadata entry. See Metadata.Entry constructor for params.

Parameters
Name	Description
`key`	`String`
`value`	`String`

Clear()

public void Clear()

IList`1

Contains(Metadata.Entry)

public bool Contains(Metadata.Entry item)

IList`1

Parameter
Name	Description
`item`	`Metadata.Entry`

Returns
Type	Description
`Boolean`

CopyTo(Metadata.Entry[], Int32)

public void CopyTo(Metadata.Entry[] array, int arrayIndex)

IList`1

Parameters
Name	Description
`array`	`Metadata.Entry[]`
`arrayIndex`	`Int32`

Get(String)

public Metadata.Entry Get(string key)

Gets the last metadata entry with the specified key. If there are no matching entries then null is returned.

Parameter
Name	Description
`key`	`String`

Returns
Type	Description
`Metadata.Entry`

GetAll(String)

public IEnumerable<Metadata.Entry> GetAll(string key)

Gets all metadata entries with the specified key.

Parameter
Name	Description
`key`	`String`

Returns
Type	Description
`IEnumerable<Metadata.Entry>`

GetEnumerator()

public IEnumerator<Metadata.Entry> GetEnumerator()

IList`1

Returns
Type	Description
`IEnumerator<Metadata.Entry>`

GetValue(String)

public string? GetValue(string key)

Gets the string value of the last metadata entry with the specified key. If the metadata entry is binary then an exception is thrown. If there are no matching entries then null is returned.

Parameter
Name	Description
`key`	`String`

Returns
Type	Description
`Nullable<String>`

GetValueBytes(String)

public byte[] GetValueBytes(string key)

Gets the bytes value of the last metadata entry with the specified key. If the metadata entry is not binary the string value will be returned as ASCII encoded bytes. If there are no matching entries then null is returned.

Parameter
Name	Description
`key`	`String`

Returns
Type	Description
`Byte[]`

IndexOf(Metadata.Entry)

public int IndexOf(Metadata.Entry item)

IList`1

Parameter
Name	Description
`item`	`Metadata.Entry`

Returns
Type	Description
`Int32`

Insert(Int32, Metadata.Entry)

public void Insert(int index, Metadata.Entry item)

IList`1

Parameters
Name	Description
`index`	`Int32`
`item`	`Metadata.Entry`

Remove(Metadata.Entry)

public bool Remove(Metadata.Entry item)

IList`1

Parameter
Name	Description
`item`	`Metadata.Entry`

Returns
Type	Description
`Boolean`

RemoveAt(Int32)

public void RemoveAt(int index)

IList`1

Parameter
Name	Description
`index`	`Int32`