Socket::IsBound Property

Gets a value that indicates whether the Socket is bound to a specific local port.

Namespace:  System.Net.Sockets
Assembly:  System (in System.dll)

public:
property bool IsBound {
	bool get ();
}

Property Value

Type: System::Boolean
true if the Socket is bound to a local port; otherwise, false.

A socket is considered bound to a local port if it is explicitly bound by calling the Bind method, or implicitly bound by calling members like Connect, SendTo, or ReceiveFrom, which use an ephemeral local port (a free port greater than 1024, selected by the operating system.) Servers use the Bind method to bind to a well-known port so that clients may connect to them.

The following code example demonstrates the use of the IsBound property.

static void ConfigureTcpSocket(Socket^ tcpSocket)
{

    // Don't allow another socket to bind to this port.
    tcpSocket->ExclusiveAddressUse = true;

    // The socket will linger for 10 seconds after 
    // Socket.Close is called.
    tcpSocket->LingerState = gcnew LingerOption(true, 10);

    // Disable the Nagle Algorithm for this tcp socket.
    tcpSocket->NoDelay = true;

    // Set the receive buffer size to 8k
    tcpSocket->ReceiveBufferSize = 8192;

    // Set the timeout for synchronous receive methods to 
    // 1 second (1000 milliseconds.)
    tcpSocket->ReceiveTimeout = 1000;

    // Set the send buffer size to 8k.
    tcpSocket->SendBufferSize = 8192;

    // Set the timeout for synchronous send methods 
    // to 1 second (1000 milliseconds.)
    tcpSocket->SendTimeout = 1000;

    // Set the Time To Live (TTL) to 42 router hops.
    tcpSocket->Ttl = 42;
    Console::WriteLine("Tcp Socket configured:");
    Console::WriteLine("  ExclusiveAddressUse {0}", 
        tcpSocket->ExclusiveAddressUse);
    Console::WriteLine("  LingerState {0}, {1}", 
        tcpSocket->LingerState->Enabled,
        tcpSocket->LingerState->LingerTime);
    Console::WriteLine("  NoDelay {0}",
        tcpSocket->NoDelay);
    Console::WriteLine("  ReceiveBufferSize {0}", 
        tcpSocket->ReceiveBufferSize);
    Console::WriteLine("  ReceiveTimeout {0}",
        tcpSocket->ReceiveTimeout);
    Console::WriteLine("  SendBufferSize {0}",
        tcpSocket->SendBufferSize);
    Console::WriteLine("  SendTimeout {0}",
        tcpSocket->SendTimeout);
    Console::WriteLine("  Ttl {0}",
        tcpSocket->Ttl);
    Console::WriteLine("  IsBound {0}",
        tcpSocket->IsBound);
    Console::WriteLine("");
}

.NET Framework

Supported in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft