TcpClient.ExclusiveAddressUse Propiedad

Definición

Espacio de nombres:

System.Net.Sockets

Ensamblado:

System.Net.Sockets.dll

Source:

TCPClient.cs

Obtiene o establece un valor Boolean que especifica si el TcpClient permite a un único cliente usar un puerto.

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

Valor de propiedad

Boolean

Es true si el objeto TcpClient permite a un único cliente utilizar un puerto específico; en caso contrario, es false. El valor predeterminado es true para Windows Server 2003 y Windows XP Service Pack 2 y versiones posteriores, y false para el resto de versiones.

Excepciones

SocketException

Se ha producido un error al intentar obtener acceso al socket subyacente.

ObjectDisposedException

El objeto Socket subyacente se ha cerrado.

Ejemplos

En el ejemplo de código siguiente se crea y TcpClient se obtiene y se establece el valor de la ExclusiveAddressUse propiedad .

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);
}

Comentarios

De forma predeterminada, varios clientes pueden usar un puerto específico; sin embargo, solo uno de los clientes puede realizar operaciones en el tráfico de red enviado al puerto. Puede usar la ExclusiveAddressUse propiedad para evitar que varios clientes usen un puerto específico.

Esta propiedad debe establecerse antes de que el socket subyacente esté enlazado a un puerto de cliente. Si llama a Connect, BeginConnect, TcpClient(IPEndPoint)o TcpClient(String, Int32), el puerto de cliente se enlaza como efecto secundario del método y posteriormente no se puede establecer la ExclusiveAddressUse propiedad .