UdpClient Oluşturucular

Tanım

Ad Alanı:

System.Net.Sockets

Bütünleştirilmiş Kod:

System.Net.Sockets.dll

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

Aşırı Yüklemeler

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 uzak konağı 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 = 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()

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, UdpClient IPv6 hedefli bir bağlantı yöntemi çağrısı tarafından değiştirilemeyen veya üzerine yazılamayan bir IPv4 adres ailesi ile ayarlanır.

Not

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ı bir açıklaması için Windows Yuvaları sürüm 2 API hata kodu belgelerine bakabilirsiniz.

Bu oluşturucu, yuva bağlaması gerçekleştirmediğinden çok noktaya yayın grubunu birleştirmek 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 değerinden MaxPort büyük veya küçüktürMinPort.

SocketException

Yuvaya erişilirken bir hata oluştu.

Örnekler

Aşağıdaki örnek, sınıfının bir örneğini UdpClient oluşturmak için yerel bağlantı noktası numarası kullanmayı gösterir.

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

Açıklamalar

Bu oluşturucu bir temel oluşturur Socket 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, UdpClient IPv6 hedefli bir bağlantı yöntemi çağrısı tarafından değiştirilemeyen veya üzerine yazılamayan bir IPv4 adres ailesi ile ayarlanır.

Not

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ı bir açıklaması için Windows Yuvaları sürüm 2 API hata kodu belgelerine bakabilirsiniz.

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 değeridir.

SocketException

Yuvaya erişilirken bir hata oluştu.

Örnekler

Aşağıdaki örnekte, yerel uç nokta kullanarak sınıfının bir örneğinin UdpClient 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 = 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

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önderip 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 adres ailesi ile ayarlanır ve farklı bir adres ailesine sahip bir bağlanma yöntemi çağrısı tarafından değiştirilemez veya üzerine yazılamaz.

Not

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ı bir açıklaması için Windows Yuvaları sürüm 2 API hata kodu belgelerine bakabilirsiniz.

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 InterNetworkV6değildirInterNetwork.

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ğerini geçirin InterNetwork . IPv6 adresi kullanmak için değerini 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 adres ailesi ile ayarlanır ve farklı bir adres ailesine sahip bir bağlanma yöntemi çağrısı tarafından değiştirilemez veya üzerine yazılamaz.

Not

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ı bir açıklaması için Windows Yuvaları sürüm 2 API hata kodu belgelerine bakabilirsiniz.

UdpClient.UdpClient(AddressFamily) yuva bağlaması gerçekleştirmediğinden çok noktaya yayın grubunu birleştirmeye 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 InterNetworkV6değildirInterNetwork.

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

Açıklamalar

Bu oluşturucu bir temel oluşturur Socket 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ğerini geçirin InterNetwork . IPv6 adresi kullanmak için değerini 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 adres ailesi ile ayarlanır ve farklı bir adres ailesine sahip bir bağlanma yöntemi çağrısı tarafından değiştirilemez veya üzerine yazılamaz.

Not

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 bakın.

UdpClient(String, Int32)

Kaynak:

UDPClient.cs

sınıfının yeni bir örneğini UdpClient başlatır ve varsayılan uzak konağı 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 değeridir.

ArgumentOutOfRangeException

portile MaxPortarasında MinPort 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 bir örneğinin UdpClient 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 = 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

Açıklamalar

Bu oluşturucu yeni UdpClient bir başlatır ve ve port parametrelerini kullanarak hostname uzak bir konak oluşturur. Varsayılan uzak ana bilgisayar oluşturma 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 konağın 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 bir uzak konak belirtmek istiyorsanız, bu oluşturucuyu kullanmayın.

Not

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ı bir açıklaması için Windows Yuvaları sürüm 2 API hata kodu belgelerine bakabilirsiniz.

Ayrıca bkz.

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