UdpClient.SendAsync Yöntem

Tanım

Ad Alanı:

System.Net.Sockets

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Net.Sockets.dll

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

Aşırı Yüklemeler

Name	Description
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(Byte[], Int32, IPEndPoint)	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(Byte[], Int32, String, Int32)	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.

SendAsync(Byte[], Int32)

Kaynak:

UDPClient.cs

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

public:
 System::Threading::Tasks::Task<int> ^ SendAsync(cli::array <System::Byte> ^ datagram, int bytes);

public System.Threading.Tasks.Task<int> SendAsync(byte[] datagram, int bytes);

member this.SendAsync : byte[] * int -> System.Threading.Tasks.Task<int>

Public Function SendAsync (datagram As Byte(), bytes As Integer) As Task(Of Integer)

Parametreler

datagram

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

Task<Int32>

Task<TResult> döndürür.

Özel durumlar

ArgumentNullException

datagram, 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.

Açıklamalar

Bu aşırı yükleme yönteminde Connect oluşturulan uzak konağa veri birimleri gönderir. Bu aşırı yüklemeyi çağırmadan önce çağırmazsanız Connect , 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 SendAsync yöntem aşırı yüklemelerinden birini kullanın.

Bu yöntem, yöntemin zaman uyumlu karşılık geleninin oluşturabileceği tüm kullanım dışı özel durumları döndürdüğü görevde depolar. Döndürülen görevde bir özel durum depolanırsa, görev beklendiğinde bu özel durum oluşturulur. ArgumentExceptiongibi kullanım özel durumları hâlâ eşzamanlı olarak fırlatılır. Depolanan özel durumlar için tarafından Send(Byte[], Int32)oluşan özel durumlara bakın.

SendAsync(ReadOnlyMemory<Byte>, CancellationToken)

Kaynak:

UDPClient.cs

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

public System.Threading.Tasks.ValueTask<int> SendAsync(ReadOnlyMemory<byte> datagram, System.Threading.CancellationToken cancellationToken = default);

member this.SendAsync : ReadOnlyMemory<byte> * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<int>

Public Function SendAsync (datagram As ReadOnlyMemory(Of Byte), Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Integer)

Parametreler

datagram

ReadOnlyMemory<Byte>

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

cancellationToken

CancellationToken

İptal isteklerini izlemek için belirteç. Varsayılan değer Yok değeridir.

Döndürülenler

ValueTask<Int32>

ValueTask<TResult> Zaman uyumsuz gönderme işlemini temsil eden bir. Result özelliğinin değeri gönderilen bayt sayısını içerir.

Özel durumlar

ObjectDisposedException

Kapalı UdpClient .

SocketException

Yuvaya erişilirken bir hata oluştu.

OperationCanceledException

İptal belirteci iptal edildi. Bu özel durum, döndürülen görevde depolanır.

SendAsync(Byte[], Int32, IPEndPoint)

Kaynak:

UDPClient.cs

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

public:
 System::Threading::Tasks::Task<int> ^ SendAsync(cli::array <System::Byte> ^ datagram, int bytes, System::Net::IPEndPoint ^ endPoint);

public System.Threading.Tasks.Task<int> SendAsync(byte[] datagram, int bytes, System.Net.IPEndPoint? endPoint);

member this.SendAsync : byte[] * int * System.Net.IPEndPoint -> System.Threading.Tasks.Task<int>

Public Function SendAsync (datagram As Byte(), bytes As Integer, endPoint As IPEndPoint) As Task(Of Integer)

Parametreler

datagram

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

endPoint

IPEndPoint

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

Döndürülenler

Task<Int32>

Task<TResult> döndürür.

Özel durumlar

ArgumentNullException

datagram, 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.

Açıklamalar

Bu yöntem veri birimlerini belirtilen uç noktaya gönderir. 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 bu yönteme endPoint 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, bu yöntem 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.

Bu yöntem, yöntemin zaman uyumlu karşılık geleninin oluşturabileceği tüm kullanım dışı özel durumları döndürdüğü görevde depolar. Döndürülen görevde bir özel durum depolanırsa, görev beklendiğinde bu özel durum oluşturulur. ArgumentExceptiongibi kullanım özel durumları hâlâ eşzamanlı olarak fırlatılır. Depolanan özel durumlar için tarafından Send(Byte[], Int32, IPEndPoint)oluşan özel durumlara bakın.

SendAsync(ReadOnlyMemory<Byte>, IPEndPoint, CancellationToken)

Kaynak:

UDPClient.cs

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

public System.Threading.Tasks.ValueTask<int> SendAsync(ReadOnlyMemory<byte> datagram, System.Net.IPEndPoint? endPoint, System.Threading.CancellationToken cancellationToken = default);

member this.SendAsync : ReadOnlyMemory<byte> * System.Net.IPEndPoint * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<int>

Public Function SendAsync (datagram As ReadOnlyMemory(Of Byte), endPoint As IPEndPoint, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Integer)

Parametreler

datagram

ReadOnlyMemory<Byte>

ReadOnlyMemory<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.

cancellationToken

CancellationToken

İptal isteklerini izlemek için belirteç. Varsayılan değer Yok değeridir.

Döndürülenler

ValueTask<Int32>

ValueTask<TResult> Zaman uyumsuz gönderme işlemini temsil eden bir. Result özelliğinin değeri gönderilen bayt sayısını içerir.

Özel durumlar

InvalidOperationException

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

ObjectDisposedException

Kapalı UdpClient .

SocketException

Yuvaya erişilirken bir hata oluştu.

OperationCanceledException

İptal belirteci iptal edildi. Bu özel durum, döndürülen görevde depolanır.

SendAsync(Byte[], Int32, String, Int32)

Kaynak:

UDPClient.cs

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

public:
 System::Threading::Tasks::Task<int> ^ SendAsync(cli::array <System::Byte> ^ datagram, int bytes, System::String ^ hostname, int port);

public System.Threading.Tasks.Task<int> SendAsync(byte[] datagram, int bytes, string? hostname, int port);

member this.SendAsync : byte[] * int * string * int -> System.Threading.Tasks.Task<int>

Public Function SendAsync (datagram As Byte(), bytes As Integer, hostname As String, port As Integer) As Task(Of Integer)

Parametreler

datagram

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

Task<Int32>

Task<TResult> döndürür.

Özel durumlar

ArgumentNullException

datagram, 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.

Açıklamalar

Bu yöntem, ve port parametreleri tarafından belirtilen değerlere hostname veri birimleri gönderir. 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, bu yöntem 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.

Bu yöntem, yöntemin zaman uyumlu karşılık geleninin oluşturabileceği tüm kullanım dışı özel durumları döndürdüğü görevde depolar. Döndürülen görevde bir özel durum depolanırsa, görev beklendiğinde bu özel durum oluşturulur. ArgumentExceptiongibi kullanım özel durumları hâlâ eşzamanlı olarak fırlatılır. Depolanan özel durumlar için tarafından Send(Byte[], Int32, String, Int32)oluşan özel durumlara bakın.

SendAsync(ReadOnlyMemory<Byte>, String, Int32, CancellationToken)

Kaynak:

UDPClient.cs

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

public System.Threading.Tasks.ValueTask<int> SendAsync(ReadOnlyMemory<byte> datagram, string? hostname, int port, System.Threading.CancellationToken cancellationToken = default);

member this.SendAsync : ReadOnlyMemory<byte> * string * int * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<int>

Public Function SendAsync (datagram As ReadOnlyMemory(Of Byte), hostname As String, port As Integer, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Integer)

Parametreler

datagram

ReadOnlyMemory<Byte>

ReadOnlyMemory<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ı.

cancellationToken

CancellationToken

İptal isteklerini izlemek için belirteç. Varsayılan değer Yok değeridir.

Döndürülenler

ValueTask<Int32>

ValueTask<TResult> Zaman uyumsuz gönderme işlemini temsil eden bir. Result özelliğinin değeri gönderilen bayt sayısını içerir.

Özel durumlar

InvalidOperationException

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

ObjectDisposedException

Kapalı UdpClient .

SocketException

Yuvaya erişilirken bir hata oluştu.

OperationCanceledException

İptal belirteci iptal edildi. Bu özel durum, döndürülen görevde depolanır.