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

中转消息属性

发送消息时,你可以指定以下消息属性。 如果发送或接收了单个消息,则这些属性将包含在采用 JSON 编码格式的 BrokerProperties HTTP 标头中。 如果发送了一批消息,则这些属性将包含在 JSON 编码的 HTTP 正文中。 有关详细信息,请参阅 发送消息发送消息批处理

下表列出了 Microsoft.ServiceBus.Messaging.BrokeredMessage 属性。 这些属性可按任意顺序显示。 如果未指定属性,服务总线将使用该属性的默认值。 表中未列出的代理属性将被忽略。 接受的属性与指定 api-version 的值无关。 HTTP 请求中不需要 api-version 说明符。

如果同时设置 SessionIdPartitionKey 属性,则必须将它们设置为相同的值。

属性名称 默认 属性说明
CorrelationId (空) CorrelationId
ForcePersistence false ForcePersistence
Label (空) Label
MessageId (空) MessageId
PartitionKey (空) PartitionKey
ReplyTo (空) ReplyTo
ReplyToSessionId (空) ReplyToSessionId
ScheduledEnqueueTimeUtc (空) ScheduledEnqueueTimeUtc
SessionId (空) SessionId
TimeToLive (空) TimeToLive
功能 (空) To
ViaPartitionKey (空) ViaPartitionKey

除了这些属性外,你还可以指定自定义属性。 如果发送或接收了单个消息,则会将每个自定义属性放置在其自身的 HTTP 标头中。 如果发送了一批消息,则会将自定义属性包含在 JSON 编码的 HTTP 正文中。 有关详细信息,请参阅 发送消息发送消息批处理