QueueClient.CreateIfNotExistsAsync Method

Reference

Definition

Namespace:: Azure.Storage.Queues

Assembly:: Azure.Storage.Queues.dll

Package:: Azure.Storage.Queues v12.20.1

Package:: Azure.Storage.Queues v12.21.0-beta.2

Source:: QueueClient.cs

Source:: QueueClient.cs

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.

The CreateIfNotExistsAsync(IDictionary<String,String>, CancellationToken) operation creates a new queue under the specified account. If the queue already exists, it is not changed.

For more information, see Create Queue.

public virtual System.Threading.Tasks.Task<Azure.Response> CreateIfNotExistsAsync (System.Collections.Generic.IDictionary<string,string> metadata = default, System.Threading.CancellationToken cancellationToken = default);

abstract member CreateIfNotExistsAsync : System.Collections.Generic.IDictionary<string, string> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response>
override this.CreateIfNotExistsAsync : System.Collections.Generic.IDictionary<string, string> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response>

Public Overridable Function CreateIfNotExistsAsync (Optional metadata As IDictionary(Of String, String) = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Response)

Parameters

metadata: IDictionary<String,String>

Optional custom metadata to set for this queue.

cancellationToken: CancellationToken

Optional CancellationToken to propagate notifications that the operation should be cancelled.

Returns

Task<Response>

If the queue does not already exist, a Response describing the newly created queue. If the queue already exists, null.

Remarks

A RequestFailedException will be thrown if a failure occurs.

Applies to

Dela via