UdpClient Oluşturucular

Tanım

Ad Alanı:

System.Net.Sockets

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Net.Sockets.dll

UdpClient sınıfının yeni bir örneğini başlatır.

Aşırı Yüklemeler

Name	Description
UdpClient()	UdpClient sınıfının yeni bir örneğini başlatır.
UdpClient(Int32)	Sınıfının yeni bir örneğini UdpClient başlatır ve sağlanan yerel bağlantı noktası numarasına bağlar.
UdpClient(IPEndPoint)	Sınıfının yeni bir örneğini UdpClient başlatır ve belirtilen yerel uç noktaya bağlar.
UdpClient(AddressFamily)	UdpClient sınıfının yeni bir örneğini başlatır.
UdpClient(Int32, AddressFamily)	Sınıfının yeni bir örneğini UdpClient başlatır ve sağlanan yerel bağlantı noktası numarasına bağlar.
UdpClient(String, Int32)	Sınıfının yeni bir örneğini UdpClient başlatır ve varsayılan bir uzak konak oluşturur.

UdpClient()

Kaynak:

UDPClient.cs

UdpClient sınıfının yeni bir örneğini başlatır.

public:
 UdpClient();

public UdpClient();

Public Sub New ()

Özel durumlar

SocketException

Yuvaya erişilirken bir hata oluştu.

Örnekler

Aşağıdaki örnekte, sınıfının bir örneğini oluşturmak için parametresiz oluşturucunun nasıl kullanılacağı gösterilmektedir 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()

Açıklamalar

Bu oluşturucu yeni UdpClient bir oluşturur ve temel hizmet sağlayıcısının en uygun yerel IPv4 adresini ve bağlantı noktası numarasını atamasını sağlar. Bu oluşturucu kullanılırsa örnek, IPv6 hedefli UdpClient bir bağlantı yöntemi çağrısı tarafından değiştirilemeyen veya üzerine yazılamayan bir IPv4 adres ailesi ile ayarlanır.

Note

bir alırsanız, belirli bir SocketExceptionhata kodunu almak için kullanın SocketException.ErrorCode . Bu kodu aldıktan sonra, hatanın ayrıntılı açıklaması için Windows Yuvaları sürüm 2 API hata kodu belgelerine başvurabilirsiniz.

Bu oluşturucu, yuva bağlaması gerçekleştirmediğinden çok noktaya yayın grubuna katılmak için uygun değildir. Ayrıca, yalnızca IPv4 adres türleriyle çalışır.

UdpClient(Int32)

Kaynak:

UDPClient.cs

Sınıfının yeni bir örneğini UdpClient başlatır ve sağlanan yerel bağlantı noktası numarasına bağlar.

public:
 UdpClient(int port);

public UdpClient(int port);

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

Public Sub New (port As Integer)

Parametreler

port

Int32

İletişim kurmak istediğiniz yerel bağlantı noktası numarası.

Özel durumlar

ArgumentOutOfRangeException

port parametresi büyüktür MaxPort veya değerinden MinPortküçüktür.

SocketException

Yuvaya erişilirken bir hata oluştu.

Örnekler

Aşağıdaki örnekte, sınıfın bir örneğini oluşturmak için yerel bağlantı noktası numarasının kullanılması gösterilmektedir UdpClient .

//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

Açıklamalar

Bu oluşturucu, temel alınan Socket bir oluşturur ve iletişim kurmak istediğiniz bağlantı noktası numarasına bağlar. Yalnızca yerel bağlantı noktası numarasını ayarlamak istiyorsanız bu oluşturucuyu kullanın. Temel alınan hizmet sağlayıcısı yerel IP adresini atar. Oluşturucuya 0 geçirirseniz, temel alınan hizmet sağlayıcısı bir bağlantı noktası numarası atar. Bu oluşturucu kullanılırsa örnek, IPv6 hedefli UdpClient bir bağlantı yöntemi çağrısı tarafından değiştirilemeyen veya üzerine yazılamayan bir IPv4 adres ailesi ile ayarlanır.

Note

bir alırsanız, belirli bir SocketExceptionhata kodunu almak için kullanın SocketException.ErrorCode . Bu kodu aldıktan sonra, hatanın ayrıntılı açıklaması için Windows Yuvaları sürüm 2 API hata kodu belgelerine başvurabilirsiniz.

Bu oluşturucu yalnızca IPv4 adres türleriyle çalışır.

UdpClient(IPEndPoint)

Kaynak:

UDPClient.cs

Sınıfının yeni bir örneğini UdpClient başlatır ve belirtilen yerel uç noktaya bağlar.

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)

Parametreler

localEP

IPEndPoint

IPEndPoint UDP bağlantısını bağladığınız yerel uç noktayı temsil eden.

Özel durumlar

ArgumentNullException

localEP, null'e eşittir.

SocketException

Yuvaya erişilirken bir hata oluştu.

Örnekler

Aşağıdaki örnekte, yerel uç nokta kullanarak sınıfın UdpClient bir örneğinin nasıl oluşturulacağı gösterilmektedir.

//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

Açıklamalar

Bu oluşturucu yeni UdpClient bir oluşturur ve parametresi tarafından belirtilene IPEndPointlocalEP bağlar. Bu oluşturucuyu çağırmadan önce, veri göndermek ve almak istediğiniz IP adresini ve bağlantı noktası numarasını kullanarak bir IPEndPoint oluşturmanız gerekir. Veri göndermek ve almak için yerel bir IP adresi ve bağlantı noktası numarası belirtmeniz gerekmez. Bunu yapmazsanız, temel alınan hizmet sağlayıcısı en uygun yerel IP adresini ve bağlantı noktası numarasını atar.

Bu oluşturucu kullanılırsa, örnek parametresi UdpClient tarafından localEP belirtilen ve farklı bir adres ailesine sahip bir connect yöntemi çağrısı tarafından değiştirilemeyen veya üzerine yazılamayan adres ailesi ile ayarlanır.

Note

bir alırsanız, belirli bir SocketExceptionhata kodunu almak için kullanın SocketException.ErrorCode . Bu kodu aldıktan sonra, hatanın ayrıntılı açıklaması için Windows Yuvaları sürüm 2 API hata kodu belgelerine başvurabilirsiniz.

Ayrıca bkz.

• IPEndPoint

UdpClient(AddressFamily)

Kaynak:

UDPClient.cs

UdpClient sınıfının yeni bir örneğini başlatır.

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)

Parametreler

family

AddressFamily

Yuvanın AddressFamily adresleme düzenini belirten değerlerden biri.

Özel durumlar

ArgumentException

familyveya InterNetworkdeğildirInterNetworkV6.

SocketException

Yuvaya erişilirken bir hata oluştu.

Açıklamalar

family parametresi dinleyicinin IP sürüm 4 adresi mi (IPv4) yoksa IP sürüm 6 (IPv6) adresi mi kullandığını belirler. IPv4 adresi kullanmak için değeri geçirin InterNetwork . IPv6 adresi kullanmak için değeri geçirin InterNetworkV6 . Başka bir değer geçirmek yönteminin bir ArgumentExceptionoluşturmasına neden olur.

Bu oluşturucu kullanılırsa, örnek parametresi UdpClient tarafından family belirtilen ve farklı bir adres ailesine sahip bir connect yöntemi çağrısı tarafından değiştirilemeyen veya üzerine yazılamayan adres ailesi ile ayarlanır.

Note

bir alırsanız, belirli bir SocketExceptionhata kodunu almak için kullanın SocketException.ErrorCode . Bu kodu aldıktan sonra, hatanın ayrıntılı açıklaması için Windows Yuvaları sürüm 2 API hata kodu belgelerine başvurabilirsiniz.

UdpClient.UdpClient(AddressFamily), yuva bağlaması gerçekleştirmediğinden çok noktaya yayın grubuna katılmak için uygun değildir.

UdpClient(Int32, AddressFamily)

Kaynak:

UDPClient.cs

Sınıfının yeni bir örneğini UdpClient başlatır ve sağlanan yerel bağlantı noktası numarasına bağlar.

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)

Parametreler

port

Int32

Gelen bağlantı girişimlerini dinleyebileceğiniz bağlantı noktası.

family

AddressFamily

Yuvanın AddressFamily adresleme düzenini belirten değerlerden biri.

Özel durumlar

ArgumentException

familyveya InterNetworkdeğildirInterNetworkV6.

ArgumentOutOfRangeException

port değerinden MaxPort büyük veya küçüktür MinPort.

SocketException

Yuvaya erişilirken bir hata oluştu.

Örnekler

Aşağıdaki kod örneği, çok noktaya yayın grubunda kullanmak üzere bir UDP istemcisinin nasıl oluşturulacağını gösterir.

// 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)

Açıklamalar

Bu oluşturucu, temel alınan Socket bir oluşturur ve iletişim kurmak istediğiniz bağlantı noktası numarasına bağlar.

family parametresi dinleyicinin IP sürüm 4 adresi mi (IPv4) yoksa IP sürüm 6 (IPv6) adresi mi kullandığını belirler. IPv4 adresi kullanmak için değeri geçirin InterNetwork . IPv6 adresi kullanmak için değeri geçirin InterNetworkV6 . Başka bir değer geçirmek yönteminin bir ArgumentExceptionoluşturmasına neden olur.

Bu oluşturucu kullanılırsa, örnek parametresi UdpClient tarafından family belirtilen ve farklı bir adres ailesine sahip bir connect yöntemi çağrısı tarafından değiştirilemeyen veya üzerine yazılamayan adres ailesi ile ayarlanır.

Note

bir alırsanız, belirli bir SocketExceptionhata kodunu almak için kullanın SocketException.ErrorCode . Bu kodu aldıktan sonra hatanın ayrıntılı açıklaması için Windows Sockets sürüm 2 API hata kodu belgelerine bakın.

UdpClient(String, Int32)

Kaynak:

UDPClient.cs

Sınıfının yeni bir örneğini UdpClient başlatır ve varsayılan bir uzak konak oluşturur.

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)

Parametreler

hostname

String

Bağlanmak istediğiniz uzak DNS ana bilgisayarının adı.

port

Int32

Bağlanmak istediğiniz uzak bağlantı noktası numarası.

Özel durumlar

ArgumentNullException

hostname, null'e eşittir.

ArgumentOutOfRangeException

portile MinPortarasında MaxPort değildir.

SocketException

Yuvaya erişilirken bir hata oluştu.

Örnekler

Aşağıdaki örnekte, konak adı ve bağlantı noktası numarası kullanarak sınıfın UdpClient bir örneğinin nasıl oluşturulacağı gösterilmektedir.

//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

Açıklamalar

Bu oluşturucu yeni UdpClient bir başlatır ve ve hostname parametrelerini kullanarak port uzak bir konak oluşturur. Varsayılan uzak ana bilgisayar oluşturmak isteğe bağlıdır. Bu oluşturucuyu kullanırsanız, yöntemine yapılan her çağrıda Send bir uzak konak belirtmeniz gerekmez. Varsayılan uzak ana bilgisayar belirtilmesi sizi yalnızca bu konakla sınırlar. Yöntemini çağırarak Connect istediğiniz zaman varsayılan uzak konağı değiştirebilirsiniz. yöntemine yaptığınız çağrıda Send uzak bir konak belirtmek istiyorsanız, bu oluşturucuyu kullanmayın.

Note

bir alırsanız, belirli bir SocketExceptionhata kodunu almak için kullanın SocketException.ErrorCode . Bu kodu aldıktan sonra, hatanın ayrıntılı açıklaması için Windows Yuvaları sürüm 2 API hata kodu belgelerine başvurabilirsiniz.

Ayrıca bkz.

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