UdpClient.ExclusiveAddressUse Свойство

Определение

Пространство имен:

System.Net.Sockets

Сборка:

System.Net.Sockets.dll

Исходный код:

UDPClient.cs

Возвращает или задает значение Boolean, указывающее, разрешает ли объект UdpClient использовать порт только одному клиенту.

public:
 property bool ExclusiveAddressUse { bool get(); void set(bool value); };

public bool ExclusiveAddressUse { get; set; }

member this.ExclusiveAddressUse : bool with get, set

Public Property ExclusiveAddressUse As Boolean

Значение свойства

Boolean

Значение true, если объект UdpClient разрешает только одному клиенту использовать конкретный порт; в противном случае — значение false. По умолчанию используется значение true для Windows Server 2003 и Windows XP с пакетом обновления 2 (SP2) и более поздней версии; для всех остальных версий по умолчанию используется значение false.

Исключения

SocketException

Произошла ошибка при попытке доступа к основному сокету.

ObjectDisposedException

Основной объект Socket закрыт.

Примеры

В следующем примере кода создается UdpClient, а затем возвращается и задается ExclusiveAddressUse свойство .

static void GetSetExclusiveAddressUse( UdpClient^ u )
{
   // Don't allow another client to bind to this port.
   u->ExclusiveAddressUse = true;
   Console::WriteLine(  "ExclusiveAddressUse value is {0}", u->ExclusiveAddressUse );
}

public static void GetSetExclusiveAddressUse(UdpClient u)
{
    // Don't allow another client to bind to this port.
    u.ExclusiveAddressUse = true;
    Console.WriteLine("ExclusiveAddressUse value is {0}",
        u.ExclusiveAddressUse);
}

Комментарии

По умолчанию несколько клиентов могут использовать определенный порт; однако только один из клиентов может выполнять операции с сетевым трафиком, отправленным на порт. Свойство можно использовать, ExclusiveAddressUse чтобы запретить нескольким клиентам использовать определенный порт.

Это свойство должно быть задано до привязки базового сокета к порту клиента. При вызове UdpClient.UdpClient(Int32), UdpClient.UdpClient(Int32, AddressFamily), UdpClient.UdpClient(IPEndPoint)или UdpClient.UdpClient(String, Int32)порт клиента привязывается как побочный эффект конструктора, и впоследствии задать ExclusiveAddressUse свойство невозможно.