<udpBinding>

A kötés konfigurálásához használt konfigurációs UdpBinding elem.

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

Szemantika

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

Attribútumok és elemek

A következő szakaszok az attribútumokat, a gyermekelemeket és a szülőelemeket ismertetik.

Attributes

Attribute Description
closeTimeout Egy TimeSpan olyan érték, amely megadja a záró művelet végrehajtásához megadott időintervallumot. Ennek az értéknek nagyobbnak vagy egyenlőnek Zerokell lennie. Az alapértelmezett érték 00:01:00.
duplicateMessageHistoryLength Az ismétlődő üzenetelőzmények hosszát meghatározó egész szám.
maxBufferPoolSize Egész számérték, amely meghatározza, hogy a csatorna üzeneteit fogadó üzenetpufferek kezelője mekkora mennyiségű memóriát foglal le. Az alapértelmezett érték 524288 (0x80000) bájt.
maxBufferSize Egy egész számérték, amely bájtban határozza meg az üzeneteket tároló puffer maximális méretét, miközben a kötéssel konfigurált végponton dolgozzák fel őket. Az alapértelmezett érték 65 536 bájt.
maxPendingMessagesTotalSize Egy egész számérték, amely meghatározza az egyes csatornapéldányok bemeneti üzenetsorából fogadott, de még el nem távolított üzenetek maximális számát.
maxReceivedMessageSize Pozitív egész szám, amely bájtban határozza meg az üzenet maximális méretét, beleértve a fejléceket is, egy üzenethez, amely az ezzel a kötéssel konfigurált csatornán fogadható. A feladó SOAP-hibát kap, ha az üzenet túl nagy a fogadó számára. A fogadó eldobja az üzenetet, és létrehozza az esemény bejegyzését a nyomkövetési naplóban. Az alapértelmezett érték 65 536 bájt.
maxRetransmitCount Egész szám, amely meghatározza az újraküldési üzenetek maximális számát.
multicastInterfaceId A csoportos küldési felület azonosítóját meghatározó egész szám.
name A kötés konfigurációs nevét tartalmazó sztring. Ennek az értéknek egyedinek kell lennie, mert a kötés azonosításra szolgál. A .NET-keretrendszer 4-től kezdve a kötéseknek és a viselkedéseknek nem kell nevet adniuk. Az alapértelmezett konfigurációról és a névtelen kötésekről és viselkedésekről további információt a WCF-szolgáltatásokegyszerűsített konfigurációja és egyszerűsített konfigurációja című témakörben talál.
openTimeout Egy TimeSpan olyan érték, amely megadja a nyitott művelet végrehajtásához megadott időtartamot. Ennek az értéknek nagyobbnak vagy egyenlőnek Zerokell lennie. Az alapértelmezett érték 00:01:00.
receiveTimeout A TimeSpan fogadási művelet végrehajtásához megadott időintervallumot meghatározó érték. Ennek az értéknek nagyobbnak vagy egyenlőnek Zerokell lennie. Az alapértelmezett érték 00:10:00.
sendTimeout A TimeSpan küldési művelet végrehajtásához megadott időintervallumot meghatározó érték. Ennek az értéknek nagyobbnak vagy egyenlőnek Zerokell lennie. Az alapértelmezett érték 00:01:00.
textEncoding Beállítja a karakterkészlet kódolását a kötésen lévő üzenetek kibocsátásához. Az érvényes értékek a következők:

- BigEndianUnicode: Unicode BigEndian kódolás.
- Unicode: 16 bites kódolás.
- UTF8: 8 bites kódolás

Az alapértelmezett érték az UTF8. Ez az attribútum típusa Encoding.
timeToLive A kötés élettartamát meghatározó időbélyeg.

Gyermekelemek

Elem Description
<readerQuotas> Meghatározza a SOAP-üzenetek összetettségére vonatkozó korlátozásokat, amelyeket az ezzel a kötéssel konfigurált végpontok feldolgozhatnak. Ez az elem típusa XmlDictionaryReaderQuotasElement.

Szülőelemek

Elem Description
<Kötések> Ez az elem szabványos és egyéni kötések gyűjteményét tartalmazza.

Megjegyzések

Az UdpBinding lehetővé teszi, hogy a WCF-szolgáltatások az UDP-átvitelen keresztül kommunikáljanak. Lehetővé teszi a "tűz és felejtés" üzenetcseréket, ahol az ügyfél üzenetet küld egy szolgáltatásnak, és nem vár vissza választ.

Example

Az alábbi példa bemutatja, hogyan konfigurálható az UdpBinding<udpBinding> elem használata.

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

Lásd még

  • Last updated on