Partager via

<udpBinding>

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

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

Attributes

Caractéristique Descriptif
closeTimeout Valeur TimeSpan qui spécifie l’intervalle de temps fourni pour qu’une opération de fermeture se termine. 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 de l’historique des messages en double.
maxBufferPoolSize Valeur entière qui spécifie la quantité maximale de mémoire allouée pour une utilisation par le gestionnaire des mémoires tampons de messages qui reçoivent des messages du canal. La valeur par défaut est 524288 (0x80000) octets.
maxBufferSize Valeur entière qui spécifie la taille maximale, en octets, d’une mémoire tampon qui stocke les 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, mais pas encore supprimés de la file d’attente 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, pour 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 volumineux pour le récepteur. Le destinataire supprime le message et crée une entrée de l’événement dans le journal des traces. La valeur par défaut est de 65 536 octets.
maxRetransmitCount Valeur entière qui spécifie le nombre maximal de messages retransmis.
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 est utilisée comme identification pour la liaison. À compter de .NET Framework 4, les liaisons et les comportements ne sont pas nécessaires pour avoir un nom. Pour plus d’informations sur la configuration par défaut et les liaisons sans nom et les comportements, consultez Configuration simplifiée et Configuration simplifiée pour les services WCF.
openTimeout Valeur TimeSpan qui spécifie l’intervalle de temps fourni pour qu’une opération ouverte se termine. Cette valeur doit être supérieure ou égale à Zero. La valeur par défaut est 00:01:00.
receiveTimeout Valeur TimeSpan qui spécifie l’intervalle de temps fourni pour qu’une opération de réception se termine. Cette valeur doit être supérieure ou égale à Zero. La valeur par défaut est 00:10:00.
sendTimeout Valeur TimeSpan qui spécifie l’intervalle de temps fourni pour qu’une opération d’envoi se termine. Cette valeur doit être supérieure ou égale à Zero. La valeur par défaut est 00:01:00.
textEncoding Définit l’encodage du jeu de caractères à utiliser pour émettre des messages sur la liaison. Les valeurs valides sont les suivantes :

- BigEndianUnicode : encodage BigEndian Unicode.
- Unicode : encodage 16 bits.
- UTF8 : encodage 8 bits

La valeur par défaut est UTF8. Cet attribut est de type Encoding.
timeToLive Valeur d’intervalle de temps qui spécifie l’heure de vie de la liaison.

Éléments enfants

Élément Descriptif
<readerQuotas> Définit les contraintes relatives à la complexité des messages SOAP qui peuvent ê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 Descriptif
<Liaisons> Cet élément contient une collection de liaisons standard et personnalisées.

Remarques

UdpBinding permet aux services WCF de communiquer via le transport UDP. Il permet d’échanger des messages « fire and forget » où un client envoie un message à un service et attend aucune réponse.

Example

L’exemple suivant montre comment configurer l’utilisation UdpBinding 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>

Voir aussi

  • Last updated on