[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.]
Creates a queue. Namespace: Microsoft.WindowsAzure.StorageClient
Assembly: Microsoft.WindowsAzure.StorageClient (in Microsoft.WindowsAzure.StorageClient.dll)
Creates a queue. Namespace: Microsoft.WindowsAzure.StorageClient
Assembly: Microsoft.WindowsAzure.StorageClient (in Microsoft.WindowsAzure.StorageClient.dll)
Usage
| Visual Basic |
|---|
Dim instance As CloudQueue instance.Create |
Syntax
| Visual Basic |
|---|
Public Sub Create |
| C# |
|---|
public void Create () |
| C++ |
|---|
public: void Create () |
| J# |
|---|
| JScript |
|---|
Example
The following code example checks whether the specified queue exists and creates it if it does not.
| C# | Copy Code |
|---|---|
static void CreateQueue(Uri queueEndpoint, string accountName, string accountKey)
{
//Create service client for credentialed access to the Queue service.
CloudQueueClient queueClient = new CloudQueueClient(queueEndpoint,
new StorageCredentialsAccountAndKey(accountName, accountKey));
//Get a reference to a queue in this storage account.
CloudQueue queue = queueClient.GetQueueReference("myqueue");
//Check whether the queue exists, and create it if it does not.
if (!queue.Exists())
{
queue.Create();
}
}
| |
Remarks
You can specify user-defined metadata on the queue at the time that it is created. To specify metadata for the queue, add name-value pairs to the queue's Metadata.
For guidance about valid names for queues and metadata, see Naming Queues and Metadata.
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.