你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

ServiceBusAdministrationClient.DeleteQueueAsync 方法

定义

命名空间:

Azure.Messaging.ServiceBus.Administration

程序集:

Azure.Messaging.ServiceBus.dll

包:

Azure.Messaging.ServiceBus v7.17.5

Source:

ServiceBusAdministrationClient.cs

删除名称相对于服务命名空间基址描述的队列。

public virtual System.Threading.Tasks.Task<Azure.Response> DeleteQueueAsync (string name, System.Threading.CancellationToken cancellationToken = default);

abstract member DeleteQueueAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response>
override this.DeleteQueueAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response>

Public Overridable Function DeleteQueueAsync (name As String, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Response)

参数

name

String

相对于服务命名空间基址的队列名称。

cancellationToken

CancellationToken

一个可选 CancellationToken 实例，用于发出取消操作的请求信号。

返回

Task<Response>

例外

ServiceTimeout

操作超时。超时期限是通过 ServiceBusAdministrationClientOptions 类初始化的 (请参阅 retry 属性) 。 如果超时值相对较低，可能需要增加超时值以避免此异常。

MessagingEntityNotFound

具有此名称的队列不存在。

ServiceBusy

服务器繁忙。 在重试操作之前，应等待。

ArgumentNullException

队列名称为 null 或空。

ArgumentOutOfRangeException

队列名称超出了允许的最大长度。

ArgumentException

否则，队列名称无效。

UnauthorizedAccessException

权限不足，无法执行此操作。 应检查，以确保具有ServiceBusAdministrationClient执行此操作所需的声明。 https://docs.microsoft.com/azure/service-bus-messaging/service-bus-sas#rights-required-for-service-bus-operations

ServiceBusException

• 找不到指定的实体。 在这种情况下， Reason 将设置为 MessagingEntityNotFound 。
• 操作超时。在这种情况下， Reason 将设置为 ServiceTimeout 。
• 服务器繁忙。 在重试操作之前，应等待。 在这种情况下，失败原因将设置为 ServiceBusy 。
• 发生内部错误或意外异常。 在这种情况下，失败原因将设置为 GeneralError 。