TcpClient.ExclusiveAddressUse Свойство

Определение

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

System.Net.Sockets

Сборка:

System.Net.Sockets.dll

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

TCPClient.cs

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

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, если объект TcpClient разрешает только одному клиенту использовать конкретный порт; в противном случае — значение false. По умолчанию используется значение true для Windows Server 2003 и Windows XP с пакетом обновления 2 (SP2) и более поздней версии; для всех остальных версий по умолчанию используется значение false.

Исключения

SocketException

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

ObjectDisposedException

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

Примеры

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

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

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

Комментарии

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

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