TableClient.DeleteEntity Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Overloads
DeleteEntity(ITableEntity, ETag, CancellationToken) |
Deletes the specified table entity. |
DeleteEntity(String, String, ETag, CancellationToken) |
Deletes the specified table entity. |
DeleteEntity(ITableEntity, ETag, CancellationToken)
- Source:
- TableClient.cs
Deletes the specified table entity.
public virtual Azure.Response DeleteEntity (Azure.Data.Tables.ITableEntity entity, Azure.ETag ifMatch = default, System.Threading.CancellationToken cancellationToken = default);
abstract member DeleteEntity : Azure.Data.Tables.ITableEntity * Azure.ETag * System.Threading.CancellationToken -> Azure.Response
override this.DeleteEntity : Azure.Data.Tables.ITableEntity * Azure.ETag * System.Threading.CancellationToken -> Azure.Response
Public Overridable Function DeleteEntity (entity As ITableEntity, Optional ifMatch As ETag = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Response
Parameters
- entity
- ITableEntity
The table entity to delete.
- ifMatch
- ETag
The If-Match value to be used for optimistic concurrency. If All is specified, the operation will be executed unconditionally. If the ETag value is specified, the operation will fail with a status of 412 (Precondition Failed) if the ETag value of the entity in the table does not match. The default is to delete unconditionally.
- cancellationToken
- CancellationToken
A CancellationToken controlling the request lifetime.
Returns
The Response indicating the result of the operation.
Exceptions
The server returned an error. See Message for details returned from the server.
Remarks
Note: This method should not fail because the entity does not exist, however if delete operations are submitted in a TableTransactionAction, the transaction will fail if the entity does not exist.
Applies to
DeleteEntity(String, String, ETag, CancellationToken)
- Source:
- TableClient.cs
Deletes the specified table entity.
public virtual Azure.Response DeleteEntity (string partitionKey, string rowKey, Azure.ETag ifMatch = default, System.Threading.CancellationToken cancellationToken = default);
abstract member DeleteEntity : string * string * Azure.ETag * System.Threading.CancellationToken -> Azure.Response
override this.DeleteEntity : string * string * Azure.ETag * System.Threading.CancellationToken -> Azure.Response
Public Overridable Function DeleteEntity (partitionKey As String, rowKey As String, Optional ifMatch As ETag = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Response
Parameters
- partitionKey
- String
The partitionKey that identifies the table entity.
- rowKey
- String
The rowKey that identifies the table entity.
- ifMatch
- ETag
The If-Match value to be used for optimistic concurrency. If All is specified, the operation will be executed unconditionally. If the ETag value is specified, the operation will fail with a status of 412 (Precondition Failed) if the ETag value of the entity in the table does not match. The default is to delete unconditionally.
- cancellationToken
- CancellationToken
A CancellationToken controlling the request lifetime.
Returns
The Response indicating the result of the operation.
Exceptions
The server returned an error. See Message for details returned from the server.
Remarks
Note: This method should not fail because the entity does not exist, however if delete operations are submitted in a TableTransactionAction, the transaction will fail if the entity does not exist.