UdpClient 构造函数

定义

命名空间:

System.Net.Sockets

程序集:

System.Net.Sockets.dll

初始化 UdpClient 类的新实例。

重载

UdpClient()	初始化 UdpClient 类的新实例。
UdpClient(Int32)	初始化 UdpClient 类的新实例，并将它绑定到所提供的本地端口号。
UdpClient(IPEndPoint)	初始化 UdpClient 类的新实例，并将其绑定到指定的本地终结点。
UdpClient(AddressFamily)	初始化 UdpClient 类的新实例。
UdpClient(Int32, AddressFamily)	初始化 UdpClient 类的新实例，并将它绑定到所提供的本地端口号。
UdpClient(String, Int32)	初始化 UdpClient 类的新实例，并建立默认远程主机。

UdpClient()

Source:

UDPClient.cs

初始化 UdpClient 类的新实例。

public:
 UdpClient();

public UdpClient ();

Public Sub New ()

例外

SocketException

访问套接字时出错。

示例

下面的示例演示如何使用无参数构造函数创建 类的 UdpClient 实例。

//Creates an instance of the UdpClient class using the default constructor.
UdpClient^ udpClient = gcnew UdpClient;

//Creates an instance of the UdpClient class using the default constructor.
UdpClient udpClient = new UdpClient();

'Creates an instance of the UdpClient class using the default constructor.
Dim udpClient As New UdpClient()

注解

此构造函数创建新的 UdpClient ，并允许基础服务提供程序分配最合适的本地 IPv4 地址和端口号。 如果使用此构造函数，则会 UdpClient 使用 IPv4 地址系列设置实例，该地址系列不能由具有 IPv6 目标的连接方法调用更改或覆盖。

注意

如果收到 SocketException，请使用 SocketException.ErrorCode 获取特定的错误代码。 获取此代码后，可以参阅 Windows 套接字版本 2 API 错误代码 文档，获取错误的详细说明。

此构造函数不适合联接多播组，因为它不执行套接字绑定。 此外，它仅适用于 IPv4 地址类型。

UdpClient(Int32)

Source:

UDPClient.cs

初始化 UdpClient 类的新实例，并将它绑定到所提供的本地端口号。

public:
 UdpClient(int port);

public UdpClient (int port);

new System.Net.Sockets.UdpClient : int -> System.Net.Sockets.UdpClient

Public Sub New (port As Integer)

参数

port

Int32

要通过其进行通信的本地端口号。

例外

ArgumentOutOfRangeException

port 参数大于 MaxPort 或小于 MinPort。

SocketException

访问套接字时出错。

示例

以下示例演示如何使用本地端口号创建 类的 UdpClient 实例。

//Creates an instance of the UdpClient class to listen on
// the default interface using a particular port.
try
{
   UdpClient^ udpClient = gcnew UdpClient( 11000 );
}
catch ( Exception^ e ) 
{
   Console::WriteLine( e->ToString() );
}

//Creates an instance of the UdpClient class to listen on
// the default interface using a particular port.
try{
         UdpClient udpClient = new UdpClient(11000);
}
catch (Exception e ) {
          Console.WriteLine(e.ToString());
  }

'Creates an instance of the UdpClient class to listen on 
'the default interface using a particular port.
Try
   Dim udpClient As New UdpClient(11000)
Catch e As Exception
   Console.WriteLine(e.ToString())
End Try

注解

此构造函数创建基础 Socket 并将其绑定到要从中进行通信的端口号。 如果只想设置本地端口号，请使用此构造函数。 基础服务提供程序将分配本地 IP 地址。 如果将 0 传递给构造函数，基础服务提供程序将分配端口号。 如果使用此构造函数，则会 UdpClient 使用 IPv4 地址系列设置实例，该地址系列不能由具有 IPv6 目标的连接方法调用更改或覆盖。

注意

如果收到 SocketException，请使用 SocketException.ErrorCode 获取特定的错误代码。 获取此代码后，可以参阅 Windows 套接字版本 2 API 错误代码 文档，获取错误的详细说明。

此构造函数仅适用于 IPv4 地址类型。

UdpClient(IPEndPoint)

Source:

UDPClient.cs

初始化 UdpClient 类的新实例，并将其绑定到指定的本地终结点。

public:
 UdpClient(System::Net::IPEndPoint ^ localEP);

public UdpClient (System.Net.IPEndPoint localEP);

new System.Net.Sockets.UdpClient : System.Net.IPEndPoint -> System.Net.Sockets.UdpClient

Public Sub New (localEP As IPEndPoint)

参数

localEP

IPEndPoint

一个 IPEndPoint，表示将 UDP 连接绑定到的本地终结点。

例外

ArgumentNullException

localEP 为 null。

SocketException

访问套接字时出错。

示例

以下示例演示如何使用本地终结点创建 类的 UdpClient 实例。

//Creates an instance of the UdpClient class using a local endpoint.
IPAddress^ ipAddress = Dns::Resolve( Dns::GetHostName() )->AddressList[ 0 ];
IPEndPoint^ ipLocalEndPoint = gcnew IPEndPoint( ipAddress,11000 );

try
{
   UdpClient^ udpClient = gcnew UdpClient( ipLocalEndPoint );
}
catch ( Exception^ e ) 
{
   Console::WriteLine( e->ToString() );
}

//Creates an instance of the UdpClient class using a local endpoint.
 IPAddress ipAddress = Dns.Resolve(Dns.GetHostName()).AddressList[0];
 IPEndPoint ipLocalEndPoint = new IPEndPoint(ipAddress, 11000);

try{
     UdpClient udpClient = new UdpClient(ipLocalEndPoint);
}
catch (Exception e ) {
           Console.WriteLine(e.ToString());
}

'Creates an instance of the UdpClient class using a local endpoint.
Dim ipAddress As IPAddress = Dns.Resolve(Dns.GetHostName()).AddressList(0)
Dim ipLocalEndPoint As New IPEndPoint(ipAddress, 11000)

Try
   Dim udpClient As New UdpClient(ipLocalEndPoint)
Catch e As Exception
   Console.WriteLine(e.ToString())
End Try

注解

此构造函数创建一个新的 UdpClient 并将其绑定到 IPEndPoint 参数指定的 localEP 。 在调用此构造函数之前，必须使用要从中发送和接收数据的 IP 地址和端口号创建 IPEndPoint 。 无需指定本地 IP 地址和端口号即可发送和接收数据。 否则，基础服务提供商将分配最合适的本地 IP 地址和端口号。

如果使用此构造函数，则 UdpClient 使用 参数指定的 localEP 地址系列设置实例，该地址系列不能由具有不同地址系列的 connect 方法调用更改或覆盖。

注意

如果收到 SocketException，请使用 SocketException.ErrorCode 获取特定的错误代码。 获取此代码后，可以参阅 Windows 套接字版本 2 API 错误代码 文档，获取错误的详细说明。

另请参阅

• IPEndPoint

UdpClient(AddressFamily)

Source:

UDPClient.cs

初始化 UdpClient 类的新实例。

public:
 UdpClient(System::Net::Sockets::AddressFamily family);

public UdpClient (System.Net.Sockets.AddressFamily family);

new System.Net.Sockets.UdpClient : System.Net.Sockets.AddressFamily -> System.Net.Sockets.UdpClient

Public Sub New (family As AddressFamily)

参数

family

AddressFamily

AddressFamily 值之一，它指定套接字的寻址方案。

例外

ArgumentException

family 不是 InterNetwork 或 InterNetworkV6。

SocketException

访问套接字时出错。

注解

参数 family 确定侦听器是使用 IP 版本 4 地址 (IPv4) 还是使用 IP 版本 6 (IPv6) 地址。 若要使用 IPv4 地址，请 InterNetwork 传递 值。 若要使用 IPv6 地址，请 InterNetworkV6 传递 值。 传递任何其他值将导致 方法引发 ArgumentException。

如果使用此构造函数，则 UdpClient 使用 参数指定的 family 地址系列设置实例，该地址系列不能由具有不同地址系列的 connect 方法调用更改或覆盖。

注意

如果收到 SocketException，请使用 SocketException.ErrorCode 获取特定的错误代码。 获取此代码后，可以参阅 Windows 套接字版本 2 API 错误代码 文档，获取错误的详细说明。

UdpClient.UdpClient(AddressFamily)不适合加入多播组，因为它不执行套接字绑定。

UdpClient(Int32, AddressFamily)

Source:

UDPClient.cs

初始化 UdpClient 类的新实例，并将它绑定到所提供的本地端口号。

public:
 UdpClient(int port, System::Net::Sockets::AddressFamily family);

public UdpClient (int port, System.Net.Sockets.AddressFamily family);

new System.Net.Sockets.UdpClient : int * System.Net.Sockets.AddressFamily -> System.Net.Sockets.UdpClient

Public Sub New (port As Integer, family As AddressFamily)

参数

port

Int32

用来侦听传入的连接尝试的端口。

family

AddressFamily

AddressFamily 值之一，它指定套接字的寻址方案。

例外

ArgumentException

family 不是 InterNetwork 或 InterNetworkV6。

ArgumentOutOfRangeException

port 大于 MaxPort 或小于 MinPort。

SocketException

访问套接字时出错。

示例

下面的代码示例演示如何创建 UDP 客户端以在多播组中使用。

// Bind and listen on port 2000. This constructor creates a socket
// and binds it to the port on which to receive data. The family
// parameter specifies that this connection uses an IPv6 address.
clientOriginator = gcnew UdpClient( 2000,AddressFamily::InterNetworkV6 );

// Join or create a multicast group. The multicast address ranges
// to use are specified in RFC#2375. You are free to use
// different addresses.
// Transform the String* address into the internal format.
m_GrpAddr = IPAddress::Parse( "FF01::1" );

// Display the multicast address used.
Console::WriteLine( "Multicast Address: [ {0}]", m_GrpAddr );

// Exercise the use of the IPv6MulticastOption.
Console::WriteLine( "Instantiate IPv6MulticastOption(IPAddress)" );

// Instantiate IPv6MulticastOption using one of the
// overloaded constructors.
IPv6MulticastOption^ ipv6MulticastOption = gcnew IPv6MulticastOption( m_GrpAddr );

// Store the IPAdress multicast options.
IPAddress^ group = ipv6MulticastOption->Group;
__int64 interfaceIndex = ipv6MulticastOption->InterfaceIndex;

// Display IPv6MulticastOption properties.
Console::WriteLine( "IPv6MulticastOption::Group: [ {0}]", group );
Console::WriteLine( "IPv6MulticastOption::InterfaceIndex: [ {0}]", interfaceIndex );

// Instantiate IPv6MulticastOption using another
// overloaded constructor.
IPv6MulticastOption^ ipv6MulticastOption2 = gcnew IPv6MulticastOption( group,interfaceIndex );

// Store the IPAdress multicast options.
group = ipv6MulticastOption2->Group;
interfaceIndex = ipv6MulticastOption2->InterfaceIndex;

// Display the IPv6MulticastOption2 properties.
Console::WriteLine( "IPv6MulticastOption::Group: [ {0} ]", group );
Console::WriteLine( "IPv6MulticastOption::InterfaceIndex: [ {0} ]", interfaceIndex );

// Join the specified multicast group using one of the
// JoinMulticastGroup overloaded methods.
clientOriginator->JoinMulticastGroup( (int)interfaceIndex, group );

// Define the endpoint data port. Note that this port number
// must match the ClientTarget UDP port number which is the
// port on which the ClientTarget is receiving data.
m_ClientTargetdest = gcnew IPEndPoint( m_GrpAddr,1000 );

// Bind and listen on port 2000. This constructor creates a socket
// and binds it to the port on which to receive data. The family
// parameter specifies that this connection uses an IPv6 address.
clientOriginator = new UdpClient(2000, AddressFamily.InterNetworkV6);

// Join or create a multicast group. The multicast address ranges
// to use are specified in RFC#2375. You are free to use
// different addresses.

// Transform the string address into the internal format.
m_GrpAddr = IPAddress.Parse("FF01::1");

// Display the multicast address used.
Console.WriteLine("Multicast Address: [" + m_GrpAddr.ToString() + "]");

// Exercise the use of the IPv6MulticastOption.
Console.WriteLine("Instantiate IPv6MulticastOption(IPAddress)");

// Instantiate IPv6MulticastOption using one of the
// overloaded constructors.
IPv6MulticastOption ipv6MulticastOption = new IPv6MulticastOption(m_GrpAddr);

// Store the IPAdress multicast options.
IPAddress group =  ipv6MulticastOption.Group;
long interfaceIndex = ipv6MulticastOption.InterfaceIndex;

// Display IPv6MulticastOption properties.
Console.WriteLine("IPv6MulticastOption.Group: [" + group  + "]");
Console.WriteLine("IPv6MulticastOption.InterfaceIndex: [" + interfaceIndex + "]");



// Instantiate IPv6MulticastOption using another
// overloaded constructor.
IPv6MulticastOption ipv6MulticastOption2 = new IPv6MulticastOption(group, interfaceIndex);

// Store the IPAdress multicast options.
group =  ipv6MulticastOption2.Group;
interfaceIndex = ipv6MulticastOption2.InterfaceIndex;

// Display the IPv6MulticastOption2 properties.
Console.WriteLine("IPv6MulticastOption.Group: [" + group  + "]");
Console.WriteLine("IPv6MulticastOption.InterfaceIndex: [" + interfaceIndex + "]");

// Join the specified multicast group using one of the
// JoinMulticastGroup overloaded methods.
clientOriginator.JoinMulticastGroup((int)interfaceIndex, group);


// Define the endpoint data port. Note that this port number
// must match the ClientTarget UDP port number which is the
// port on which the ClientTarget is receiving data.
m_ClientTargetdest = new IPEndPoint(m_GrpAddr, 1000);

' Bind and listen on port 2000. This constructor creates a socket 
' and binds it to the port on which to receive data. The family 
' parameter specifies that this connection uses an IPv6 address.
clientOriginator = New UdpClient(2000, AddressFamily.InterNetworkV6)

' Join or create a multicast group. The multicast address ranges 
' to use are specified in RFC#2375. You are free to use 
' different addresses.
' Transform the string address into the internal format.
m_GrpAddr = IPAddress.Parse("FF01::1")

' Display the multicast address used.
Console.WriteLine(("Multicast Address: [" + m_GrpAddr.ToString() + "]"))

' Exercise the use of the IPv6MulticastOption.
Console.WriteLine("Instantiate IPv6MulticastOption(IPAddress)")

' Instantiate IPv6MulticastOption using one of the 
' overloaded constructors.
Dim ipv6MulticastOption As New IPv6MulticastOption(m_GrpAddr)

' Store the IPAdress multicast options.
Dim group As IPAddress = ipv6MulticastOption.Group
Dim interfaceIndex As Long = ipv6MulticastOption.InterfaceIndex

' Display IPv6MulticastOption properties.
Console.WriteLine(("IPv6MulticastOption.Group: [" + group.ToString() + "]"))
Console.WriteLine(("IPv6MulticastOption.InterfaceIndex: [" + interfaceIndex.ToString() + "]"))

' Instantiate IPv6MulticastOption using another 
' overloaded constructor.
Dim ipv6MulticastOption2 As New IPv6MulticastOption(group, interfaceIndex)

' Store the IPAdress multicast options.
group = ipv6MulticastOption2.Group
interfaceIndex = ipv6MulticastOption2.InterfaceIndex

' Display the IPv6MulticastOption2 properties.
Console.WriteLine(("IPv6MulticastOption.Group: [" + group.ToString() + "]"))
Console.WriteLine(("IPv6MulticastOption.InterfaceIndex: [" + interfaceIndex.ToString() + "]"))

' Join the specified multicast group using one of the 
' JoinMulticastGroup overloaded methods.
clientOriginator.JoinMulticastGroup(Fix(interfaceIndex), group)

' Define the endpoint data port. Note that this port number
' must match the ClientTarget UDP port number which is the
' port on which the ClientTarget is receiving data.
m_ClientTargetdest = New IPEndPoint(m_GrpAddr, 1000)

注解

此构造函数创建基础 Socket 并将其绑定到要从中进行通信的端口号。

参数 family 确定侦听器是使用 IP 版本 4 地址 (IPv4) 还是使用 IP 版本 6 (IPv6) 地址。 若要使用 IPv4 地址，请 InterNetwork 传递 值。 若要使用 IPv6 地址，请 InterNetworkV6 传递 值。 传递任何其他值将导致 方法引发 ArgumentException。

如果使用此构造函数，则 UdpClient 使用 参数指定的 family 地址系列设置实例，该地址系列不能由具有不同地址系列的 connect 方法调用更改或覆盖。

注意

如果收到 SocketException，请使用 SocketException.ErrorCode 获取特定的错误代码。 获取此代码后，请参阅 Windows 套接字版本 2 API 错误代码 文档，获取错误的详细说明。

UdpClient(String, Int32)

Source:

UDPClient.cs

初始化 UdpClient 类的新实例，并建立默认远程主机。

public:
 UdpClient(System::String ^ hostname, int port);

public UdpClient (string hostname, int port);

new System.Net.Sockets.UdpClient : string * int -> System.Net.Sockets.UdpClient

Public Sub New (hostname As String, port As Integer)

参数

hostname

String

要连接到的远程 DNS 主机的名称。

port

Int32

要连接到的远程端口号。

例外

ArgumentNullException

hostname 为 null。

ArgumentOutOfRangeException

port 不在 MinPort 和 MaxPort 之间。

SocketException

访问套接字时出错。

示例

以下示例演示如何使用主机名和端口号创建 类的 UdpClient 实例。

//Creates an instance of the UdpClient class with a remote host name and a port number.
try
{
   UdpClient^ udpClient = gcnew UdpClient( "www.contoso.com",11000 );
}
catch ( Exception^ e ) 
{
   Console::WriteLine( e->ToString() );
}

//Creates an instance of the UdpClient class with a remote host name and a port number.
try{
     UdpClient udpClient = new UdpClient("www.contoso.com",11000);
}
catch (Exception e ) {
           Console.WriteLine(e.ToString());
}

'Creates an instance of the UdpClient class with a remote host name and a port number.
Try
   Dim udpClient As New UdpClient("www.contoso.com", 11000)
Catch e As Exception
   Console.WriteLine(e.ToString())
End Try

注解

此构造函数初始化hostname新的 UdpClient 并使用 和 port 参数建立远程主机。 建立默认远程主机是可选的。 如果使用此构造函数，则不必在每次调用 Send 方法时指定远程主机。 指定默认远程主机仅限于该主机。 可以随时通过调用 Connect 方法更改默认远程主机。 如果要在调用 Send 方法时指定远程主机，请不要使用此构造函数。

注意

如果收到 SocketException，请使用 SocketException.ErrorCode 获取特定的错误代码。 获取此代码后，可以参阅 Windows 套接字版本 2 API 错误代码 文档，获取错误的详细说明。

另请参阅

• Send(Byte[], Int32, IPEndPoint)
• Connect(String, Int32)