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

ServiceBusSender 类

定义

命名空间:

Azure.Messaging.ServiceBus

程序集:

Azure.Messaging.ServiceBus.dll

包:

Azure.Messaging.ServiceBus v7.17.5

负责发送到 ServiceBusMessage 特定服务总线实体 (队列或主题) 的客户端。 它可用于会话实体和非会话实体。 它是通过调用 CreateSender(String)构造的。

public class ServiceBusSender : IAsyncDisposable

type ServiceBusSender = class
    interface IAsyncDisposable

Public Class ServiceBusSender
Implements IAsyncDisposable

继承

Object

ServiceBusSender

实现

IAsyncDisposable

注解

ServiceBusSender可以安全地缓存并在应用程序的生存期内使用，或者直到ServiceBusClient释放它所创建的 。 当应用程序定期或半定期发布消息时，建议缓存发送方。 发送方负责确保高效使用网络、CPU 和内存。 在应用程序关闭时对关联的 ServiceBusClient 调用DisposeAsync()可确保正确清理发送方使用的网络资源和其他非托管对象。

构造函数

ServiceBusSender()	初始化 类的新实例 ServiceBusSender 进行模拟。
ServiceBusSender(ServiceBusClient, String)	初始化 类的新实例， ServiceBusSender 以便与派生类型一起使用。
ServiceBusSender(ServiceBusClient, String, ServiceBusSenderOptions)	初始化 类的新实例， ServiceBusSender 以便与派生类型一起使用。

属性

EntityPath	发送方连接到的实体的路径，特定于包含它的服务总线命名空间。
FullyQualifiedNamespace	与生成者关联的完全限定的服务总线命名空间。 这可能类似于 {yournamespace}.servicebus.windows.net。
Identifier	获取用于标识此客户端的 ID。 这可用于关联日志和异常。
IsClosed	指示是否已关闭。ServiceBusSender

方法

CancelScheduledMessageAsync(Int64, CancellationToken)	取消已计划的消息。
CancelScheduledMessagesAsync(IEnumerable<Int64>, CancellationToken)	取消一组已计划的消息。
CloseAsync(CancellationToken)	执行清理 所使用的 ServiceBusSender资源所需的任务。
CreateMessageBatchAsync(CancellationToken)	创建可以使用 添加到TryAddMessage(ServiceBusMessage)的大小ServiceBusMessage约束批。 如果消息超出批允许的最大大小，则批将不允许添加消息，并使用该消息返回值发出信号。 由于无法添加违反大小约束的消息，因此发布批处理不会在尝试将消息发送到队列/主题时触发异常。
CreateMessageBatchAsync(CreateMessageBatchOptions, CancellationToken)	创建可以使用基于 try 的模式添加到的大小 ServiceBusMessage 约束批。 如果消息超出批允许的最大大小，则批将不允许添加消息，并使用该消息的返回值发出信号。 由于无法添加违反大小约束的消息，因此发布批处理不会在尝试将消息发送到队列/主题时触发异常。
DisposeAsync()	执行清理 所使用的 ServiceBusSender资源所需的任务。 这等效于调用 CloseAsync(CancellationToken)。
ScheduleMessageAsync(ServiceBusMessage, DateTimeOffset, CancellationToken)	计划稍后在服务总线上显示一条消息。
ScheduleMessagesAsync(IEnumerable<ServiceBusMessage>, DateTimeOffset, CancellationToken)	计划稍后在服务总线上显示一组消息。
SendMessageAsync(ServiceBusMessage, CancellationToken)	将消息发送到服务总线的关联实体。
SendMessagesAsync(IEnumerable<ServiceBusMessage>, CancellationToken)	使用批处理方法将一组消息发送到关联的服务总线实体。 如果消息的大小超过单个批的最大大小，则会触发异常，并且发送将失败。 为了确保正在发送的消息适合批处理，请改用 SendMessagesAsync(ServiceBusMessageBatch, CancellationToken) 。
SendMessagesAsync(ServiceBusMessageBatch, CancellationToken)	ServiceBusMessageBatch将包含一组 的 ServiceBusMessage 发送到关联的服务总线实体。