通过

<udpBinding>

  • 项目

用于配置 UdpBinding 绑定的配置元素。

configuration
  system.serviceModel
    <bindings>
      udpBinding>

语法

<udpBinding>
  <binding closeTimeout="TimeSpan"
           duplicateMessageHistoryLength="Integer"
           maxBufferPoolSize="Integer"
           maxBufferSize="Integer"
           maxPendingMessagesTotalSize="Integer"
           maxReceivedMessageSize="Integer"
           maxRetransmitCount="Integer"
           multicastInterfaceId="Integer"
           name="String"
           openTimeout="TimeSpan"
           receiveTimeout="TimeSpan"
           sendTimeout="TimeSpan"
           textEncoding="UnicodeFffeTextEncoding/Utf16TextEncoding/Utf8TextEncoding"
           timeToLive="TimeSpan">
    <readerQuotas maxArrayLength="Integer"
                  maxBytesPerRead="Integer"
                  maxDepth="Integer"
                  maxNameTableCharCount="Integer"
                  maxStringContentLength="Integer" />
  </binding>
</udpBinding>

特性和元素

下列各节描述了特性、子元素和父元素。

特性

属性 说明
closeTimeout 一个 TimeSpan 值，指定为完成关闭操作提供的时间间隔。 此值应大于或等于 Zero。 默认值为 00:01:00。
duplicateMessageHistoryLength 一个整数值，指定重复消息历史记录长度。
maxBufferPoolSize 一个整数值，指定为从通道接收消息的消息缓冲区管理器分配并供其使用的最大内存量。 默认值为 524288 (0x80000) 字节。
maxBufferSize 一个整数值，指定为采用此绑定配置的终结点处理消息时存储消息的缓冲区的最大大小（字节）。 默认值为 65,536 字节。
maxPendingMessagesTotalSize 一个整数值，指定已经接收但尚未从单个通道实例的输入队列中移除的最大消息数。
maxReceivedMessageSize 一个正整数，定义在采用此绑定配置的通道上可以接收的消息的最大消息大小（字节），包括消息头。 如果消息对于接收方而言太大，则发送方将收到 SOAP 错误。 接收方将删除该消息，并在跟踪日志中创建事件项。 默认值为 65,536 字节。
maxRetransmitCount 一个整数值，指定最大转发消息数。
multicastInterfaceId 一个整数值，指定多播接口 ID。
name 一个包含绑定的配置名称的字符串。 因为此值用作绑定的标识，所以它应该是唯一的。 从 .NET Framework 4 开始，不要求绑定和行为具有名称。 若要详细了解默认配置和无名称的绑定及行为，请参阅简化配置和 WCF 服务的简化配置。
openTimeout 一个 TimeSpan 值，指定为完成打开操作提供的时间间隔。 此值应大于或等于 Zero。 默认值为 00:01:00。
receiveTimeout 一个 TimeSpan 值，指定为完成接收操作提供的时间间隔。 此值应大于或等于 Zero。 默认值为 00:10:00。
sendTimeout 一个 TimeSpan 值，指定为完成发送操作提供的时间间隔。 此值应大于或等于 Zero。 默认值为 00:01:00。
textEncoding 设置要用来在绑定上发出消息的字符集编码。 有效值包括以下值：

- BigEndianUnicode：Unicode BigEndian 编码。
- Unicode：16 位编码。
- UTF8：8 位编码

默认编码为 UTF8。 此属性的类型为 Encoding。
timeToLive 一个时间范围值，指定绑定处于活动状态的时间。

子元素

元素 说明
<readerQuotas> 定义可由采用此绑定配置的终结点进行处理的 SOAP 消息的复杂性约束。 此元素的类型为 XmlDictionaryReaderQuotasElement。

父元素

元素 说明
<bindings> 此元素包含标准绑定和自定义绑定的集合。

备注

UdpBinding 允许 WCF 服务通过 UDP 传输进行通信。 它允许“发后不理”消息交换，即客户端向服务发送一条消息且不期望收到回复。

示例

下面的示例演示如何使用 <udpBinding> 元素配置 UdpBinding。

<udpBinding>
  <binding  closeTimeout="00:10:00"
            duplicateMessageHistoryLength="100"
            maxBufferPoolSize="100"
            maxPendingMessagesTotalSize="100000"
            maxReceivedMessageSize="65536"
            maxRetransmitCount="10"
            multicastInterfaceId="00000"
            name="myUdpBinding"
            openTimeout="00:10:00"
            receiveTimeout="00:10:00"
            sendTimeout="00:10:00"
            textEncoding="utf-8"
            timeToLive="00:10:00">
    <readerQuotas />
  </binding>
</udpBinding>

请参阅