NamespaceManager.BeginCreateQueue Method (String, AsyncCallback, Object)

 

Asynchronous version of CreateQueue.

Namespace:   Microsoft.ServiceBus
Assembly:  Microsoft.ServiceBus (in Microsoft.ServiceBus.dll)

Syntax

public IAsyncResult BeginCreateQueue(
    string path,
    AsyncCallback callback,
    object state
)
public:
IAsyncResult^ BeginCreateQueue(
    String^ path,
    AsyncCallback^ callback,
    Object^ state
)
member BeginCreateQueue : 
        path:string *
        callback:AsyncCallback *
        state:Object -> IAsyncResult
Public Function BeginCreateQueue (
    path As String,
    callback As AsyncCallback,
    state As Object
) As IAsyncResult

Parameters

  • path
    Type: System.String

    The path of the queue relative to the service namespace base address.

  • state
    Type: System.Object

    A user-defined object that contains state information about the asynchronous operation. This object is passed to the EndCreateQueue delegate when the operation is complete.

Return Value

Type: System.IAsyncResult

An IAsyncResult object that references the asynchronous operation to create a queue.

Exceptions

Exception Condition
ArgumentException

path is null or empty.

T:System. ArgumentOutOfRangeException

The length of path is greater than F:Microsoft.ServiceBus.Messaging.Constants.QueueNameMaximumLength.

TimeoutException

The operation times out. The timeout period is initialized through the NamespaceManagerSettings class. You may need to increase the value of the OperationTimeout property to avoid this exception if the timeout value is relatively low.

MessagingEntityAlreadyExistsException

A queue with the same name and path exists under the same service namespace.

UnauthorizedAccessException

The NamespaceManager object does not have sufficient permission to perform this operation. You should check to ensure that your NamespaceManager has the correct P:Microsoft.ServiceBus.NamespaceManagerSettings.Credential credentials to perform this operation.

QuotaExceededException

Either the specified size in the description is not supported or the maximum allowable quota has been reached. You must specify one of the supported size values, delete existing entities, or increase your quota size.

MessagingException

An internal error or unexpected exception occurs.

See Also

BeginCreateQueue Overload
NamespaceManager Class
Microsoft.ServiceBus Namespace

Return to top