Udostępnij przez

<udpBinding>

Element konfiguracji używany do konfigurowania UdpBinding powiązania.

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

Składnia

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

Atrybuty i elementy

W poniższych sekcjach opisano atrybuty, elementy podrzędne i elementy nadrzędne.

Attributes

Attribute Description
closeTimeout TimeSpan Wartość określająca interwał czasu podany dla zakończenia operacji zamknięcia. Ta wartość powinna być większa lub równa Zero. Wartość domyślna to 00:01:00.
duplicateMessageHistoryLength Wartość całkowita określająca zduplikowaną długość historii komunikatów.
maxBufferPoolSize Wartość całkowita określająca maksymalną ilość pamięci przydzielonej do użycia przez menedżera komunikatów odbierających komunikaty z kanału. Wartość domyślna to 524288 (0x80000) bajtów.
maxBufferSize Wartość całkowita określająca maksymalny rozmiar w bajtach buforu, który przechowuje komunikaty podczas przetwarzania dla punktu końcowego skonfigurowanego za pomocą tego powiązania. Wartość domyślna to 65 536 bajtów.
maxPendingMessagesTotalSize Wartość całkowita określająca maksymalną liczbę odebranych komunikatów, ale nie została jeszcze usunięta z kolejki wejściowej dla pojedynczego wystąpienia kanału.
maxReceivedMessageSize Dodatnia liczba całkowita, która definiuje maksymalny rozmiar komunikatu w bajtach, w tym nagłówki, dla komunikatu, który można odebrać w kanale skonfigurowanym za pomocą tego powiązania. Nadawca otrzymuje błąd PROTOKOŁU SOAP, jeśli komunikat jest zbyt duży dla odbiornika. Odbiorca odrzuca komunikat i tworzy wpis zdarzenia w dzienniku śledzenia. Wartość domyślna to 65 536 bajtów.
maxRetransmitCount Wartość całkowita określająca maksymalną liczbę komunikatów przetransmitowania.
multicastInterfaceId Wartość całkowita określająca identyfikator interfejsu multiemisji.
name Ciąg zawierający nazwę konfiguracji powiązania. Ta wartość powinna być unikatowa, ponieważ jest używana jako identyfikacja powiązania. Począwszy od programu .NET Framework 4, powiązania i zachowania nie muszą mieć nazwy. Aby uzyskać więcej informacji na temat domyślnej konfiguracji i beznazowych powiązań i zachowań, zobacz Uproszczone konfigurowanie i uproszczona konfiguracja dla usług WCF.
openTimeout TimeSpan Wartość określająca interwał czasu podany dla operacji otwierania do ukończenia. Ta wartość powinna być większa lub równa Zero. Wartość domyślna to 00:01:00.
receiveTimeout TimeSpan Wartość określająca interwał czasu podany dla operacji odbierania do ukończenia. Ta wartość powinna być większa lub równa Zero. Wartość domyślna to 00:10:00.
sendTimeout TimeSpan Wartość określająca interwał czasu podany dla operacji wysyłania do ukończenia. Ta wartość powinna być większa lub równa Zero. Wartość domyślna to 00:01:00.
textEncoding Ustawia kodowanie zestawu znaków, które ma być używane do emitowania komunikatów w powiązaniu. Prawidłowe wartości obejmują następujące wartości:

- BigEndianUnicode: kodowanie Unicode BigEndian.
- Unicode: kodowanie 16-bitowe.
- UTF8: kodowanie 8-bitowe

Wartość domyślna to UTF8. Ten atrybut jest typu Encoding.
timeToLive Wartość przedziału czasu określająca czas wygaśnięcia powiązania.

Elementy podrzędne

Składnik Description
<Readerquotas> Definiuje ograniczenia dotyczące złożoności komunikatów PROTOKOŁU SOAP, które mogą być przetwarzane przez punkty końcowe skonfigurowane za pomocą tego powiązania. Ten element jest typu XmlDictionaryReaderQuotasElement.

Elementy nadrzędne

Składnik Description
<Powiązania> Ten element zawiera kolekcję powiązań standardowych i niestandardowych.

Uwagi

UdpBinding umożliwia usługom WCF komunikację za pośrednictwem transportu UDP. Umożliwia to wymianę komunikatów "fire and forget", w których klient wysyła komunikat do usługi i oczekuje odpowiedzi z powrotem.

Example

W poniższym przykładzie pokazano, jak skonfigurować UdpBinding przy użyciu <udpBinding> elementu .

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

Zobacz także

  • Last updated on