<udpBinding>

Artigo
05/10/2023

Um elemento de configuração usado para configurar a associação UdpBinding.

<configuration>
  <system.serviceModel>
    <bindings>
      <udpBinding>

Syntax

<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>

Atributos e elementos

As seções a seguir descrevem atributos, elementos filho e elementos pai.

Atributos

Atributo	Descrição
`closeTimeout`	Um valor TimeSpan que especifica o intervalo de tempo para a conclusão de uma operação de fechamento. Esse valor deve ser igual ou superior a Zero. O padrão é 00:01:00.
`duplicateMessageHistoryLength`	Um valor inteiro que especifica o comprimento duplicado do histórico de mensagens.
`maxBufferPoolSize`	Um valor inteiro que especifica a quantidade máxima de memória alocada para uso pelo gerenciador dos buffers de mensagens que recebem mensagens do canal. O valor padrão é 524.288 (0x80000) bytes.
`maxBufferSize`	Um valor inteiro que especifica o tamanho máximo, em bytes, de um buffer que armazena mensagens enquanto são processadas para um ponto de extremidade configurado com essa associação. O valor padrão é 65.536 bytes.
`maxPendingMessagesTotalSize`	Um valor inteiro que especifica o número máximo de mensagens que foram recebidas, mas ainda não foram removidas da fila de entrada de uma instância de canal individual.
`maxReceivedMessageSize`	Um inteiro positivo que define o tamanho máximo da mensagem, em bytes, incluindo cabeçalhos, para uma mensagem que pode ser recebida em um canal configurado com essa associação. O remetente receberá uma falha SOAP se a mensagem for muito grande para o destinatário. O destinatário remove a mensagem e cria uma entrada do evento no log de rastreamento. O padrão é de 65.536 bytes.
`maxRetransmitCount`	Um valor inteiro que especifica o número máxima de retransmissões de mensagens.
`multicastInterfaceId`	Um valor inteiro que especifica a ID da interface multicast.
`name`	Uma cadeia de caracteres que contém o nome de configuração da associação. Esse valor deve ser exclusivo, pois é usado como uma identificação para a associação. A partir do .NET Framework 4, associações e comportamentos não precisam ter um nome. Para obter mais informações sobre a configuração padrão e as associações sem nome, incluindo os comportamentos, confira Configuração Simplificada e Configuração Simplificada para Serviços WCF.
`openTimeout`	Um valor TimeSpan que especifica o intervalo de tempo fornecido para a conclusão de uma operação de abertura. Esse valor deve ser igual ou superior a Zero. O padrão é 00:01:00.
`receiveTimeout`	Um valor TimeSpan que especifica o intervalo de tempo para a conclusão de uma operação de recebimento. Esse valor deve ser igual ou superior a Zero. O padrão é 00:10:00.
`sendTimeout`	Um valor TimeSpan que especifica o intervalo de tempo fornecido para a conclusão de uma operação de envio. Esse valor deve ser igual ou superior a Zero. O padrão é 00:01:00.
`textEncoding`	Define a codificação de conjunto de caracteres a ser usada para emitir mensagens na associação. Os valores válidos incluem os seguintes: − BigEndianUnicode: codificação Unicode BigEndian. – Unicode: codificação de 16 bits. − UTF8: codificação de 8 bits O padrão é UTF8. Esse atributo é do tipo Encoding.
`timeToLive`	Um valor de intervalo de tempo que especifica o tempo de vida da associação.

Elementos filho

Elemento	Descrição
<readerQuotas>	Define as restrições sobre a complexidade das mensagens SOAP que podem ser processadas pelos pontos de extremidade configurados com essa associação. Esse elemento é do tipo XmlDictionaryReaderQuotasElement.

Elementos pai

Elemento	Descrição
<bindings>	Esse elemento contém uma coleção de associações padrão e personalizadas.

Comentários

O UdpBinding permite que os serviços do WCF se comuniquem pelo transporte UDP. Ele permite trocas de mensagens "disparar e esquecer" em que um cliente envia uma mensagem para um serviço e não espera resposta de volta.

Exemplo

O exemplo a seguir mostra como configurar o UdpBinding usando o elemento <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>

Compartilhar via