<udpBinding>

Konfigurační prvek použitý ke konfiguraci vazby 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>

Atributy a prvky

Následující části popisují atributy, podřízené prvky a nadřazené prvky.

Attributes

Vlastnost Description
closeTimeout Hodnota TimeSpan , která určuje časový interval zadaný pro dokončení operace uzavření. Tato hodnota by měla být větší nebo rovna Zero. Výchozí hodnota je 00:01:00.
duplicateMessageHistoryLength Celočíselná hodnota, která určuje délku historie duplicitních zpráv.
maxBufferPoolSize Celočíselná hodnota, která určuje maximální množství paměti přidělené pro použití správcem vyrovnávacích pamětí zpráv, které přijímají zprávy z kanálu. Výchozí hodnota je 524288 (0x80000) bajtů.
maxBufferSize Celočíselná hodnota, která určuje maximální velikost vyrovnávací paměti, která ukládá zprávy během jejich zpracování pro koncový bod nakonfigurovaný touto vazbou. Výchozí hodnota je 65 536 bajtů.
maxPendingMessagesTotalSize Celočíselná hodnota, která určuje maximální počet přijatých zpráv, ale dosud neodebraných ze vstupní fronty pro instanci jednotlivých kanálů.
maxReceivedMessageSize Kladné celé číslo, které definuje maximální velikost zprávy v bajtech, včetně hlaviček, pro zprávu, kterou lze přijímat v kanálu nakonfigurovaného s touto vazbou. Odesílatel obdrží chybu SOAP, pokud je zpráva pro příjemce příliš velká. Příjemce zprávu zahodí a vytvoří záznam události v protokolu trasování. Výchozí hodnota je 65 536 bajtů.
maxRetransmitCount Celočíselná hodnota, která určuje maximální počet opakovaných přenosů zpráv.
multicastInterfaceId Celočíselná hodnota, která určuje ID rozhraní vícesměrového vysílání.
name Řetězec, který obsahuje název konfigurace vazby. Tato hodnota by měla být jedinečná, protože se používá jako identifikace vazby. Počínaje rozhraním .NET Framework 4 není nutné, aby vazby a chování měly název. Další informace o výchozí konfiguraci a beznázvových vazbách a chování najdete v tématu Zjednodušená konfigurace a zjednodušená konfigurace pro služby WCF.
openTimeout Hodnota TimeSpan , která určuje časový interval zadaný pro dokončení otevřené operace. Tato hodnota by měla být větší nebo rovna Zero. Výchozí hodnota je 00:01:00.
receiveTimeout Hodnota TimeSpan , která určuje časový interval určený k dokončení operace příjmu. Tato hodnota by měla být větší nebo rovna Zero. Výchozí hodnota je 00:10:00.
sendTimeout Hodnota TimeSpan , která určuje časový interval určený k dokončení operace odeslání. Tato hodnota by měla být větší nebo rovna Zero. Výchozí hodnota je 00:01:00.
textEncoding Nastaví kódování znakové sady, které se použije pro generování zpráv ve vazbě. Platné hodnoty zahrnují následující:

- BigEndianUnicode: Kódování Unicode BigEndian.
– Unicode: 16bitové kódování.
- UTF8: 8bitové kódování

Výchozí hodnota je UTF8. Tento atribut je typu Encoding.
timeToLive Hodnota časového rozsahu, která určuje čas, který má být pro vazbu aktivní.

Podřízené prvky

prvek Description
<readerQuotas> Definuje omezení složitosti zpráv SOAP, které lze zpracovat koncovými body nakonfigurovanými touto vazbou. Tento prvek je typu XmlDictionaryReaderQuotasElement.

Nadřazené prvky

prvek Description
<na něčí žádosti> Tento element obsahuje kolekci standardních a vlastních vazeb.

Poznámky

UdpBinding umožňuje službám WCF komunikovat přes přenos UDP. Umožňuje "aktivovat a zapomenout" výměny zpráv, kdy klient odešle zprávu službě a neočekává zpět žádnou odpověď.

Example

Následující příklad ukazuje, jak nakonfigurovat UdpBinding pomocí elementu<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>

Viz také