Partilhar via


TableClient.DeleteEntityAsync(String, String, ETag, CancellationToken) Método

Definição

Exclui a entidade de tabela especificada.

public virtual System.Threading.Tasks.Task<Azure.Response> DeleteEntityAsync (string partitionKey, string rowKey, Azure.ETag ifMatch = default, System.Threading.CancellationToken cancellationToken = default);
abstract member DeleteEntityAsync : string * string * Azure.ETag * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response>
override this.DeleteEntityAsync : string * string * Azure.ETag * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response>
Public Overridable Function DeleteEntityAsync (partitionKey As String, rowKey As String, Optional ifMatch As ETag = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Response)

Parâmetros

partitionKey
String

A partitionKey que identifica a entidade de tabela.

rowKey
String

A rowKey que identifica a entidade de tabela.

ifMatch
ETag

O valor If-Match a ser usado para simultaneidade otimista. Se All for especificado, a operação será executada incondicionalmente. Se o ETag valor for especificado, a operação falhará com um status de 412 (Falha de Pré-condição) se o ETag valor da entidade na tabela não corresponder. O padrão é excluir incondicionalmente.

cancellationToken
CancellationToken

Um CancellationToken que controla o tempo de vida da solicitação.

Retornos

O Response que indica o resultado da operação.

Exceções

O servidor retornou um erro. Consulte Message para obter detalhes retornados do servidor.

Comentários

Observação: esse método não deve falhar porque a entidade não existe, no entanto, se as operações de exclusão forem enviadas em um TableTransactionAction, a transação falhará se a entidade não existir.

Aplica-se a