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

Definição

Namespace:

Azure.Data.Tables

Assembly:

Azure.Data.Tables.dll

Pacote:

Azure.Data.Tables v12.8.3

Origem:

TableClient.cs

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

Task<Response>

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

Exceções

RequestFailedException

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.