<udpBinding>

Article
05/10/2023

Élément de configuration utilisé pour configurer la liaison UdpBinding.

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

Syntaxe

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

Attributs et éléments

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.

Attributs

Attribut	Description
`closeTimeout`	TimeSpan qui spécifie l'intervalle de temps prévu pour la réalisation d'une opération de fermeture. Cette valeur doit être supérieure ou égale à Zero. La valeur par défaut est 00:01:00.
`duplicateMessageHistoryLength`	Valeur entière qui spécifie la longueur d'historique de messages dupliqués.
`maxBufferPoolSize`	Entier qui spécifie la quantité de mémoire maximale allouée pour une utilisation par le gestionnaire de tampons des messages qui reçoivent des messages du canal. La valeur par défaut est de 524 288 (0x80000) octets.
`maxBufferSize`	Entier qui spécifie la taille maximale, en octets, d’une mémoire tampon qui stocke des messages pendant qu’ils sont traités pour un point de terminaison configuré avec cette liaison. La valeur par défaut est de 65 536 octets.
`maxPendingMessagesTotalSize`	Valeur entière qui spécifie le nombre maximal de messages reçus qui n'ont pas encore été supprimés dans la file d'entrée pour une instance de canal individuelle.
`maxReceivedMessageSize`	Entier positif qui définit la taille maximale du message, en octets, y compris les en-têtes d’un message pouvant être reçu sur un canal configuré avec cette liaison. L'expéditeur reçoit une erreur SOAP si le message est trop grand pour le récepteur. Ce dernier dépose le message et crée une entrée d’événement dans le journal de suivi. La valeur par défaut est 65 536 octets.
`maxRetransmitCount`	Valeur entière qui spécifie le nombre maximal de retransmissions de messages.
`multicastInterfaceId`	Valeur entière qui spécifie l'ID d'interface de multidiffusion.
`name`	Chaîne qui contient le nom de configuration de la liaison. Cette valeur doit être unique car elle permet d'identifier la liaison. À partir de .NET Framework 4, les liaisons et les comportements ne sont pas tenus d’avoir un nom. Pour plus d’informations sur la configuration par défaut et sur les liaisons et comportements sans nom, consultez Configuration simplifiée et Configuration simplifiée pour les services WCF.
`openTimeout`	TimeSpan qui spécifie l'intervalle de temps prévu pour la réalisation d'une opération d'ouverture. Cette valeur doit être supérieure ou égale à Zero. La valeur par défaut est 00:01:00.
`receiveTimeout`	TimeSpan qui spécifie l'intervalle de temps prévu pour la réalisation d'une opération de réception. Cette valeur doit être supérieure ou égale à Zero. La valeur par défaut est 00:10:00.
`sendTimeout`	TimeSpan qui spécifie l'intervalle de temps prévu pour la réalisation d'une opération d'envoi. Cette valeur doit être supérieure ou égale à Zero. La valeur par défaut est 00:01:00.
`textEncoding`	Définit l'encodage de jeu de caractères à utiliser pour l'émission de messages sur la liaison. Les valeurs valides sont les suivantes : - BigEndianUnicode : encodage Unicode BigEndian. - Unicode : encodage 16 bits. - UTF8 : encodage 8 bits. La valeur par défaut est UTF-8. Cet attribut est de type Encoding.
`timeToLive`	Une valeur de période qui spécifie la durée de vie de la liaison.

Éléments enfants

Élément	Description
<readerQuotas>	Définit les contraintes sur la complexité des messages SOAP pouvant être traités par les points de terminaison configurés avec cette liaison. Cet élément est de type XmlDictionaryReaderQuotasElement.

Éléments parents

Élément	Description
<bindings>	Cet élément conserve une collection de liaisons standard et personnalisées.

Notes

UdpBinding permet aux services WCF de communiquer sur le transport UDP. Il autorise les échanges de message de type « Fire and Forget » (déclenché et oublié) dans lequel un client envoie un message à un service et n’attend pas de réponse.

Exemple

L’exemple suivant indique comment configurer UdpBinding à l’aide de l’élément <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>