UdpClient.Send Yöntem

Tanım

Ad Alanı:

System.Net.Sockets

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Net.Sockets.dll

Uzak bir konağa UDP veri birimi gönderir.

Aşırı Yüklemeler

Name	Description
Send(Byte[], Int32, String, Int32)	Belirtilen uzak konakta belirtilen bir bağlantı noktasına 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(Byte[], Int32, IPEndPoint)	Belirtilen uzak uç noktadaki konağa bir UDP veri birimi gönderir.
Send(Byte[], Int32)	Uzak bir konağa UDP veri birimi gönderir.
Send(ReadOnlySpan<Byte>)	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(Byte[], Int32, String, Int32)

Kaynak:

UDPClient.cs

Belirtilen uzak konakta belirtilen bir bağlantı noktasına UDP veri birimi gönderir.

public:
 int Send(cli::array <System::Byte> ^ dgram, int bytes, System::String ^ hostname, int port);

public int Send(byte[] dgram, int bytes, string? hostname, int port);

member this.Send : byte[] * int * string * int -> int

Public Function Send (dgram As Byte(), bytes As Integer, hostname As String, port As Integer) As Integer

Parametreler

dgram

Byte[]

Göndermeyi planladığınız UDP veri biriminin bayt dizisi olarak temsil edilen bir tür Byte dizisi.

bytes

Int32

Veri birimindeki bayt sayısı.

hostname

String

Veri birimi göndermek istediğiniz uzak konağın adı.

port

Int32

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

Döndürülenler

Int32

Gönderilen bayt sayısı.

Özel durumlar

ArgumentNullException

dgram, null'e eşittir.

InvalidOperationException

UdpClient zaten bir varsayılan uzak konak oluşturms.

ObjectDisposedException

Kapalı UdpClient .

SocketException

Yuvaya erişilirken bir hata oluştu.

Örnekler

Aşağıdaki örnekte yöntemi gösterilmektedir Send . Bu örnekte, hedef konağı tanımlamak için bir konak adı ve bağlantı noktası numarası kullanılır.

UdpClient udpClient = new UdpClient();

Byte[] sendBytes = Encoding.ASCII.GetBytes("Is anybody there");
try{
    udpClient.Send(sendBytes, sendBytes.Length, "www.contoso.com", 11000);
}
catch ( Exception e ){
    Console.WriteLine(e.ToString());	
}

Dim udpClient As New UdpClient()

Dim sendBytes As [Byte]() = Encoding.ASCII.GetBytes("Is anybody there")
Try
   udpClient.Send(sendBytes, sendBytes.Length, "www.contoso.com", 11000)
Catch e As Exception
   Console.WriteLine(e.ToString())
End Try

Açıklamalar

yöntemi, Send ve port parametreleri tarafından hostname belirtilen değerlere veri birimleri gönderir ve başarıyla gönderilen bayt sayısını döndürür. Parametre değeri için "255.255.255.255" belirterek veri birimlerini hostname varsayılan yayın adresine gönderebilirsiniz.

Veri birimlerini başka bir yayın adresine göndermek istiyorsanız, yöntemini kullanarak Client temel alınan Socketöğesini alın ve yuva seçeneğini olarak SocketOptionName.Broadcastayarlayın. Sınıfını kullanmaya Socket da geri dönebilirsiniz.

Uyarı

yöntemiyle zaten bir uzak konak oluşturduysanız, bu yönteme bir konak adı veya bağlantı noktası numarası eklemeyin Connect . Bunu yaparsanız, Send yöntemi bir SocketExceptionoluşturur. 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.

• Broadcast
• Connect(String, Int32)
• Socket

Send(ReadOnlySpan<Byte>, String, Int32)

Kaynak:

UDPClient.cs

Belirtilen uzak konakta belirtilen bir bağlantı noktasına UDP veri birimi gönderir.

public:
 int Send(ReadOnlySpan<System::Byte> datagram, System::String ^ hostname, int port);

public int Send(ReadOnlySpan<byte> datagram, string? hostname, int port);

member this.Send : ReadOnlySpan<byte> * string * int -> int

Public Function Send (datagram As ReadOnlySpan(Of Byte), hostname As String, port As Integer) As Integer

Parametreler

datagram

ReadOnlySpan<Byte>

ReadOnlySpan<T> Göndermeyi planladığınız UDP veri biriminin belirtildiği TürByte.

hostname

String

Veri birimi göndermek istediğiniz uzak konağın adı.

port

Int32

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

Döndürülenler

Int32

Gönderilen bayt sayısı.

Özel durumlar

InvalidOperationException

UdpClient zaten bir varsayılan uzak konak oluşturms.

ObjectDisposedException

Kapalı UdpClient .

SocketException

Yuvaya erişilirken bir hata oluştu.

Send(Byte[], Int32, IPEndPoint)

Kaynak:

UDPClient.cs

Belirtilen uzak uç noktadaki konağa bir UDP veri birimi gönderir.

public:
 int Send(cli::array <System::Byte> ^ dgram, int bytes, System::Net::IPEndPoint ^ endPoint);

public int Send(byte[] dgram, int bytes, System.Net.IPEndPoint? endPoint);

member this.Send : byte[] * int * System.Net.IPEndPoint -> int

Public Function Send (dgram As Byte(), bytes As Integer, endPoint As IPEndPoint) As Integer

Parametreler

dgram

Byte[]

Göndermek istediğiniz UDP veri biriminin bayt dizisi olarak temsil edilen bir tür Byte dizisi.

bytes

Int32

Veri birimindeki bayt sayısı.

endPoint

IPEndPoint

IPEndPoint Veri biriminin gönderildiği konağı ve bağlantı noktasını temsil eden.

Döndürülenler

Int32

Gönderilen bayt sayısı.

Özel durumlar

ArgumentNullException

dgram, null'e eşittir.

InvalidOperationException

UdpClient zaten bir varsayılan uzak ana bilgisayar oluşturmuş.

ObjectDisposedException

UdpClient kapalıdır.

SocketException

Yuvaya erişilirken bir hata oluştu.

Örnekler

Aşağıdaki örnekte yöntemi gösterilmektedir Send . Bu örnekte hedef konağı belirtmek için bir IPEndPoint kullanılır.

UdpClient udpClient = new UdpClient();
IPAddress ipAddress = Dns.Resolve("www.contoso.com").AddressList[0];
IPEndPoint ipEndPoint = new IPEndPoint(ipAddress, 11004);	

Byte[] sendBytes = Encoding.ASCII.GetBytes("Is anybody there?");
try{
    udpClient.Send(sendBytes, sendBytes.Length, ipEndPoint);
}
catch ( Exception e ){
    Console.WriteLine(e.ToString());	
}

Dim udpClient As New UdpClient()
Dim ipAddress As IPAddress = Dns.Resolve("www.contoso.com").AddressList(0)
Dim ipEndPoint As New IPEndPoint(ipAddress, 11004)

Dim sendBytes As [Byte]() = Encoding.ASCII.GetBytes("Is anybody there?")
Try
   udpClient.Send(sendBytes, sendBytes.Length, ipEndPoint)
Catch e As Exception
   Console.WriteLine(e.ToString())
End Try

Açıklamalar

yöntemi belirtilen Send uç noktaya veri birimleri gönderir ve başarıyla gönderilen bayt sayısını döndürür. Bu aşırı yüklemeyi çağırmadan önce, veri birimlerinizin teslim edeceği uzak konağın IP adresini ve bağlantı noktası numarasını kullanarak bir IPEndPoint oluşturmanız gerekir. özelliğini IPEndPointbelirterek SocketOptionName.BroadcastAddress veri birimlerini varsayılan yayın adresi olan 255.255.255.255'e gönderebilirsiniz. Bunu IPEndPointoluşturduktan sonra parametresi olarak yöntemine SendendPoint geçirin.

Veri birimlerini başka bir yayın adresine göndermek istiyorsanız, yöntemini kullanarak Client temel alınan Socketöğesini alın ve yuva seçeneğini olarak SocketOptionName.Broadcastayarlayın. Sınıfını kullanmaya Socket da geri dönebilirsiniz.

Uyarı

yöntemiyle zaten bir endPoint uzak konak oluşturduysanız bu yönteme bir parametre sağlamayın Connect . Bunu yaparsanız, Send yöntemi bir SocketExceptionoluşturur. 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.

• Broadcast
• Connect(String, Int32)
• Socket
• IPEndPoint

Send(Byte[], Int32)

Kaynak:

UDPClient.cs

Uzak bir konağa UDP veri birimi gönderir.

public:
 int Send(cli::array <System::Byte> ^ dgram, int bytes);

public int Send(byte[] dgram, int bytes);

member this.Send : byte[] * int -> int

Public Function Send (dgram As Byte(), bytes As Integer) As Integer

Parametreler

dgram

Byte[]

Göndermeyi planladığınız UDP veri biriminin bayt dizisi olarak temsil edilen bir tür Byte dizisi.

bytes

Int32

Veri birimindeki bayt sayısı.

Döndürülenler

Int32

Gönderilen bayt sayısı.

Özel durumlar

ArgumentNullException

dgram, null'e eşittir.

InvalidOperationException

UdpClient zaten bir varsayılan uzak konak oluşturms.

ObjectDisposedException

Kapalı UdpClient .

SocketException

Yuvaya erişilirken bir hata oluştu.

Örnekler

Aşağıdaki örnekte yöntemi gösterilmektedir Send . Bu aşırı yüklemeyi kullanmadan önce varsayılan bir uzak konak oluşturmanız gerekir.

UdpClient udpClient = new UdpClient("www.contoso.com", 11000);
Byte[] sendBytes = Encoding.ASCII.GetBytes("Is anybody there");
try{
    udpClient.Send(sendBytes, sendBytes.Length);
}
catch ( Exception e ){
    Console.WriteLine( e.ToString());
}

Dim udpClient As New UdpClient("www.contoso.com", 11000)
Dim sendBytes As [Byte]() = Encoding.ASCII.GetBytes("Is anybody there")
Try
   udpClient.Send(sendBytes, sendBytes.Length)
Catch e As Exception
   Console.WriteLine(e.ToString())
End Try

Açıklamalar

Bu aşırı yükleme yönteminde Connect oluşturulan uzak konağa veri birimleri gönderir ve gönderilen bayt sayısını döndürür. Bu aşırı yüklemeyi çağırmadan önce çağırmazsanız Connect , Send yöntemi bir SocketExceptionoluşturur. 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.

Veri birimlerini farklı bir uzak konağa göndermek istiyorsanız yöntemini çağırmanız Connect ve istenen uzak konağı belirtmeniz gerekir. Veri birimlerini bir yayın adresine göndermek için diğer Send yöntem aşırı yüklemelerinden birini kullanın.

Ayrıca bkz.

• Connect(String, Int32)

Send(ReadOnlySpan<Byte>)

Kaynak:

UDPClient.cs

Uzak bir konağa UDP veri birimi gönderir.

public:
 int Send(ReadOnlySpan<System::Byte> datagram);

public int Send(ReadOnlySpan<byte> datagram);

member this.Send : ReadOnlySpan<byte> -> int

Public Function Send (datagram As ReadOnlySpan(Of Byte)) As Integer

Parametreler

datagram

ReadOnlySpan<Byte>

ReadOnlySpan<T> Göndermeyi planladığınız UDP veri biriminin belirtildiği TürByte.

Döndürülenler

Int32

Gönderilen bayt sayısı.

Özel durumlar

InvalidOperationException

UdpClient varsayılan uzak ana bilgisayar oluşturmadı.

ObjectDisposedException

Kapalı UdpClient .

SocketException

Yuvaya erişilirken bir hata oluştu.

Send(ReadOnlySpan<Byte>, IPEndPoint)

Kaynak:

UDPClient.cs

Belirtilen uzak uç noktadaki konağa bir UDP veri birimi gönderir.

public:
 int Send(ReadOnlySpan<System::Byte> datagram, System::Net::IPEndPoint ^ endPoint);

public int Send(ReadOnlySpan<byte> datagram, System.Net.IPEndPoint? endPoint);

member this.Send : ReadOnlySpan<byte> * System.Net.IPEndPoint -> int

Public Function Send (datagram As ReadOnlySpan(Of Byte), endPoint As IPEndPoint) As Integer

Parametreler

datagram

ReadOnlySpan<Byte>

ReadOnlySpan<T> Göndermeyi planladığınız UDP veri biriminin belirtildiği TürByte.

endPoint

IPEndPoint

IPEndPoint Veri biriminin gönderildiği konağı ve bağlantı noktasını temsil eden.

Döndürülenler

Int32

Gönderilen bayt sayısı.

Özel durumlar

InvalidOperationException

UdpClient zaten bir varsayılan uzak ana bilgisayar oluşturmuş ve endPoint değildir null.

ObjectDisposedException

UdpClient kapalıdır.

SocketException

Yuvaya erişilirken bir hata oluştu.