NamespaceManager.RenameQueueAsync(String, String) Methode

Definition

Namespace:

Microsoft.ServiceBus

Assembly:

Microsoft.ServiceBus.dll

Paket:

WindowsAzure.ServiceBus v6.2.2

Asynchrone Version von RenameQueue(String, String). Dies wird derzeit NICHT mit der Premium Service Bus-SKU unterstützt.

public System.Threading.Tasks.Task<Microsoft.ServiceBus.Messaging.QueueDescription> RenameQueueAsync (string path, string newPath);

member this.RenameQueueAsync : string * string -> System.Threading.Tasks.Task<Microsoft.ServiceBus.Messaging.QueueDescription>

Public Function RenameQueueAsync (path As String, newPath As String) As Task(Of QueueDescription)

Parameter

path

String

Der Pfad zu einer vorhandenen Warteschlange.

newPath

String

Der neue Pfad zur umbenannten Warteschlange.

Gibt zurück

Task<QueueDescription>

Gibt Task<TResult> zurück.

Ausnahmen

ArgumentException

Wird ausgelöst, wenn path NULL oder leer ist.

ArgumentOutOfRangeException

Wird ausgelöst, wenn die Länge von path mehr als 290 Zeichen beträgt.

TimeoutException

Wird ausgelöst, wenn für den Vorgang ein Zeitüberschreitung auftritt. Der Timeoutzeitraum wird über die NamespaceManagerSettings -Klasse initialisiert. Sie können den Wert der OperationTimeout Eigenschaft erhöhen, um diese Ausnahme zu vermeiden, wenn der Timeoutwert relativ niedrig ist.

MessagingEntityNotFoundException

Wird ausgelöst, wenn die Quellwarteschlange mit dem angegebenen Pfad nicht vorhanden ist.

MessagingEntityAlreadyExistsException

Wird ausgelöst, wenn die Zielwarteschlange mit demselben Pfad im selben Namespace vorhanden ist.

UnauthorizedAccessException

Wird ausgelöst, wenn der Client nicht über Anmeldeinformationen zum Ausführen des Vorgangs verfügt.

MessagingException

Wird ausgelöst, wenn ein interner Fehler oder eine unerwartete Ausnahme auftritt.