Share via


<udpBinding>

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

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

Syntaxis

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

Attributes

Attribute Description
closeTimeout Een TimeSpan waarde die het tijdsinterval aangeeft dat is opgegeven voor een sluitingsbewerking die moet worden voltooid. Deze waarde moet groter 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 wordt toegewezen voor gebruik door de manager van de berichtbuffers die berichten ontvangen van het kanaal. De standaardwaarde is 524288 (0x80000) bytes.
maxBufferSize Een geheel getal dat de maximale grootte, in bytes, aangeeft van een buffer waarin berichten worden opgeslagen 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 kopteksten, 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 laat het bericht vallen en maakt een vermelding van de gebeurtenis in het traceerlogboek. 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 hoeven bindingen en gedragingen geen 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 geopende bewerking moet worden voltooid. Deze waarde moet groter dan of gelijk zijn aan Zero. De standaardwaarde is 00:01:00.
receiveTimeout Een TimeSpan waarde die het tijdsinterval aangeeft dat een ontvangstbewerking moet worden voltooid. Deze waarde moet groter 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 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 waarmee de tijdsduur voor de binding wordt opgegeven.

Kind-elementen

Onderdeel Description
<readerQuotas> 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

Onderdeel Description
<Bindings> Dit element bevat een verzameling standaard- en aangepaste bindingen.

Opmerkingen

Met de UdpBinding kunnen WCF-services communiceren via het UDP-transport. Hiermee kunnen berichten worden uitgewisseld waarbij een client een bericht naar een service verzendt en geen reactie verwacht.

Example

In het volgende voorbeeld ziet u hoe u het gebruik van het UdpBinding<udpBinding> element configureert.

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

Zie ook