Bagikan melalui

UdpClient Konstruktor

  • Referensi

Definisi

Ruang nama:
System.Net.Sockets
Rakitan:
System.Net.Sockets.dll
Rakitan:
System.dll
Rakitan:
netstandard.dll

Menginisialisasi instans baru kelas UdpClient.

Overload

UdpClient()

Menginisialisasi instans baru kelas UdpClient.
UdpClient(Int32)

Menginisialisasi instans UdpClient baru kelas dan mengikatnya ke nomor port lokal yang disediakan.
UdpClient(IPEndPoint)

Menginisialisasi instans UdpClient baru kelas dan mengikatnya ke titik akhir lokal yang ditentukan.
UdpClient(AddressFamily)

Menginisialisasi instans baru kelas UdpClient.
UdpClient(Int32, AddressFamily)

Menginisialisasi instans UdpClient baru kelas dan mengikatnya ke nomor port lokal yang disediakan.
UdpClient(String, Int32)

Menginisialisasi instans UdpClient baru kelas dan membuat host jarak jauh default.

UdpClient()

Sumber:
UDPClient.cs
Sumber:
UDPClient.cs
Sumber:
UDPClient.cs

Menginisialisasi instans baru kelas UdpClient.

public:
 UdpClient();
public UdpClient ();
Public Sub New ()

Pengecualian

SocketException

Terjadi kesalahan saat mengakses soket.

Contoh

Contoh berikut menunjukkan cara menggunakan konstruktor tanpa parameter untuk membuat instans UdpClient kelas.

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

Keterangan

Konstruktor ini membuat yang baru UdpClient dan memungkinkan penyedia layanan dasar untuk menetapkan alamat IPv4 lokal dan nomor port yang paling tepat. Jika konstruktor ini digunakan, UdpClient instans diatur dengan keluarga alamat IPv4 yang tidak dapat diubah atau ditimpa oleh panggilan metode koneksi dengan target IPv6.

Catatan

Jika Anda menerima SocketException, gunakan SocketException.ErrorCode untuk mendapatkan kode kesalahan tertentu. Setelah mendapatkan kode ini, Anda dapat merujuk ke dokumentasi kode kesalahan API Windows Sockets versi 2 untuk deskripsi terperinci tentang kesalahan tersebut.

Konstruktor ini tidak cocok untuk bergabung dengan grup multicast karena tidak melakukan pengikatan soket. Selain itu, ini hanya berfungsi dengan jenis alamat IPv4.

Berlaku untuk

UdpClient(Int32)

Sumber:
UDPClient.cs
Sumber:
UDPClient.cs
Sumber:
UDPClient.cs

Menginisialisasi instans UdpClient baru kelas dan mengikatnya ke nomor port lokal yang disediakan.

public:
 UdpClient(int port);
public UdpClient (int port);
new System.Net.Sockets.UdpClient : int -> System.Net.Sockets.UdpClient
Public Sub New (port As Integer)

Parameter

port
Int32

Nomor port lokal tempat Anda ingin berkomunikasi.

Pengecualian

ArgumentOutOfRangeException

Parameter port lebih besar dari MaxPort atau kurang dari MinPort.

SocketException

Terjadi kesalahan saat mengakses soket.

Contoh

Contoh berikut menunjukkan menggunakan nomor port lokal untuk membuat instans UdpClient kelas .

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

Keterangan

Konstruktor ini membuat yang mendasar dan mengikatnya Socket ke nomor port tempat Anda ingin berkomunikasi. Gunakan konstruktor ini jika Anda hanya tertarik untuk mengatur nomor port lokal. Penyedia layanan yang mendasar akan menetapkan alamat IP lokal. Jika Anda meneruskan 0 ke konstruktor, penyedia layanan yang mendasar akan menetapkan nomor port. Jika konstruktor ini digunakan, UdpClient instans diatur dengan keluarga alamat IPv4 yang tidak dapat diubah atau ditimpa oleh panggilan metode koneksi dengan target IPv6.

Catatan

Jika Anda menerima SocketException, gunakan SocketException.ErrorCode untuk mendapatkan kode kesalahan tertentu. Setelah mendapatkan kode ini, Anda dapat merujuk ke dokumentasi kode kesalahan API Windows Sockets versi 2 untuk deskripsi terperinci tentang kesalahan tersebut.

Konstruktor ini hanya berfungsi dengan jenis alamat IPv4.

Berlaku untuk

UdpClient(IPEndPoint)

Sumber:
UDPClient.cs
Sumber:
UDPClient.cs
Sumber:
UDPClient.cs

Menginisialisasi instans UdpClient baru kelas dan mengikatnya ke titik akhir lokal yang ditentukan.

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)

Parameter

localEP
IPEndPoint

IPEndPoint Yang mewakili titik akhir lokal tempat Anda mengikat koneksi UDP.

Pengecualian

ArgumentNullException

localEPadalah null.

SocketException

Terjadi kesalahan saat mengakses soket.

Contoh

Contoh berikut menunjukkan cara membuat instans UdpClient kelas menggunakan titik akhir lokal.

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

Keterangan

Konstruktor ini membuat baru UdpClient dan mengikatnya ke IPEndPoint yang ditentukan oleh localEP parameter . Sebelum Memanggil konstruktor ini, Anda harus membuat IPEndPoint menggunakan alamat IP dan nomor port tempat Anda ingin mengirim dan menerima data. Anda tidak perlu menentukan alamat IP lokal dan nomor port untuk mengirim dan menerima data. Jika tidak, penyedia layanan yang mendasar akan menetapkan alamat IP lokal dan nomor port yang paling tepat.

Jika konstruktor ini digunakan, UdpClient instans diatur dengan keluarga alamat yang ditentukan oleh localEP parameter yang tidak dapat diubah atau ditimpa oleh panggilan metode koneksi dengan keluarga alamat yang berbeda.

Catatan

Jika Anda menerima SocketException, gunakan SocketException.ErrorCode untuk mendapatkan kode kesalahan tertentu. Setelah mendapatkan kode ini, Anda dapat merujuk ke dokumentasi kode kesalahan API Windows Sockets versi 2 untuk deskripsi terperinci tentang kesalahan tersebut.

Lihat juga

Berlaku untuk

UdpClient(AddressFamily)

Sumber:
UDPClient.cs
Sumber:
UDPClient.cs
Sumber:
UDPClient.cs

Menginisialisasi instans baru kelas 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)

Parameter

family
AddressFamily

Salah AddressFamily satu nilai yang menentukan skema alamat soket.

Pengecualian

ArgumentException

family bukan InterNetwork atau InterNetworkV6.

SocketException

Terjadi kesalahan saat mengakses soket.

Keterangan

Parameter family menentukan apakah pendengar menggunakan alamat IP versi 4 (IPv4) atau alamat IP versi 6 (IPv6). Untuk menggunakan alamat IPv4, berikan nilai .InterNetwork Untuk menggunakan alamat IPv6, berikan nilai .InterNetworkV6 Meneruskan nilai lain akan menyebabkan metode melempar ArgumentException.

Jika konstruktor ini digunakan, UdpClient instans diatur dengan keluarga alamat yang ditentukan oleh family parameter yang tidak dapat diubah atau ditimpa oleh panggilan metode koneksi dengan keluarga alamat yang berbeda.

Catatan

Jika Anda menerima SocketException, gunakan SocketException.ErrorCode untuk mendapatkan kode kesalahan tertentu. Setelah mendapatkan kode ini, Anda dapat merujuk ke dokumentasi kode kesalahan API Windows Sockets versi 2 untuk deskripsi terperinci tentang kesalahan tersebut.

UdpClient.UdpClient(AddressFamily) tidak cocok untuk bergabung dengan grup multicast karena tidak melakukan pengikatan soket.

Berlaku untuk

UdpClient(Int32, AddressFamily)

Sumber:
UDPClient.cs
Sumber:
UDPClient.cs
Sumber:
UDPClient.cs

Menginisialisasi instans UdpClient baru kelas dan mengikatnya ke nomor port lokal yang disediakan.

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)

Parameter

port
Int32

Port tempat mendengarkan upaya koneksi masuk.

family
AddressFamily

Salah AddressFamily satu nilai yang menentukan skema alamat soket.

Pengecualian

ArgumentException

family bukan InterNetwork atau InterNetworkV6.

ArgumentOutOfRangeException

port lebih besar dari MaxPort atau kurang dari MinPort.

SocketException

Terjadi kesalahan saat mengakses soket.

Contoh

Contoh kode berikut menunjukkan cara membuat klien UDP untuk digunakan dalam grup multicast.

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

Keterangan

Konstruktor ini membuat yang mendasar dan mengikatnya Socket ke nomor port tempat Anda ingin berkomunikasi.

Parameter family menentukan apakah pendengar menggunakan alamat IP versi 4 (IPv4) atau alamat IP versi 6 (IPv6). Untuk menggunakan alamat IPv4, berikan nilai .InterNetwork Untuk menggunakan alamat IPv6, berikan nilai .InterNetworkV6 Meneruskan nilai lain akan menyebabkan metode melempar ArgumentException.

Jika konstruktor ini digunakan, UdpClient instans diatur dengan keluarga alamat yang ditentukan oleh family parameter yang tidak dapat diubah atau ditimpa oleh panggilan metode koneksi dengan keluarga alamat yang berbeda.

Catatan

Jika Anda menerima SocketException, gunakan SocketException.ErrorCode untuk mendapatkan kode kesalahan tertentu. Setelah Anda mendapatkan kode ini, lihat dokumentasi kode kesalahan API Windows Sockets versi 2 untuk deskripsi terperinci tentang kesalahan tersebut.

Berlaku untuk

UdpClient(String, Int32)

Sumber:
UDPClient.cs
Sumber:
UDPClient.cs
Sumber:
UDPClient.cs

Menginisialisasi instans UdpClient baru kelas dan membuat host jarak jauh default.

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)

Parameter

hostname
String

Nama host DNS jarak jauh yang ingin Anda sambungkan.

port
Int32

Nomor port jarak jauh yang ingin Anda sambungkan.

Pengecualian

ArgumentNullException

hostnameadalah null.

ArgumentOutOfRangeException

port bukan antara MinPort dan MaxPort.

SocketException

Terjadi kesalahan saat mengakses soket.

Contoh

Contoh berikut menunjukkan cara membuat instans UdpClient kelas menggunakan nama host dan nomor port.

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

Keterangan

Konstruktor ini menginisialisasi yang baru UdpClient dan menetapkan host jarak jauh menggunakan hostname parameter dan port . Membuat host jarak jauh default bersifat opsional. Jika Anda menggunakan konstruktor ini, Anda tidak perlu menentukan host jarak jauh di setiap panggilan ke Send metode . Menentukan host jarak jauh default membatasi Anda hanya untuk host tersebut. Anda dapat mengubah host jarak jauh default kapan saja dengan memanggil Connect metode . Jika Anda ingin menentukan host jarak jauh dalam panggilan Anda ke Send metode , jangan gunakan konstruktor ini.

Catatan

Jika Anda menerima SocketException, gunakan SocketException.ErrorCode untuk mendapatkan kode kesalahan tertentu. Setelah mendapatkan kode ini, Anda dapat merujuk ke dokumentasi kode kesalahan API Windows Sockets versi 2 untuk deskripsi terperinci tentang kesalahan tersebut.

Lihat juga

Berlaku untuk