IPEndPoint 构造函数

定义

命名空间:

System.Net

程序集:

System.Net.Primitives.dll

初始化 IPEndPoint 类的新实例。

重载

IPEndPoint(Int64, Int32)	用指定的地址和端口号初始化 IPEndPoint 类的新实例。
IPEndPoint(IPAddress, Int32)	用指定的地址和端口号初始化 IPEndPoint 类的新实例。

IPEndPoint(Int64, Int32)

用指定的地址和端口号初始化 IPEndPoint 类的新实例。

public:
 IPEndPoint(long address, int port);

public IPEndPoint (long address, int port);

new System.Net.IPEndPoint : int64 * int -> System.Net.IPEndPoint

Public Sub New (address As Long, port As Integer)

参数

address

Int64

Internet 主机的 IP 地址。 例如，大端格式的值 0x2414188f 可能为 IP 地址“143.24.20.36”。

port

Int32

与 address 关联的端口号，或为 0 以指定任何可用端口。 port 以主机顺序排列。

例外

ArgumentOutOfRangeException

port 小于 MinPort。

- 或 -

port 大于 MaxPort。

- 或 -

address 小于 0 或大于 0x00000000FFFFFFFF。

示例

以下示例使用指定的 IP 地址和端口号来创建 IPEndPoint。

IPAddress^ hostIPAddress1 = (Dns::Resolve( hostString1 ))->AddressList[ 0 ];
Console::WriteLine( hostIPAddress1 );
IPEndPoint^ hostIPEndPoint = gcnew IPEndPoint( hostIPAddress1,80 );
Console::WriteLine( "\nIPEndPoint information:{0}", hostIPEndPoint );
Console::WriteLine( "\n\tMaximum allowed Port Address :{0}", IPEndPoint::MaxPort );
Console::WriteLine( "\n\tMinimum allowed Port Address :{0}", (int^)IPEndPoint::MinPort );
Console::WriteLine( "\n\tAddress Family :{0}", hostIPEndPoint->AddressFamily );

IPAddress hostIPAddress1 = (Dns.Resolve(hostString1)).AddressList[0];
Console.WriteLine(hostIPAddress1.ToString());
IPEndPoint hostIPEndPoint = new IPEndPoint(hostIPAddress1,80);
Console.WriteLine("\nIPEndPoint information:" + hostIPEndPoint.ToString());
Console.WriteLine("\n\tMaximum allowed Port Address :" + IPEndPoint.MaxPort);
Console.WriteLine("\n\tMinimum allowed Port Address :" + IPEndPoint.MinPort);
Console.WriteLine("\n\tAddress Family :" + hostIPEndPoint.AddressFamily);

Dim hostIPAddress1 As IPAddress = Dns.Resolve(hostString1).AddressList(0)
Dim hostIPEndPoint As New IPEndPoint(hostIPAddress1, 80)
Console.WriteLine((ControlChars.Cr + "IPEndPoint information:" + hostIPEndPoint.ToString()))
Console.WriteLine((ControlChars.Cr + ControlChars.Tab + "Maximum allowed Port Address :" + IPEndPoint.MaxPort.ToString()))
Console.WriteLine((ControlChars.Cr + ControlChars.Tab + "Minimum allowed Port Address :" + IPEndPoint.MinPort.ToString()))
Console.WriteLine((ControlChars.Cr + ControlChars.Tab + "Address Family :" + hostIPEndPoint.AddressFamily.ToString()))

IPEndPoint(IPAddress, Int32)

用指定的地址和端口号初始化 IPEndPoint 类的新实例。

public:
 IPEndPoint(System::Net::IPAddress ^ address, int port);

public IPEndPoint (System.Net.IPAddress address, int port);

new System.Net.IPEndPoint : System.Net.IPAddress * int -> System.Net.IPEndPoint

Public Sub New (address As IPAddress, port As Integer)

参数

address

IPAddress

IPAddress。

port

Int32

与 address 关联的端口号，或为 0 以指定任何可用端口。 port 以主机顺序排列。

例外

ArgumentNullException

address 为 null。

ArgumentOutOfRangeException

port 小于 MinPort。

- 或 -

port 大于 MaxPort。

示例

// Obtain the IP address from the list of IP addresses associated with the server.
System::Collections::IEnumerator^ myEnum = host->AddressList->GetEnumerator();
while ( myEnum->MoveNext() )
{
   IPAddress^ address = safe_cast<IPAddress^>(myEnum->Current);
   IPEndPoint^ endpoint = gcnew IPEndPoint( address,port );
   tempSocket = gcnew Socket( endpoint->AddressFamily,SocketType::Stream,ProtocolType::Tcp );
   tempSocket->Connect( endpoint );
   if ( tempSocket->Connected )
   {
      // Display the endpoint information.
      displayEndpointInfo( endpoint );

      // Serialize the endpoint to obtain a SocketAddress object.
      serializedSocketAddress = serializeEndpoint( endpoint );
      break;
   }
   else
            continue;
}

// Obtain the IP address from the list of IP addresses associated with the server.
foreach(IPAddress address in host.AddressList)
{
  IPEndPoint endpoint = new IPEndPoint(address, port);

  tempSocket =
    new Socket(endpoint.AddressFamily, SocketType.Stream, ProtocolType.Tcp);

  tempSocket.Connect(endpoint);

  if(tempSocket.Connected)
  {
    // Display the endpoint information.
    displayEndpointInfo(endpoint);
    // Serialize the endpoint to obtain a SocketAddress object.
    serializedSocketAddress = serializeEndpoint(endpoint);
    break;
  }
  else
            {
                continue;
            }
        }

' Obtain the IP address from the list of IP addresses associated with the server.
Dim address As IPAddress
For Each address In host.AddressList
  Dim endpoint As New IPEndPoint(address, port)


  tempSocket = New Socket(endpoint.AddressFamily, SocketType.Stream, ProtocolType.Tcp)

  tempSocket.Connect(endpoint)

  If tempSocket.Connected Then
    ' Display the endpoint information.
    displayEndpointInfo(endpoint)
    ' Serialize the endpoint to obtain a SocketAddress object.
    serializedSocketAddress = serializeEndpoint(endpoint)
    Exit For

  End If

Next address