ServiceBusReceiver.DeadLetterMessageAsync Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Sobrecargas
| DeadLetterMessageAsync(ServiceBusReceivedMessage, IDictionary<String,Object>, CancellationToken) |
Move uma mensagem para a subconsulta de mensagens mortas. |
| DeadLetterMessageAsync(ServiceBusReceivedMessage, String, String, CancellationToken) |
Move uma mensagem para a subconsulta de mensagens mortas. |
| DeadLetterMessageAsync(ServiceBusReceivedMessage, IDictionary<String,Object>, String, String, CancellationToken) |
Move uma mensagem para a subconsulta de mensagens mortas. |
DeadLetterMessageAsync(ServiceBusReceivedMessage, IDictionary<String,Object>, CancellationToken)
- Origem:
- ServiceBusReceiver.cs
Move uma mensagem para a subconsulta de mensagens mortas.
public virtual System.Threading.Tasks.Task DeadLetterMessageAsync (Azure.Messaging.ServiceBus.ServiceBusReceivedMessage message, System.Collections.Generic.IDictionary<string,object> propertiesToModify = default, System.Threading.CancellationToken cancellationToken = default);abstract member DeadLetterMessageAsync : Azure.Messaging.ServiceBus.ServiceBusReceivedMessage * System.Collections.Generic.IDictionary<string, obj> * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.DeadLetterMessageAsync : Azure.Messaging.ServiceBus.ServiceBusReceivedMessage * System.Collections.Generic.IDictionary<string, obj> * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Overridable Function DeadLetterMessageAsync (message As ServiceBusReceivedMessage, Optional propertiesToModify As IDictionary(Of String, Object) = Nothing, Optional cancellationToken As CancellationToken = Nothing) As TaskParâmetros
- message
- ServiceBusReceivedMessage
A ServiceBusReceivedMessage carta morta.
- propertiesToModify
- IDictionary<String,Object>
As propriedades da mensagem a ser modificada durante a migração para a subconsulta.
- cancellationToken
- CancellationToken
Uma instância opcional CancellationToken para sinalizar a solicitação para cancelar a operação.
Retornos
Exceções
- O bloqueio da mensagem expirou ou a mensagem já foi concluída. Isso não se aplica a entidades habilitadas para sessão. O Reason será definido como MessageLockLost neste caso.
- O bloqueio da sessão expirou ou a mensagem já foi concluída. Isso só se aplica a entidades habilitadas para sessão. O Reason será definido como SessionLockLost neste caso.
Comentários
Para receber uma mensagem da fila de mensagens mortas ou transferir a fila de mensagens mortas, defina a SubQueue propriedade como DeadLetter ou TransferDeadLetter ao chamar CreateReceiver(String, ServiceBusReceiverOptions) ou CreateReceiver(String, String, ServiceBusReceiverOptions). Essa operação só pode ser executada quando é definida PeekLockcomo ReceiveMode .
Aplica-se a
DeadLetterMessageAsync(ServiceBusReceivedMessage, String, String, CancellationToken)
- Origem:
- ServiceBusReceiver.cs
Move uma mensagem para a subconsulta de mensagens mortas.
public virtual System.Threading.Tasks.Task DeadLetterMessageAsync (Azure.Messaging.ServiceBus.ServiceBusReceivedMessage message, string deadLetterReason, string deadLetterErrorDescription = default, System.Threading.CancellationToken cancellationToken = default);abstract member DeadLetterMessageAsync : Azure.Messaging.ServiceBus.ServiceBusReceivedMessage * string * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.DeadLetterMessageAsync : Azure.Messaging.ServiceBus.ServiceBusReceivedMessage * string * string * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Overridable Function DeadLetterMessageAsync (message As ServiceBusReceivedMessage, deadLetterReason As String, Optional deadLetterErrorDescription As String = Nothing, Optional cancellationToken As CancellationToken = Nothing) As TaskParâmetros
- message
- ServiceBusReceivedMessage
A ServiceBusReceivedMessage carta morta.
- deadLetterReason
- String
O motivo para enviar mensagens mortas.
- deadLetterErrorDescription
- String
A descrição do erro para enviar mensagens mortas à mensagem.
- cancellationToken
- CancellationToken
Uma instância opcional CancellationToken para sinalizar a solicitação para cancelar a operação.
Retornos
Exceções
- O bloqueio da mensagem expirou ou a mensagem já foi concluída. Isso não se aplica a entidades habilitadas para sessão. O Reason será definido como MessageLockLost neste caso.
- O bloqueio da sessão expirou ou a mensagem já foi concluída. Isso só se aplica a entidades habilitadas para sessão. O Reason será definido como SessionLockLost neste caso.
- O motivo da carta morta ou a descrição do erro de carta morta excederam o comprimento máximo de 4096.
Comentários
Para receber uma mensagem da fila de mensagens mortas ou transferir a fila de mensagens mortas, defina a SubQueue propriedade como DeadLetter ou TransferDeadLetter ao chamar CreateReceiver(String, ServiceBusReceiverOptions) ou CreateReceiver(String, String, ServiceBusReceiverOptions). Essa operação só pode ser executada quando é definida PeekLockcomo ReceiveMode .
Aplica-se a
DeadLetterMessageAsync(ServiceBusReceivedMessage, IDictionary<String,Object>, String, String, CancellationToken)
- Origem:
- ServiceBusReceiver.cs
Move uma mensagem para a subconsulta de mensagens mortas.
public virtual System.Threading.Tasks.Task DeadLetterMessageAsync (Azure.Messaging.ServiceBus.ServiceBusReceivedMessage message, System.Collections.Generic.IDictionary<string,object> propertiesToModify, string deadLetterReason, string deadLetterErrorDescription = default, System.Threading.CancellationToken cancellationToken = default);abstract member DeadLetterMessageAsync : Azure.Messaging.ServiceBus.ServiceBusReceivedMessage * System.Collections.Generic.IDictionary<string, obj> * string * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.DeadLetterMessageAsync : Azure.Messaging.ServiceBus.ServiceBusReceivedMessage * System.Collections.Generic.IDictionary<string, obj> * string * string * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Overridable Function DeadLetterMessageAsync (message As ServiceBusReceivedMessage, propertiesToModify As IDictionary(Of String, Object), deadLetterReason As String, Optional deadLetterErrorDescription As String = Nothing, Optional cancellationToken As CancellationToken = Nothing) As TaskParâmetros
- message
- ServiceBusReceivedMessage
A ServiceBusReceivedMessage carta morta.
- propertiesToModify
- IDictionary<String,Object>
As propriedades da mensagem a ser modificada durante a migração para a subconsulta.
- deadLetterReason
- String
O motivo para enviar mensagens mortas.
- deadLetterErrorDescription
- String
A descrição do erro para enviar mensagens mortas à mensagem.
- cancellationToken
- CancellationToken
Uma instância opcional CancellationToken para sinalizar a solicitação para cancelar a operação.
Retornos
Exceções
- O bloqueio da mensagem expirou ou a mensagem já foi concluída. Isso não se aplica a entidades habilitadas para sessão. O Reason será definido como MessageLockLost neste caso.
- O bloqueio da sessão expirou ou a mensagem já foi concluída. Isso só se aplica a entidades habilitadas para sessão. O Reason será definido como SessionLockLost neste caso.
- O motivo da carta morta ou a exceção de erro de letra morta foram especificados no parâmetro e no dicionário de propriedades.
- O motivo da carta morta ou a descrição do erro de carta morta excederam o comprimento máximo de 4096.
Comentários
Para receber uma mensagem da fila de mensagens mortas ou transferir a fila de mensagens mortas, defina a SubQueue propriedade como DeadLetter ou TransferDeadLetter ao chamar CreateReceiver(String, ServiceBusReceiverOptions) ou CreateReceiver(String, String, ServiceBusReceiverOptions). Essa operação só pode ser executada quando é definida PeekLockcomo ReceiveMode . O motivo da carta morta e a descrição do erro só podem ser especificados por meio dos parâmetros de método ou codificados usando essas propriedades.
Aplica-se a
Azure SDK for .NET
Comentários
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja: https://aka.ms/ContentUserFeedback.
Submeter e ver comentários