CloudQueue.CreateIfNotExistsAsync Method (QueueRequestOptions, OperationContext, CancellationToken) (Microsoft.WindowsAzure.Storage.Queue)

Creates the queue if it does not already exist.

Namespace:   Microsoft.WindowsAzure.Storage.Queue
Assembly:  Microsoft.WindowsAzure.Storage (in Microsoft.WindowsAzure.Storage.dll)

Syntax

C#

Copy Code

 

public virtual Task<bool> CreateIfNotExistsAsync(
	QueueRequestOptions options,
	OperationContext operationContext,
	CancellationToken cancellationToken
)

C++

Copy Code

 

public:
virtual Task<bool>^ CreateIfNotExistsAsync(
	QueueRequestOptions^ options,
	OperationContext^ operationContext,
	CancellationToken cancellationToken
)

F#

Copy Code

 

abstract CreateIfNotExistsAsync : 
        options:QueueRequestOptions *
        operationContext:OperationContext *
        cancellationToken:CancellationToken -> Task<bool>
override CreateIfNotExistsAsync : 
        options:QueueRequestOptions *
        operationContext:OperationContext *
        cancellationToken:CancellationToken -> Task<bool>

VB

Copy Code

 

Public Overridable Function CreateIfNotExistsAsync (
	options As QueueRequestOptions,
	operationContext As OperationContext,
	cancellationToken As CancellationToken
) As Task(Of Boolean)

Parameters

options

Type: Microsoft.WindowsAzure.Storage.Queue.QueueRequestOptionsMicrosoft.WindowsAzure.Storage.Queue::QueueRequestOptions^Microsoft.WindowsAzure.Storage.Queue.QueueRequestOptionsMicrosoft.WindowsAzure.Storage.Queue.QueueRequestOptions

A QueueRequestOptions object that specifies additional options for the request.

operationContext

Type: Microsoft.WindowsAzure.Storage.OperationContextMicrosoft.WindowsAzure.Storage::OperationContext^Microsoft.WindowsAzure.Storage.OperationContextMicrosoft.WindowsAzure.Storage.OperationContext

An OperationContext object that represents the context for the current operation.

cancellationToken

Type: System.Threading.CancellationTokenSystem.Threading::CancellationTokenSystem.Threading.CancellationTokenSystem.Threading.CancellationToken

A CancellationToken to observe while waiting for a task to complete.

Return Value

Type: System.Threading.Tasks.Task<Boolean>System.Threading.Tasks::Task<Boolean>^System.Threading.Tasks.Task<Boolean>System.Threading.Tasks.Task(Of Boolean)

true if the queue did not already exist and was created; otherwise false.

Remarks

This API performs an existence check and therefore requires read permissions.

See Also

CreateIfNotExistsAsync Overload
CloudQueue Class
Microsoft.WindowsAzure.Storage.Queue Namespace

Return to top