Partilhar via

<udpBinding>

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

<configuração>
   <system.serviceModel>
     <Encadernações>
       <udpBinding>

Sintaxe

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

Attributes

Attribute Description
closeTimeout Um TimeSpan valor que especifica o intervalo de tempo fornecido para a conclusão de uma operação de fechamento. Este valor deve ser maior ou igual a Zero. O padrão é 00:01:00.
duplicateMessageHistoryLength Um valor inteiro que especifica o comprimento do histórico duplicado da mensagem.
maxBufferPoolSize Um valor inteiro que especifica a quantidade máxima de memória alocada para uso pelo gestor dos buffers de mensagens que recebem mensagens do canal. O valor padrão é 524288 (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 endpoint configurado com esta ligação. O valor padrão é 65.536 bytes.
maxPendingMessagesTotalSize Um valor inteiro que especifica o número máximo de mensagens recebidas mas ainda não removidas da fila de entrada para 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 num canal configurado com esta ligação. O emissor recebe uma falha SOAP se a mensagem for demasiado grande para o recetor. O recetor elimina a mensagem e cria uma entrada do evento no registo de rastreamento. O padrão é 65.536 bytes.
maxRetransmitCount Um valor inteiro que especifica o número máximo de mensagens retransmitidas.
multicastInterfaceId Um valor inteiro que especifica o ID da interface multicast.
name Uma cadeia que contém o nome da configuração da ligação. Este valor deve ser único porque é usado como identificação da ligação. A partir do .NET Framework 4, os bindings e comportamentos não são obrigatórios de ter um nome. Para mais informações sobre configuração padrão e ligações e comportamentos sem nome, consulte Configuração Simplificada e Configuração Simplificada para Serviços WCF.
openTimeout Um TimeSpan valor que especifica o intervalo de tempo previsto para que uma operação aberta seja concluída. Este valor deve ser maior ou igual a Zero. O padrão é 00:01:00.
receiveTimeout Um TimeSpan valor que especifica o intervalo de tempo fornecido para a conclusão de uma operação de receção. Este valor deve ser maior ou igual a Zero. O padrão é 00:10:00.
sendTimeout Um TimeSpan valor que especifica o intervalo de tempo fornecido para que uma operação de envio seja concluída. Este valor deve ser maior ou igual a Zero. O padrão é 00:01:00.
textEncoding Define a codificação do conjunto de caracteres para ser usada para emitir mensagens na ligaçã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. Este atributo é do tipo Encoding.
timeToLive Um valor de intervalo de tempo que especifica o tempo de vida da ligação.

Elementos filho

Elemento Description
<LeitorQuotas> Define as restrições à complexidade das mensagens SOAP que podem ser processadas pelos endpoints configurados com esta ligação. Este elemento é do tipo XmlDictionaryReaderQuotasElement.

Elementos Principais

Elemento Description
<Encadernações> Este elemento contém uma coleção de encadernações padrão e personalizadas.

Observações

O UdpBinding permite que os serviços WCF comuniquem através do transporte UDP. Permite trocas de mensagens de "disparar e esquecer", onde um cliente envia uma mensagem para um serviço e não espera resposta.

Example

O exemplo seguinte mostra como configurar o UdpBinding usando o <udpBinding> elemento.

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

Consulte também

  • Last updated on