CloudTableClient.BeginCreateTable Method
From Storage Client Library NET API
[This topic is part of the Microsoft Azure Storage Client Library 1.7, which has been deprecated. See Storage Client Library for the latest version.]
Begins an asynchronous operation to create a table.
Begins an asynchronous operation to create 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.BeginCreateTable(tableName, callback, state) |
Syntax
| Visual Basic |
|---|
Public Function BeginCreateTable ( _ tableName As String, _ callback As AsyncCallback, _ state As Object _ ) As IAsyncResult |
| C# |
|---|
public IAsyncResult BeginCreateTable ( string tableName, AsyncCallback callback, Object state ) |
| C++ |
|---|
public: IAsyncResult^ BeginCreateTable ( 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.IAsyncResult
An IAsyncResult that references the asynchronous operation.
Example
The following code example creates a table asynchronously, and handles the error if the table already exists.
| C# | Copy Code |
|---|---|
static void CreateTableAsync(CloudStorageAccount storageAccount)
{
// Create service client for credentialed access to the Table service.
CloudTableClient tableClient =
new CloudTableClient(
storageAccount.TableEndpoint.ToString(),
storageAccount.Credentials);
// Begin the operation to create a new table.
tableClient.BeginCreateTable("Customers", CreateTableAsyncCallback, tableClient);
}
public static void CreateTableAsyncCallback(IAsyncResult result)
{
CloudTableClient tableClient = (CloudTableClient)result.AsyncState;
try
{
// End the operation.
tableClient.EndCreateTable(result);
}
catch (StorageClientException e)
{
Console.WriteLine("Error: {0}", e.Message);
Console.WriteLine("Extended error info: {0} : {1}",
e.ExtendedErrorInformation.ErrorCode,
e.ExtendedErrorInformation.ErrorMessage);
}
}
| |
Remarks
For guidance about valid table names, see the "Table Names" section in Understanding the Table Service Data Model.
Thread Safety
Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.