UdpClient Sınıf

Tanım

Ad Alanı:

System.Net.Sockets

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Net.Sockets.dll

Kaynak:

UDPClient.cs

Kullanıcı Veri Birimi Protokolü (UDP) ağ hizmetleri sağlar.

public ref class UdpClient : IDisposable

public class UdpClient : IDisposable

type UdpClient = class
    interface IDisposable

Public Class UdpClient
Implements IDisposable

Devralma

Object

UdpClient

Uygulamalar

IDisposable

Örnekler

Aşağıdaki örnek, bağlantı noktası 11000'de ana bilgisayar adını UdpClient kullanarak bir www.contoso.com bağlantı kurar. İki ayrı uzak konak makinesine küçük bir dize iletisi gönderilir. yöntemi, Receive bir ileti alınana kadar yürütmeyi engeller. IPEndPoint için geçirilen Receivekullanılarak, yanıtlayan konağın kimliği gösterilir.

// This constructor arbitrarily assigns the local port number.
UdpClient udpClient = new UdpClient(11000);
    try{
         udpClient.Connect("www.contoso.com", 11000);

         // Sends a message to the host to which you have connected.
         Byte[] sendBytes = Encoding.ASCII.GetBytes("Is anybody there?");

         udpClient.Send(sendBytes, sendBytes.Length);

         // Sends a message to a different host using optional hostname and port parameters.
         UdpClient udpClientB = new UdpClient();
         udpClientB.Send(sendBytes, sendBytes.Length, "AlternateHostMachineName", 11000);

         //IPEndPoint object will allow us to read datagrams sent from any source.
         IPEndPoint RemoteIpEndPoint = new IPEndPoint(IPAddress.Any, 0);

         // Blocks until a message returns on this socket from a remote host.
         Byte[] receiveBytes = udpClient.Receive(ref RemoteIpEndPoint);
         string returnData = Encoding.ASCII.GetString(receiveBytes);

         // Uses the IPEndPoint object to determine which of these two hosts responded.
         Console.WriteLine("This is the message you received " +
                                      returnData.ToString());
         Console.WriteLine("This message was sent from " +
                                     RemoteIpEndPoint.Address.ToString() +
                                     " on their port number " +
                                     RemoteIpEndPoint.Port.ToString());

          udpClient.Close();
          udpClientB.Close();
          }
       catch (Exception e ) {
                  Console.WriteLine(e.ToString());
        }

     ' This constructor arbitrarily assigns the local port number.
     Dim udpClient As New UdpClient(11000)
     Try
        udpClient.Connect("www.contoso.com", 11000)
        
        ' Sends a message to the host to which you have connected.
        Dim sendBytes As [Byte]() = Encoding.ASCII.GetBytes("Is anybody there?")
        
        udpClient.Send(sendBytes, sendBytes.Length)
        
        ' Sends message to a different host using optional hostname and port parameters.
        Dim udpClientB As New UdpClient()
        udpClientB.Send(sendBytes, sendBytes.Length, "AlternateHostMachineName", 11000)
        
        ' IPEndPoint object will allow us to read datagrams sent from any source.
        Dim RemoteIpEndPoint As New IPEndPoint(IPAddress.Any, 0)
        
        ' UdpClient.Receive blocks until a message is received from a remote host.
        Dim receiveBytes As [Byte]() = udpClient.Receive(RemoteIpEndPoint)
        Dim returnData As String = Encoding.ASCII.GetString(receiveBytes)
        
        ' Which one of these two hosts responded?
        Console.WriteLine(("This is the message you received " + _
                                      returnData.ToString()))
         Console.WriteLine(("This message was sent from " + _
                                      RemoteIpEndPoint.Address.ToString() + _ 
                                      " on their port number " + _
                                      RemoteIpEndPoint.Port.ToString()))
        udpClient.Close()
        udpClientB.Close()

     Catch e As Exception
        Console.WriteLine(e.ToString())
     End Try
  End Sub

Açıklamalar

sınıfı, UdpClient zaman uyumlu modda bağlantısız UDP veri birimleri göndermek ve almak için basit yöntemler sağlar. UDP bağlantısız bir aktarım protokolü olduğundan, veri göndermeden ve almadan önce uzak konak bağlantısı kurmanız gerekmez. Ancak aşağıdaki iki yöntemden biriyle varsayılan uzak konak oluşturma seçeneğiniz vardır:

• Uzak ana bilgisayar adını ve bağlantı noktası numarasını parametre olarak kullanarak sınıfın bir örneğini UdpClient oluşturun.

• sınıfının bir örneğini UdpClient oluşturun ve yöntemini çağırın Connect .

Uzak bir cihaza veri göndermek için içinde UdpClient sağlanan gönderme yöntemlerinden herhangi birini kullanabilirsiniz. Receive Uzak konaklardan veri almak için yöntemini kullanın.

Note

Bir ana bilgisayar adı kullanarak veya Send zaten varsayılan bir uzak ana bilgisayar belirttiyseniz aramayınIPEndPoint. Bunu yaparsanız, UdpClient bir özel durum oluşturur.

UdpClient yöntemleri, çok noktaya yayın veri birimleri göndermenize ve almanıza da olanak sağlar. JoinMulticastGroup çok noktaya yayın grubuna abone UdpClient olmak için yöntemini kullanın. DropMulticastGroup Çok noktaya yayın grubundan aboneliğini UdpClient kaldırmak için yöntemini kullanın.

Oluşturucular

Name	Description
UdpClient()	UdpClient sınıfının yeni bir örneğini başlatır.
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(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(String, Int32)	Sınıfının yeni bir örneğini UdpClient başlatır ve varsayılan bir uzak konak oluşturur.

Özellikler

Name	Description
Active	Varsayılan uzak konağın oluşturulup oluşturulmadığını belirten bir değer alır veya ayarlar.
Available	Ağdan alınan ve okunabilen veri miktarını alır.
Client	Temel ağı Socketalır veya ayarlar.
DontFragment	İnternet Protokolü (IP) veri birimlerinin Boolean parçalanıp parçalanmayacağını belirten bir UdpClient değer alır veya ayarlar.
EnableBroadcast	Yayın paketlerini gönderip gönderemeyeceğini Boolean belirten bir UdpClient değer alır veya ayarlar.
ExclusiveAddressUse	yalnızca bir Boolean istemcinin bağlantı noktası kullanmasına izin verip vermediğini UdpClient belirten bir değer alır veya ayarlar.
MulticastLoopback	Giden çok noktaya yayın paketlerinin gönderen uygulamaya teslim edilip edilmeyeceğini belirten bir Boolean değer alır veya ayarlar.
Ttl	tarafından UdpClientgönderilen İnternet Protokolü (IP) paketlerinin Yaşam Süresi (TTL) değerini belirten bir değer alır veya ayarlar.

Yöntemler

Name	Description
AllowNatTraversal(Boolean)	Bir UdpClient örnekte Ağ Adresi Çevirisi (NAT) geçişi etkinleştirir veya devre dışı bırakır.
BeginReceive(AsyncCallback, Object)	Uzak konaktan zaman uyumsuz olarak bir veri birimi alır.
BeginSend(Byte[], Int32, AsyncCallback, Object)	Zaman uyumsuz olarak uzak bir konağa veri birimi gönderir. Hedef daha önce çağrısıyla Connectbelirtildi.
BeginSend(Byte[], Int32, IPEndPoint, AsyncCallback, Object)	Bir hedefe zaman uyumsuz olarak bir veri birimi gönderir. Hedef, tarafından EndPointbelirtilir.
BeginSend(Byte[], Int32, String, Int32, AsyncCallback, Object)	Bir hedefe zaman uyumsuz olarak bir veri birimi gönderir. Hedef, ana bilgisayar adı ve bağlantı noktası numarasıyla belirtilir.
Close()	UDP bağlantısını kapatır.
Connect(IPAddress, Int32)	Belirtilen IP adresini ve bağlantı noktası numarasını kullanarak varsayılan bir uzak konak oluşturur.
Connect(IPEndPoint)	Belirtilen ağ uç noktasını kullanarak varsayılan bir uzak konak oluşturur.
Connect(String, Int32)	Belirtilen ana bilgisayar adını ve bağlantı noktası numarasını kullanarak varsayılan bir uzak konak oluşturur.
Dispose()	tarafından UdpClientkullanılan yönetilen ve yönetilmeyen kaynakları serbest bırakır.
Dispose(Boolean)	tarafından UdpClient kullanılan yönetilmeyen kaynakları serbest bırakır ve isteğe bağlı olarak yönetilen kaynakları serbest bırakır.
DropMulticastGroup(IPAddress, Int32)	Çok noktaya yayın grubundan ayrılır.
DropMulticastGroup(IPAddress)	Çok noktaya yayın grubundan ayrılır.
EndReceive(IAsyncResult, IPEndPoint)	Bekleyen zaman uyumsuz alma işlemini sonlandırır.
EndSend(IAsyncResult)	Bekleyen zaman uyumsuz göndermeyi sonlandırır.
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetType()	Geçerli örneğin Type alır. (Devralındığı yer: Object)
JoinMulticastGroup(Int32, IPAddress)	Çok noktaya yayın grubuna ekler UdpClient .
JoinMulticastGroup(IPAddress, Int32)	UdpClient Belirtilen Yaşam Süresi (TTL) ile bir çok noktaya yayın grubuna ekler.
JoinMulticastGroup(IPAddress, IPAddress)	Çok noktaya yayın grubuna ekler UdpClient .
JoinMulticastGroup(IPAddress)	Çok noktaya yayın grubuna ekler UdpClient .
MemberwiseClone()	Geçerli Objectbasit bir kopyasını oluşturur. (Devralındığı yer: Object)
Receive(IPEndPoint)	Uzak bir konak tarafından gönderilen bir UDP veri birimi döndürür.
ReceiveAsync()	Uzak bir konak tarafından gönderilen bir UDP veri birimi zaman uyumsuz olarak döndürür.
ReceiveAsync(CancellationToken)	Uzak bir konak tarafından gönderilen bir UDP veri birimi zaman uyumsuz olarak döndürür.
Send(Byte[], Int32, IPEndPoint)	Belirtilen uzak uç noktadaki konağa bir UDP veri birimi gönderir.
Send(Byte[], Int32, String, Int32)	Belirtilen uzak konakta belirtilen bir bağlantı noktasına UDP veri birimi gönderir.
Send(Byte[], Int32)	Uzak bir konağa UDP veri birimi gönderir.
Send(ReadOnlySpan<Byte>, IPEndPoint)	Belirtilen uzak uç noktadaki konağa bir UDP veri birimi gönderir.
Send(ReadOnlySpan<Byte>, String, Int32)	Belirtilen uzak konakta belirtilen bir bağlantı noktasına UDP veri birimi gönderir.
Send(ReadOnlySpan<Byte>)	Uzak bir konağa UDP veri birimi gönderir.
SendAsync(Byte[], Int32, IPEndPoint)	Uzak bir konağa zaman uyumsuz olarak bir UDP veri birimi gönderir.
SendAsync(Byte[], Int32, String, Int32)	Uzak bir konağa zaman uyumsuz olarak bir UDP veri birimi gönderir.
SendAsync(Byte[], Int32)	Uzak bir konağa zaman uyumsuz olarak bir UDP veri birimi gönderir.
SendAsync(ReadOnlyMemory<Byte>, CancellationToken)	Uzak bir konağa zaman uyumsuz olarak bir UDP veri birimi gönderir.
SendAsync(ReadOnlyMemory<Byte>, IPEndPoint, CancellationToken)	Uzak bir konağa zaman uyumsuz olarak bir UDP veri birimi gönderir.
SendAsync(ReadOnlyMemory<Byte>, String, Int32, CancellationToken)	Uzak bir konağa zaman uyumsuz olarak bir UDP veri birimi gönderir.
ToString()	Geçerli nesneyi temsil eden bir dize döndürür. (Devralındığı yer: Object)

Ayrıca bkz.

• TcpClient
• TCP-UDP