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.
Namespace
Grpc.CoreAssembly
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.
Empty
public static readonly Metadata Empty
An read-only instance of metadata containing no entries.
Properties
Count
public int Count { get; }
IsReadOnly
public bool IsReadOnly { get; }
Item[Int32]
public
Metadata
.
Entry
this
[
int
index
]
{
get
;
set
;
}
Methods
Add(Metadata.Entry)
public void Add(Metadata.Entry item)
Add(String, Byte[])
public void Add(string key, byte[] valueBytes)
Adds a new binary-valued metadata entry. See Metadata.Entry
constructor for params.
Add(String, String)
public void Add(string key, string value)
Adds a new ASCII-valued metadata entry. See Metadata.Entry
constructor for params.
Clear()
public void Clear()
Contains(Metadata.Entry)
public bool Contains(Metadata.Entry item)
CopyTo(Metadata.Entry[], Int32)
public void CopyTo(Metadata.Entry[] array, int arrayIndex)
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.
GetAll(String)
public IEnumerable<Metadata.Entry> GetAll(string key)
Gets all metadata entries with the specified key.
GetEnumerator()
public IEnumerator<Metadata.Entry> GetEnumerator()
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.
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.
IndexOf(Metadata.Entry)
public int IndexOf(Metadata.Entry item)
Insert(Int32, Metadata.Entry)
public void Insert(int index, Metadata.Entry item)
Remove(Metadata.Entry)
public bool Remove(Metadata.Entry item)
RemoveAt(Int32)
public void RemoveAt(int index)
