EventHubProducerClient.SendAsync Método

Definição

Namespace:

Azure.Messaging.EventHubs.Producer

Assembly:

Azure.Messaging.EventHubs.dll

Pacote:

Azure.Messaging.EventHubs v5.11.3

Sobrecargas

SendAsync(EventDataBatch, CancellationToken)	Envia um conjunto de eventos para o Hub de Eventos associado usando uma abordagem em lote.
SendAsync(IEnumerable<EventData>, CancellationToken)	Envia um conjunto de eventos para o Hub de Eventos associado como uma única operação. Para evitar a sobrecarga associada à medição e validação do tamanho no cliente, a validação será delegada ao serviço hubs de eventos e será adiada até que a operação seja invocada. A chamada falhará se o tamanho do conjunto de eventos especificado exceder o tamanho máximo permitido de um único lote.
SendAsync(IEnumerable<EventData>, SendEventOptions, CancellationToken)	Envia um conjunto de eventos para o Hub de Eventos associado como uma única operação. Para evitar a sobrecarga associada à medição e validação do tamanho no cliente, a validação será delegada ao serviço hubs de eventos e será adiada até que a operação seja invocada. A chamada falhará se o tamanho do conjunto de eventos especificado exceder o tamanho máximo permitido de um único lote.

SendAsync(EventDataBatch, CancellationToken)

Origem:

EventHubProducerClient.cs

Envia um conjunto de eventos para o Hub de Eventos associado usando uma abordagem em lote.

public virtual System.Threading.Tasks.Task SendAsync (Azure.Messaging.EventHubs.Producer.EventDataBatch eventBatch, System.Threading.CancellationToken cancellationToken = default);

abstract member SendAsync : Azure.Messaging.EventHubs.Producer.EventDataBatch * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.SendAsync : Azure.Messaging.EventHubs.Producer.EventDataBatch * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Overridable Function SendAsync (eventBatch As EventDataBatch, Optional cancellationToken As CancellationToken = Nothing) As Task

Parâmetros

eventBatch

EventDataBatch

O conjunto de dados de evento a serem enviados. Um lote pode ser criado usando CreateBatchAsync(CancellationToken).

cancellationToken

CancellationToken

Uma instância opcional CancellationToken para sinalizar a solicitação para cancelar a operação.

Retornos

Task

Uma tarefa a ser resolvida quando a operação for concluída; se nenhuma exceção for gerada quando aguardada, o serviço hubs de eventos reconhecerá o recebimento e assumiu a responsabilidade pela entrega do lote.

Exceções

InvalidOperationException

Ocorre quando um identificador de partição e uma chave de partição foram especificados pelo lote.

Comentários

Quando publicado, o resultado é atômico; todos os eventos que pertencem ao lote foram bem-sucedidos ou todos falharam. O sucesso parcial não é possível.

Confira também

• CreateBatchAsync(CancellationToken)

SendAsync(IEnumerable<EventData>, CancellationToken)

Origem:

EventHubProducerClient.cs

Envia um conjunto de eventos para o Hub de Eventos associado como uma única operação. Para evitar a sobrecarga associada à medição e validação do tamanho no cliente, a validação será delegada ao serviço hubs de eventos e será adiada até que a operação seja invocada. A chamada falhará se o tamanho do conjunto de eventos especificado exceder o tamanho máximo permitido de um único lote.

public virtual System.Threading.Tasks.Task SendAsync (System.Collections.Generic.IEnumerable<Azure.Messaging.EventHubs.EventData> eventBatch, System.Threading.CancellationToken cancellationToken = default);

abstract member SendAsync : seq<Azure.Messaging.EventHubs.EventData> * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.SendAsync : seq<Azure.Messaging.EventHubs.EventData> * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Overridable Function SendAsync (eventBatch As IEnumerable(Of EventData), Optional cancellationToken As CancellationToken = Nothing) As Task

Parâmetros

eventBatch

IEnumerable<EventData>

O conjunto de dados de evento a serem enviados.

cancellationToken

CancellationToken

Uma instância opcional CancellationToken para sinalizar a solicitação para cancelar a operação.

Retornos

Task

Uma tarefa a ser resolvida quando a operação for concluída; se nenhuma exceção for gerada quando aguardada, o serviço hubs de eventos reconhecerá o recebimento e assumiu a responsabilidade pela entrega do conjunto de eventos em sua partição.

Exceções

EventHubsException

Ocorre quando o conjunto de eventos excede o tamanho máximo permitido em um único lote, conforme determinado pelo serviço hubs de eventos. O Reason será definido como MessageSizeExceeded neste caso.

SerializationException

Ocorre quando um dos eventos no eventBatch tem um membro na Properties coleção que é um tipo sem suporte para serialização. Confira os Properties comentários para obter detalhes.

Comentários

Quando publicado, o resultado é atômico; todos os eventos que pertencem ao conjunto foram bem-sucedidos ou todos falharam. O sucesso parcial não é possível.

Confira também

• CreateBatchAsync(CancellationToken)
• SendAsync(IEnumerable<EventData>, SendEventOptions, CancellationToken)
• SendAsync(EventDataBatch, CancellationToken)

SendAsync(IEnumerable<EventData>, SendEventOptions, CancellationToken)

Origem:

EventHubProducerClient.cs

Envia um conjunto de eventos para o Hub de Eventos associado como uma única operação. Para evitar a sobrecarga associada à medição e validação do tamanho no cliente, a validação será delegada ao serviço hubs de eventos e será adiada até que a operação seja invocada. A chamada falhará se o tamanho do conjunto de eventos especificado exceder o tamanho máximo permitido de um único lote.

public virtual System.Threading.Tasks.Task SendAsync (System.Collections.Generic.IEnumerable<Azure.Messaging.EventHubs.EventData> eventBatch, Azure.Messaging.EventHubs.Producer.SendEventOptions options, System.Threading.CancellationToken cancellationToken = default);

abstract member SendAsync : seq<Azure.Messaging.EventHubs.EventData> * Azure.Messaging.EventHubs.Producer.SendEventOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.SendAsync : seq<Azure.Messaging.EventHubs.EventData> * Azure.Messaging.EventHubs.Producer.SendEventOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Overridable Function SendAsync (eventBatch As IEnumerable(Of EventData), options As SendEventOptions, Optional cancellationToken As CancellationToken = Nothing) As Task

Parâmetros

eventBatch

IEnumerable<EventData>

O conjunto de dados de evento a serem enviados.

options

SendEventOptions

O conjunto de opções a serem consideradas ao enviar este lote.

cancellationToken

CancellationToken

Uma instância opcional CancellationToken para sinalizar a solicitação para cancelar a operação.

Retornos

Task

Uma tarefa a ser resolvida quando a operação for concluída; se nenhuma exceção for gerada quando aguardada, o serviço hubs de eventos reconhecerá o recebimento e assumiu a responsabilidade pela entrega do conjunto de eventos em sua partição.

Exceções

InvalidOperationException

Ocorre quando um identificador de partição e uma chave de partição foram especificados no options.

EventHubsException

Ocorre quando o conjunto de eventos excede o tamanho máximo permitido em um único lote, conforme determinado pelo serviço hubs de eventos. O Reason será definido como MessageSizeExceeded neste caso.

SerializationException

Ocorre quando um dos eventos no eventBatch tem um membro na Properties coleção que é um tipo sem suporte para serialização. Confira os Properties comentários para obter detalhes.

Comentários

Quando publicado, o resultado é atômico; todos os eventos que pertencem ao conjunto foram bem-sucedidos ou todos falharam. O sucesso parcial não é possível.

Confira também

• CreateBatchAsync(CreateBatchOptions, CancellationToken)
• SendAsync(IEnumerable<EventData>, CancellationToken)
• SendAsync(EventDataBatch, CancellationToken)