MsmqTransportBindingElement 类

定义

命名空间:

System.ServiceModel.Channels

程序集:

System.ServiceModel.dll

表示绑定元素，该绑定元素用于为使用本机消息队列 (MSMQ) 协议的 Windows Communication Foundation (WCF) 服务指定队列通信属性。

public ref class MsmqTransportBindingElement sealed : System::ServiceModel::Channels::MsmqBindingElementBase

public sealed class MsmqTransportBindingElement : System.ServiceModel.Channels.MsmqBindingElementBase

type MsmqTransportBindingElement = class
    inherit MsmqBindingElementBase

Public NotInheritable Class MsmqTransportBindingElement
Inherits MsmqBindingElementBase

继承

Object

BindingElement

TransportBindingElement

MsmqBindingElementBase

MsmqTransportBindingElement

示例

string queueName = @".\private$\ServiceModelSamples";

if (!MessageQueue.Exists(queueName))
    MessageQueue.Create(queueName, true);

using (ServiceHost serviceHost = new ServiceHost(typeof(CalculatorService)))
{
    BinaryMessageEncodingBindingElement encodingBindingElement = new BinaryMessageEncodingBindingElement();
    MsmqTransportBindingElement transportBindingElement = new MsmqTransportBindingElement();
    CustomBinding binding = new CustomBinding(encodingBindingElement, transportBindingElement);

    serviceHost.AddServiceEndpoint(
        typeof(IQueueCalculator),
        binding,
        "net.msmq://localhost/private/ServiceModelSamples");

    serviceHost.Open();

    // The service can now be accessed.
    Console.WriteLine("The service is ready.");
    Console.WriteLine("Press <ENTER> to terminate service.");
    Console.WriteLine();
    Console.ReadLine();

    // Close the ServiceHost to shutdown the service.
    serviceHost.Close();

注解

使用 MsmqTransportBindingElement，用户可以设置排队信道的属性。 排队信道使用消息队列进行传输。

此绑定元素是消息队列标准绑定 (NetMsmqBinding) 所用的默认绑定元素。

构造函数

MsmqTransportBindingElement()

初始化 MsmqTransportBindingElement 类的新实例。

属性

CustomDeadLetterQueue	获取或设置一个 Uri，过期消息或未能传递的消息将在该 Uri 标识的自定义死信队列中进行发送。 (继承自 MsmqBindingElementBase)
DeadLetterQueue	获取或设置此绑定的 DeadLetterQueue 设置。 (继承自 MsmqBindingElementBase)
Durable	获取或设置一个值，该值指定随此绑定发送的消息是持久的还是可变的。 (继承自 MsmqBindingElementBase)
ExactlyOnce	获取或设置一个值，该值指定随此绑定发送的消息是否具有一次性保证。 (继承自 MsmqBindingElementBase)
ManualAddressing	获取或设置一个值，该值指示是否要求对消息进行手动寻址。 (继承自 TransportBindingElement)
MaxBufferPoolSize	获取或设置传输消息使用的任何缓冲池的最大字节大小。 (继承自 TransportBindingElement)
MaxPoolSize	获取或设置一个整数，该整数指定包含内部消息队列 (MSMQ) 消息对象的池的最大大小。
MaxReceivedMessageSize	获取或设置能接收的最大可允许消息大小（以字节为单位）。 (继承自 TransportBindingElement)
MaxRetryCycles	获取或设置尝试向接收应用程序传递消息的最大重试周期数。 (继承自 MsmqBindingElementBase)
MsmqTransportSecurity	获取与此绑定元素关联的 MsmqTransportSecurity。 (继承自 MsmqBindingElementBase)
QueueTransferProtocol	获取或设置一个枚举值，该值指示此绑定使用的排队信道传输。
ReceiveContextEnabled	获取或设置一个指示是否请求接收上下文行为的值。 (继承自 MsmqBindingElementBase)
ReceiveErrorHandling	获取或设置一个枚举值，该值指定如何处理病毒消息和其他无法调度的消息。 (继承自 MsmqBindingElementBase)
ReceiveRetryCount	获取或设置队列管理器在将消息传输到重试队列前可尝试发送该消息的最大次数。 (继承自 MsmqBindingElementBase)
RetryCycleDelay	获取或设置一个值，该值指定在尝试传递无法传递的消息时，尝试另一个重试周期之前应等待的时间。 (继承自 MsmqBindingElementBase)
Scheme	返回一个 String，它包含此传输绑定元素所用的寻址方案。
TimeToLive	获取或设置一个值，该值指定消息有效的时长。 过了这段时间之后，会根据 DeadLetterQueue 设置将消息放置到死信队列中。 (继承自 MsmqBindingElementBase)
TransactedReceiveEnabled	获取一个值，该值指定是否需要使用事务来接收随此绑定发送的消息。 (继承自 MsmqBindingElementBase)
UseActiveDirectory	返回一个布尔值，该值指示是否应该使用 Active Directory 来转换队列地址。
UseMsmqTracing	获取或设置一个值，该值启用或禁用消息队列 (MSMQ) 内置消息跟踪工具。 (继承自 MsmqBindingElementBase)
UseSourceJournal	获取或设置一个值，该值指示是否应将此绑定处理的消息副本存储到源日记队列中。 (继承自 MsmqBindingElementBase)
ValidityDuration	获取或设置一个值，该值指定由接收上下文功能锁定消息的持续时间。 (继承自 MsmqBindingElementBase)

方法

BuildChannelFactory<TChannel>(BindingContext)	使用提供的上下文生成通道工厂。
BuildChannelListener<TChannel>(BindingContext)	使用提供的上下文生成通道侦听器。
CanBuildChannelFactory<TChannel>(BindingContext)	返回一个布尔值，该值指示是否能够使用提供的上下文生成通道工厂。
CanBuildChannelListener<TChannel>(BindingContext)	返回一个布尔值，该值指示是否能够使用提供的上下文生成通道侦听器。
Clone()	返回绑定元素的复本。
Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetProperty<T>(BindingContext)	在派生类中重写时，为提供的绑定上下文检索指定类型的对象。 (继承自 MsmqBindingElementBase)
GetType()	获取当前实例的 Type。 (继承自 Object)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
ToString()	返回表示当前对象的字符串。 (继承自 Object)

显式接口实现

IPolicyExportExtension.ExportPolicy(MetadataExporter, PolicyConversionContext)	导出有关绑定的自定义策略断言。 (继承自 MsmqBindingElementBase)
IWsdlExportExtension.ExportContract(WsdlExporter, WsdlContractConversionContext)	为协定将自定义 Web 服务描述语言 (WSDL) 元素写入到生成的 WSDL 中。 (继承自 MsmqBindingElementBase)
IWsdlExportExtension.ExportEndpoint(WsdlExporter, WsdlEndpointConversionContext)	为终结点将自定义 Web 服务描述语言 (WSDL) 元素写入到生成的 WSDL 中。 (继承自 MsmqBindingElementBase)