Begins an asynchronous operation to delete a table. Namespace: Microsoft.WindowsAzure.StorageClient
Assembly: Microsoft.WindowsAzure.StorageClient (in Microsoft.WindowsAzure.StorageClient.dll)
Usage
| Visual Basic |
|---|
Dim instance As CloudTableClient Dim tableName As String Dim callback As AsyncCallback Dim state As Object Dim returnValue As IAsyncResult returnValue = instance.BeginDeleteTable(tableName, callback, state) |
Syntax
| Visual Basic |
|---|
Public Function BeginDeleteTable ( _ tableName As String, _ callback As AsyncCallback, _ state As Object _ ) As IAsyncResult |
| C# |
|---|
public IAsyncResult BeginDeleteTable ( string tableName, AsyncCallback callback, Object state ) |
| C++ |
|---|
public: IAsyncResult^ BeginDeleteTable ( String^ tableName, AsyncCallback^ callback, Object^ state ) |
| J# |
|---|
| JScript |
|---|
Parameters
- tableName
Type: System.String
The table name.
- Callback
Type: System.AsyncCallback
The callback delegate that will receive notification when the asynchronous operation completes.
- State
Type: System.Object
A user-defined object that will be passed to the callback delegate.
Return Value
Type: System.IAsyncResultAn IAsyncResult that references the asynchronous request.Example
The following code example deletes a table asynchronously.
| C# | Copy Code |
|---|---|
public static void DeleteTableAsync(CloudStorageAccount storageAccount)
{
// Create service client for credentialed access to the Table service.
CloudTableClient tableClient =
new CloudTableClient(
storageAccount.TableEndpoint.ToString(),
storageAccount.Credentials);
tableClient.BeginDeleteTable(
"Categories", DeleteTableAsyncCallback, tableClient);
}
public static void DeleteTableAsyncCallback(IAsyncResult result)
{
CloudTableClient tableClient = (CloudTableClient)result.AsyncState;
try
{
// End the operation.
tableClient.EndDeleteTable(result);
}
catch (StorageClientException e)
{
Console.WriteLine("Error: {0}", e.Message);
Console.WriteLine("Extended error info: {0} : {1}",
e.ExtendedErrorInformation.ErrorCode,
e.ExtendedErrorInformation.ErrorMessage);
}
}
| |
Remarks
When a table is successfully deleted, it is immediately marked for deletion and is no longer accessible to clients. The table is later removed from the Table service during garbage collection.
Note that deleting a table is likely to take at least 40 seconds to complete. If an operation is attempted against the table while it was being deleted, a StorageClientException is thrown, with additional error information indicating that the table is being deleted.