<udpBinding>

Článek
06/21/2023

Konfigurační prvek použitý ke konfiguraci vazby UdpBinding .

<Konfigurace>
  <System.servicemodel>
    <Vazby>
      <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>

Atributy a elementy

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

Atributy

Atribut	Popis
`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, které je přiděleno 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 v bajtech, která ukládá zprávy během jejich zpracování pro koncový bod nakonfigurovaný s touto vazbou. Výchozí hodnota je 65 536 bajtů.
`maxPendingMessagesTotalSize`	Celočíselná hodnota, která určuje maximální počet zpráv, které byly přijaty, ale ještě nebyly odebrány ze vstupní fronty pro instanci jednotlivého kanálu.
`maxReceivedMessageSize`	Kladné celé číslo, které definuje maximální velikost zprávy v bajtech včetně záhlaví pro zprávu, která může být přijata v kanálu nakonfigurovaného pomocí této vazby. 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 bezpomenný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í operace otevření. 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 zadaný pro 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 zadaný pro 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 má použít pro generování zpráv ve vazbě. Mezi platné hodnoty patří: - 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 dobu života vazby.

Podřízené elementy

Element	Popis
<čtenářQuotas>	Definuje omezení složitosti zpráv SOAP, které mohou být zpracovány koncovými body nakonfigurovanými pomocí této vazby. Tento prvek je typu XmlDictionaryReaderQuotasElement.

Nadřazené elementy

Element	Popis
<Vazby>	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 výměnu zpráv typu "aktivovat a zapomenout", kdy klient odešle zprávu službě a neočekává žádnou odpověď.

Příklad

Následující příklad ukazuje, jak nakonfigurovat UdpBinding pomocí elementuudpBinding<> .

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

Sdílet prostřednictvím