UdpClient.SendAsync Yöntem

Tanım

Ad Alanı:

System.Net.Sockets

Bütünleştirilmiş Kod:

System.Net.Sockets.dll

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

Aşırı Yüklemeler

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

dgram, null değeridir.

InvalidOperationException

UdpClient zaten bir varsayılan uzak ana bilgisayar oluşturmağa sahiptir.

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

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, görevin içinde depolar ve yöntemin zaman uyumlu karşılık geleninin atabileceği tüm kullanım dışı özel durumları döndürür. Döndürülen görevde bir özel durum depolanırsa, görev beklenirken bu özel durum oluşturulur. gibi ArgumentExceptionkullanım özel durumları yine zaman uyumlu olarak oluşturulur. Depolanan özel durumlar için tarafından oluşan Send(Byte[], Int32)ö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öndermek istediğiniz UDP veri biriminin belirtildiği TürByte.

cancellationToken

CancellationToken

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

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

Döndürülenler

Task<Int32>

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

Özel durumlar

ArgumentNullException

dgram, null değeridir.

InvalidOperationException

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

ObjectDisposedException

UdpClient kapalıdır.

SocketException

Yuvaya erişilirken bir hata oluştu.

Açıklamalar

Bu yöntem, belirtilen uç noktaya veri birimleri 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 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ı bir açıklaması için Windows Yuvaları sürüm 2 API hata kodu belgelerine bakabilirsiniz.

Bu yöntem, görevin içinde depolar ve yöntemin zaman uyumlu karşılık geleninin atabileceği tüm kullanım dışı özel durumları döndürür. Döndürülen görevde bir özel durum depolanırsa, görev beklenirken bu özel durum oluşturulur. gibi ArgumentExceptionkullanım özel durumları yine zaman uyumlu olarak oluşturulur. Depolanan özel durumlar için tarafından oluşan Send(Byte[], Int32, IPEndPoint)ö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öndermek istediğiniz UDP veri biriminin belirtildiği TürByte.

endPoint

IPEndPoint

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

cancellationToken

CancellationToken

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

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şturmsa da 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

dgram, null değeridir.

InvalidOperationException

UdpClient zaten bir varsayılan uzak ana bilgisayar oluşturmağa sahiptir.

ObjectDisposedException

Kapalı UdpClient .

SocketException

Yuvaya erişilirken bir hata oluştu.

Açıklamalar

Bu yöntem, ve port parametreleri tarafından hostname belirtilen değerlere 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ı bir açıklaması için Windows Yuvaları sürüm 2 API hata kodu belgelerine bakabilirsiniz.

Bu yöntem, görevin içinde depolar ve yöntemin zaman uyumlu karşılık geleninin atabileceği tüm kullanım dışı özel durumları döndürür. Döndürülen görevde bir özel durum depolanırsa, görev beklenirken bu özel durum oluşturulur. gibi ArgumentExceptionkullanım özel durumları yine zaman uyumlu olarak oluşturulur. Depolanan özel durumlar için tarafından oluşan Send(Byte[], Int32, String, Int32)ö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öndermek istediğiniz 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'tur.

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şturmağa sahiptir.

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.