Show / Hide Table of Contents

    Namespace Grpc.Core

    Classes

    AsyncClientStreamingCall<TRequest, TResponse>

    Return type for client streaming calls.

    AsyncDuplexStreamingCall<TRequest, TResponse>

    Return type for bidirectional streaming calls.

    AsyncServerStreamingCall<TResponse>

    Return type for server streaming calls.

    AsyncStreamReaderExtensions

    Extension methods for IAsyncStreamReader<T>.

    AsyncUnaryCall<TResponse>

    Return type for single request - single response call.

    AuthContext

    Authentication context for a call. AuthContext is the only reliable source of truth when it comes to authenticating calls. Using any other call/context properties for authentication purposes is wrong and inherently unsafe. Note: experimental API that can change or be removed without any prior notice.

    AuthInterceptorContext

    Context for an RPC being intercepted by AsyncAuthInterceptor.

    AuthProperty

    A property of an AuthContext. Note: experimental API that can change or be removed without any prior notice.

    BindServiceMethodAttribute

    Specifies the location of the service bind method for a gRPC service. The bind method is typically generated code and is used to register a service's methods with the server on startup.

    The bind method signature takes a ServiceBinderBase and an optional instance of the service base class, e.g. static void BindService(ServiceBinderBase, GreeterService).

    CallCredentials

    Client-side call credentials. Provide authorization with per-call granularity.

    CallCredentialsConfiguratorBase

    Base class for objects that can consume configuration from CallCredentials objects. Note: experimental API that can change or be removed without any prior notice.

    CallInvoker

    Abstraction of client-side RPC invocation.

    ChannelBase

    Base class for gRPC channel. Channels are an abstraction of long-lived connections to remote servers.

    ChannelCredentials

    Client-side channel credentials. Used for creation of a secure channel.

    ChannelCredentialsConfiguratorBase

    Base class for objects that can consume configuration from CallCredentials objects. Note: experimental API that can change or be removed without any prior notice.

    ClientBase

    Base class for client-side stubs.

    ClientBase.ClientBaseConfiguration

    Represents configuration of ClientBase. The class itself is visible to subclasses, but contents are marked as internal to make the instances opaque. The verbose name of this class was chosen to make name clash in generated code less likely.

    ClientBase<T>

    Generic base class for client-side stubs.

    ContextPropagationOptions

    Options for ContextPropagationToken.

    ContextPropagationToken

    Token for propagating context of server side handlers to child calls. In situations when a backend is making calls to another backend, it makes sense to propagate properties like deadline and cancellation token of the server call to the child call. Underlying gRPC implementation may provide other "opaque" contexts (like tracing context) that are not explicitly accesible via the public C# API, but this token still allows propagating them.

    DeserializationContext

    Provides access to the payload being deserialized when deserializing messages.

    KeyCertificatePair

    Key certificate pair (in PEM encoding).

    LiteClientBase

    Base class for lightweight client-side stubs. All calls are invoked via a CallInvoker. Lite client stubs have no configuration knobs, all configuration is provided by decorating the call invoker. Note: experimental API that can change or be removed without any prior notice.

    Marshaller<T>

    Encapsulates the logic for serializing and deserializing messages.

    Marshallers

    Utilities for creating marshallers.

    Metadata

    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.

    Metadata.Entry

    Metadata entry

    Method<TRequest, TResponse>

    A description of a remote method.

    RpcException

    Thrown when remote procedure call fails. Every RpcException is associated with a resulting Status of the call.

    SerializationContext

    Provides storage for payload when serializing a message.

    ServerCallContext

    Context for a server-side call.

    ServerCallContextExtensions

    Extension methods for ServerCallContext.

    ServerServiceDefinition

    Stores mapping of methods to server call handlers. Normally, the ServerServiceDefinition objects will be created by the BindService factory method that is part of the autogenerated code for a protocol buffers service definition.

    ServerServiceDefinition.Builder

    Builder class for ServerServiceDefinition.

    ServiceBinderBase

    Allows binding server-side method implementations in alternative serving stacks. Instances of this class are usually populated by the BindService method that is part of the autogenerated code for a protocol buffers service definition.

    SslCredentials

    Client-side SSL credentials.

    VerifyPeerContext

    Verification context for VerifyPeerCallback. Note: experimental API that can change or be removed without any prior notice.

    VersionInfo

    Provides info about current version of gRPC. See https://codingforsmarties.wordpress.com/2016/01/21/how-to-version-assemblies-destined-for-nuget/ for rationale about assembly versioning.

    WriteOptions

    Options for write operations.

    Structs

    CallOptions

    Options for calls made by client.

    Status

    Represents RPC result, which consists of StatusCode and an optional detail string.

    Interfaces

    IAsyncStreamReader<T>

    A stream of messages to be read. Messages can be awaited await reader.MoveNext(), that returns true if there is a message available and false if there are no more messages (i.e. the stream has been closed).

    On the client side, the last invocation of MoveNext() either returns false if the call has finished successfully or throws RpcException if call finished with an error. Once the call finishes, subsequent invocations of MoveNext() will continue yielding the same result (returning false or throwing an exception).

    On the server side, MoveNext() does not throw exceptions. In case of a failure, the request stream will appear to be finished (MoveNext will return false) and the CancellationToken associated with the call will be cancelled to signal the failure.

    MoveNext() operations can be cancelled via a cancellation token. Cancelling an individual read operation has the same effect as cancelling the entire call (which will also result in the read operation returning prematurely), but the per-read cancellation tokens passed to MoveNext() only result in cancelling the call if the read operation haven't finished yet.

    IAsyncStreamWriter<T>

    A writable stream of messages.

    IClientStreamWriter<T>

    Client-side writable stream of messages with Close capability.

    IMethod

    A non-generic representation of a remote method.

    IServerStreamWriter<T>

    A writable stream of messages that is used in server-side handlers.

    Enums

    MethodType

    Method types supported by gRPC.

    StatusCode

    Result of a remote procedure call. Based on grpc_status_code from grpc/status.h

    WriteFlags

    Flags for write operations.

    Delegates

    AsyncAuthInterceptor

    Asynchronous authentication interceptor for CallCredentials.

    ClientStreamingServerMethod<TRequest, TResponse>

    Server-side handler for client streaming call.

    DuplexStreamingServerMethod<TRequest, TResponse>

    Server-side handler for bidi streaming call.

    ServerStreamingServerMethod<TRequest, TResponse>

    Server-side handler for server streaming call.

    UnaryServerMethod<TRequest, TResponse>

    Server-side handler for unary call.

    VerifyPeerCallback

    Callback invoked with the expected targetHost and the peer's certificate. If false is returned by this callback then it is treated as a verification failure and the attempted connection will fail. Invocation of the callback is blocking, so any implementation should be light-weight. Note that the callback can potentially be invoked multiple times, concurrently from different threads (e.g. when multiple connections are being created for the same credentials).

    Back to top Generated by DocFX