Freigeben über

<udpBinding>

Ein Konfigurationselement zum Konfigurieren der UdpBinding Bindung.

<Konfiguration>
   <system.serviceModel>
     <Einbände>
       <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>

Attribute und Elemente

In den folgenden Abschnitten werden Attribute sowie untergeordnete und übergeordnete Elemente beschrieben.

Attribute

Merkmal Description
closeTimeout Ein TimeSpan Wert, der das Zeitintervall angibt, das für einen abschlussden Vorgang bereitgestellt wird. Dieser Wert sollte größer oder gleich Zerosein. Der Standardwert ist 00:01:00.
duplicateMessageHistoryLength Ein ganzzahliger Wert, der die Länge des doppelten Nachrichtenverlaufs angibt.
maxBufferPoolSize Ein ganzzahliger Wert, der die maximale Speichermenge angibt, die vom Vorgesetzten der Nachrichtenpuffer, die Nachrichten vom Kanal empfangen, zugewiesen wird. Der Standardwert ist 524288 Bytes (0x80000).
maxBufferSize Ein ganzzahliger Wert, der die maximale Größe eines Puffers in Bytes angibt, der Nachrichten speichert, während sie für einen Endpunkt verarbeitet werden, der mit dieser Bindung konfiguriert ist. Der Standardwert ist 65.536 Bytes.
maxPendingMessagesTotalSize Ein ganzzahliger Wert, der die maximale Anzahl empfangener, aber noch nicht aus der Eingabewarteschlange für eine einzelne Kanalinstanz entfernte Nachrichten angibt.
maxReceivedMessageSize Eine positive ganze Zahl, die die maximale Nachrichtengröße in Bytes definiert, einschließlich Kopfzeilen, für eine Nachricht, die in einem Kanal empfangen werden kann, der mit dieser Bindung konfiguriert ist. Der Absender empfängt einen SOAP-Fehler, wenn die Nachricht für den Empfänger zu groß ist. Der Empfänger legt die Nachricht ab und erstellt einen Eintrag des Ereignisses im Ablaufverfolgungsprotokoll. Der Standardwert ist 65.536 Byte.
maxRetransmitCount Ein ganzzahliger Wert, der die maximale Anzahl von Nachrichten zurückgibt.
multicastInterfaceId Ein ganzzahliger Wert, der die Multicast-Schnittstellen-ID angibt.
name Eine Zeichenfolge, die den Konfigurationsnamen der Bindung enthält. Dieser Wert sollte eindeutig sein, da er als Identifikation für die Bindung verwendet wird. Ab .NET Framework 4 müssen Bindungen und Verhaltensweisen keinen Namen haben. Weitere Informationen zu Standardkonfigurationen und namenslosen Bindungen und Verhaltensweisen finden Sie unter Vereinfachte Konfiguration und vereinfachte Konfiguration für WCF-Dienste.
openTimeout Ein TimeSpan Wert, der das Für den Abschluss eines geöffneten Vorgangs bereitgestellte Zeitintervall angibt. Dieser Wert sollte größer oder gleich Zerosein. Der Standardwert ist 00:01:00.
receiveTimeout Ein TimeSpan Wert, der das Für den Abschluss eines Empfangsvorgangs bereitgestellte Zeitintervall angibt. Dieser Wert sollte größer oder gleich Zerosein. Der Standardwert ist 00:10:00.
sendTimeout Ein TimeSpan Wert, der das Für den Abschluss eines Sendevorgangs bereitgestellte Zeitintervall angibt. Dieser Wert sollte größer oder gleich Zerosein. Der Standardwert ist 00:01:00.
textEncoding Legt die Zeichensatzcodierung fest, die für das Senden von Nachrichten in der Bindung verwendet werden soll. Gültige Werte umfassen Folgendes:

- BigEndianUnicode: Unicode BigEndian-Codierung.
- Unicode: 16-Bit-Codierung.
- UTF8: 8-Bit-Codierung

Der Standardwert ist UTF8. Dieses Attribut ist vom Typ Encoding.
timeToLive Ein Zeitbereichswert, der die Zeit für die Bindung angibt.

Untergeordnete Elemente

Element Description
<readerQuotas> Definiert die Einschränkungen für die Komplexität von SOAP-Nachrichten, die von Endpunkten verarbeitet werden können, die mit dieser Bindung konfiguriert sind. Dieses Element ist vom Typ XmlDictionaryReaderQuotasElement.

Übergeordnete Elemente

Element Description
<Einbände> Dieses Element enthält eine Sammlung von Standard- und benutzerdefinierten Bindungen.

Bemerkungen

Mit udpBinding können WCF-Dienste über den UDP-Transport kommunizieren. Es ermöglicht den Nachrichtenaustausch "Auslösen und Vergessen", bei dem ein Client eine Nachricht an einen Dienst sendet und keine Antwort zurück erwartet.

Example

Das folgende Beispiel zeigt, wie Sie das Element mithilfe des UdpBinding<udpBinding> Elements konfigurieren.

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

Siehe auch

  • Last updated on