<udpBinding>

Artikel
07/07/2023

Een configuratie-element dat wordt gebruikt om de UdpBinding binding te configureren.

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

Kenmerken en elementen

In de volgende secties worden kenmerken, onderliggende elementen en bovenliggende elementen beschreven.

Kenmerken

Kenmerk	Beschrijving
`closeTimeout`	Een TimeSpan waarde die het opgegeven tijdsinterval aangeeft voor het voltooien van een close-bewerking. Deze waarde moet groter zijn dan of gelijk zijn aan Zero. De standaardwaarde is 00:01:00.
`duplicateMessageHistoryLength`	Een geheel getal dat de dubbele lengte van de berichtgeschiedenis aangeeft.
`maxBufferPoolSize`	Een geheel getal dat de maximale hoeveelheid geheugen aangeeft die is toegewezen voor gebruik door de manager van de berichtbuffers die berichten van het kanaal ontvangen. De standaardwaarde is 524288 (0x80000) bytes.
`maxBufferSize`	Een geheel getal dat de maximale grootte, in bytes, aangeeft van een buffer die berichten opslaat terwijl ze worden verwerkt voor een eindpunt dat is geconfigureerd met deze binding. De standaardwaarde is 65.536 bytes.
`maxPendingMessagesTotalSize`	Een geheel getal dat het maximum aantal berichten aangeeft dat wordt ontvangen, maar nog niet is verwijderd uit de invoerwachtrij voor een afzonderlijk kanaalexemplaren.
`maxReceivedMessageSize`	Een positief geheel getal dat de maximale berichtgrootte definieert, in bytes, inclusief headers, voor een bericht dat kan worden ontvangen op een kanaal dat is geconfigureerd met deze binding. De afzender ontvangt een SOAP-fout als het bericht te groot is voor de ontvanger. De ontvanger verwijdert het bericht en maakt een vermelding van de gebeurtenis in het traceringslogboek. De standaardwaarde is 65.536 bytes.
`maxRetransmitCount`	Een geheel getal dat het maximum aantal opnieuw verzonden berichten aangeeft.
`multicastInterfaceId`	Een geheel getal dat de multicast-interface-id aangeeft.
`name`	Een tekenreeks die de configuratienaam van de binding bevat. Deze waarde moet uniek zijn omdat deze wordt gebruikt als identificatie voor de binding. Vanaf .NET Framework 4 zijn bindingen en gedrag niet vereist om een naam te hebben. Zie Vereenvoudigde configuratie en Vereenvoudigde configuratie voor WCF-services voor meer informatie over standaardconfiguratie en naamloze bindingen en gedrag.
`openTimeout`	Een TimeSpan waarde die het tijdsinterval aangeeft dat een open bewerking moet worden voltooid. Deze waarde moet groter zijn dan of gelijk zijn aan Zero. De standaardwaarde is 00:01:00.
`receiveTimeout`	Een TimeSpan waarde die het opgegeven tijdsinterval aangeeft voor het voltooien van een ontvangstbewerking. Deze waarde moet groter zijn dan of gelijk zijn aan Zero. De standaardwaarde is 00:10:00.
`sendTimeout`	Een TimeSpan waarde die het tijdsinterval aangeeft dat een verzendbewerking moet worden voltooid. Deze waarde moet groter zijn dan of gelijk zijn aan Zero. De standaardwaarde is 00:01:00.
`textEncoding`	Hiermee stelt u de tekensetcodering in die moet worden gebruikt voor het verzenden van berichten op de binding. Geldige waarden zijn onder andere: - BigEndianUnicode: Unicode BigEndian-codering. - Unicode: 16-bits codering. - UTF8: 8-bits codering De standaardwaarde is UTF8. Dit kenmerk is van het type Encoding.
`timeToLive`	Een tijdspannewaarde die de time to live voor de binding aangeeft.

Onderliggende elementen

Element	Beschrijving
<lezerQuota's>	Definieert de beperkingen voor de complexiteit van SOAP-berichten die kunnen worden verwerkt door eindpunten die met deze binding zijn geconfigureerd. Dit element is van het type XmlDictionaryReaderQuotasElement.

Bovenliggende elementen

Element	Beschrijving
<Bindings>	Dit element bevat een verzameling standaard- en aangepaste bindingen.

Opmerkingen

Met de UdpBinding kunnen WCF-services communiceren via het UDP-transport. Het maakt het mogelijk om berichten uit te wisselen waarbij een client een bericht naar een service verzendt en geen reactie verwacht.

Voorbeeld

In het volgende voorbeeld ziet u hoe u de UdpBinding configureert met behulp van het <udpBinding> -element.

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

Delen via