UdpClient.SendAsync Méthode

Définition

Espace de noms:

System.Net.Sockets

Assemblys:

netstandard.dll, System.Net.Sockets.dll

Envoie de façon asynchrone un datagramme UDP à un hôte distant.

Surcharges

Nom	Description
SendAsync(Byte[], Int32)	Envoie de façon asynchrone un datagramme UDP à un hôte distant.
SendAsync(ReadOnlyMemory<Byte>, CancellationToken)	Envoie de façon asynchrone un datagramme UDP à un hôte distant.
SendAsync(Byte[], Int32, IPEndPoint)	Envoie de façon asynchrone un datagramme UDP à un hôte distant.
SendAsync(ReadOnlyMemory<Byte>, IPEndPoint, CancellationToken)	Envoie de façon asynchrone un datagramme UDP à un hôte distant.
SendAsync(Byte[], Int32, String, Int32)	Envoie de façon asynchrone un datagramme UDP à un hôte distant.
SendAsync(ReadOnlyMemory<Byte>, String, Int32, CancellationToken)	Envoie de façon asynchrone un datagramme UDP à un hôte distant.

SendAsync(Byte[], Int32)

Source:

UDPClient.cs

Envoie de façon asynchrone un datagramme UDP à un hôte distant.

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)

Paramètres

datagram

Byte[]

Tableau de type Byte qui spécifie le datagramme UDP que vous envisagez d’envoyer représenté sous la forme d’un tableau d’octets.

bytes

Int32

Nombre d’octets dans le datagramme.

Retours

Task<Int32>

Retourne Task<TResult>.

Exceptions

ArgumentNullException

datagram a la valeur null.

InvalidOperationException

L’hôte UdpClient distant par défaut a déjà été établi.

ObjectDisposedException

La UdpClient fermeture est terminée.

SocketException

Une erreur s’est produite lors de l’accès au socket.

Remarques

Cette surcharge envoie des datagrammes à l’hôte distant établi dans la Connect méthode. Si vous n’appelez pas avant d’appeler Connect cette surcharge, la méthode lève un SocketException. Si vous recevez un SocketException, utilisez-le SocketException.ErrorCode pour obtenir le code d’erreur spécifique. Une fois que vous avez obtenu ce code, vous pouvez consulter la documentation du code d’erreur de l’API Windows Sockets version 2 pour obtenir une description détaillée de l’erreur.

Si vous souhaitez envoyer des datagrammes à un autre hôte distant, vous devez appeler la Connect méthode et spécifier l’hôte distant souhaité. Utilisez l’une des autres SendAsync surcharges de méthode pour envoyer des datagrammes à une adresse de diffusion.

Cette méthode stocke dans la tâche toutes les exceptions non-utilisation que l’équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception est levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de façon synchrone. Pour les exceptions stockées, consultez les exceptions levées par Send(Byte[], Int32).

SendAsync(ReadOnlyMemory<Byte>, CancellationToken)

Source:

UDPClient.cs

Envoie de façon asynchrone un datagramme UDP à un hôte distant.

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)

Paramètres

datagram

ReadOnlyMemory<Byte>

Type ReadOnlyMemory<T>Byte qui spécifie le datagramme UDP que vous envisagez d’envoyer.

cancellationToken

CancellationToken

Jeton à surveiller pour les demandes d’annulation. La valeur par défaut est Aucun.

Retours

ValueTask<Int32>

Qui ValueTask<TResult> représente l’opération d’envoi asynchrone. La valeur de sa propriété Result contient le nombre d’octets envoyés.

Exceptions

ObjectDisposedException

La UdpClient fermeture est terminée.

SocketException

Une erreur s’est produite lors de l’accès au socket.

OperationCanceledException

Le jeton d’annulation a été annulé. Cette exception est stockée dans la tâche retournée.

SendAsync(Byte[], Int32, IPEndPoint)

Source:

UDPClient.cs

Envoie de façon asynchrone un datagramme UDP à un hôte distant.

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)

Paramètres

datagram

Byte[]

Tableau de type Byte qui spécifie le datagramme UDP que vous envisagez d’envoyer représenté sous la forme d’un tableau d’octets.

bytes

Int32

Nombre d’octets dans le datagramme.

endPoint

IPEndPoint

Qui IPEndPoint représente l’hôte et le port vers lesquels envoyer le datagramme.

Retours

Task<Int32>

Retourne Task<TResult>.

Exceptions

ArgumentNullException

datagram a la valeur null.

InvalidOperationException

UdpClient a déjà établi un hôte distant par défaut.

ObjectDisposedException

UdpClient est fermé.

SocketException

Une erreur s’est produite lors de l’accès au socket.

Remarques

Cette méthode envoie des datagrammes au point de terminaison spécifié. Avant d’appeler cette surcharge, vous devez d’abord créer une IPEndPoint adresse IP et le numéro de port de l’hôte distant auquel vos datagrammes seront remis. Vous pouvez envoyer des datagrammes à l’adresse de diffusion par défaut, 255.255.255.255, en spécifiant SocketOptionName.Broadcast pour la Address propriété du IPEndPoint. Une fois que vous avez créé ce IPEndPointparamètre, passez-le endPoint à cette méthode en tant que paramètre.

Si vous souhaitez envoyer des datagrammes à toute autre adresse de diffusion, utilisez la Client méthode pour obtenir l’option sous-jacente Socketet définissez l’option de socket sur SocketOptionName.Broadcast. Vous pouvez également revenir à l’utilisation de la Socket classe.

Avertissement

Ne fournissez pas de endPoint paramètre à cette méthode si vous avez déjà établi un hôte distant avec la Connect méthode. Si vous le faites, cette méthode lève un SocketException. Si vous recevez un SocketException, utilisez-le SocketException.ErrorCode pour obtenir le code d’erreur spécifique. Une fois que vous avez obtenu ce code, vous pouvez consulter la documentation du code d’erreur de l’API Windows Sockets version 2 pour obtenir une description détaillée de l’erreur.

Cette méthode stocke dans la tâche toutes les exceptions non-utilisation que l’équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception est levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de façon synchrone. Pour les exceptions stockées, consultez les exceptions levées par Send(Byte[], Int32, IPEndPoint).

SendAsync(ReadOnlyMemory<Byte>, IPEndPoint, CancellationToken)

Source:

UDPClient.cs

Envoie de façon asynchrone un datagramme UDP à un hôte distant.

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)

Paramètres

datagram

ReadOnlyMemory<Byte>

Type ReadOnlyMemory<T>Byte qui spécifie le datagramme UDP que vous envisagez d’envoyer.

endPoint

IPEndPoint

Qui IPEndPoint représente l’hôte et le port vers lesquels envoyer le datagramme.

cancellationToken

CancellationToken

Jeton à surveiller pour les demandes d’annulation. La valeur par défaut est Aucun.

Retours

ValueTask<Int32>

Qui ValueTask<TResult> représente l’opération d’envoi asynchrone. La valeur de sa propriété Result contient le nombre d’octets envoyés.

Exceptions

InvalidOperationException

UdpClient a déjà établi un hôte distant par défaut et endPoint n’est pas null.

ObjectDisposedException

La UdpClient fermeture est terminée.

SocketException

Une erreur s’est produite lors de l’accès au socket.

OperationCanceledException

Le jeton d’annulation a été annulé. Cette exception est stockée dans la tâche retournée.

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

Source:

UDPClient.cs

Envoie de façon asynchrone un datagramme UDP à un hôte distant.

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)

Paramètres

datagram

Byte[]

Tableau de type Byte qui spécifie le datagramme UDP que vous envisagez d’envoyer représenté sous la forme d’un tableau d’octets.

bytes

Int32

Nombre d’octets dans le datagramme.

hostname

String

Nom de l’hôte distant auquel vous envisagez d’envoyer le datagramme.

port

Int32

Numéro de port distant avec lequel vous envisagez de communiquer.

Retours

Task<Int32>

Retourne Task<TResult>.

Exceptions

ArgumentNullException

datagram a la valeur null.

InvalidOperationException

L’hôte UdpClient distant par défaut a déjà été établi.

ObjectDisposedException

La UdpClient fermeture est terminée.

SocketException

Une erreur s’est produite lors de l’accès au socket.

Remarques

Cette méthode envoie des datagrammes aux valeurs spécifiées par les paramètres et port les hostname paramètres. Vous pouvez envoyer des datagrammes à l’adresse de diffusion par défaut en spécifiant « 255.255.255.255 » pour la valeur du hostname paramètre.

Si vous souhaitez envoyer des datagrammes à toute autre adresse de diffusion, utilisez la Client méthode pour obtenir l’option sous-jacente Socketet définissez l’option de socket sur SocketOptionName.Broadcast. Vous pouvez également revenir à l’utilisation de la Socket classe.

Avertissement

Ne fournissez pas de nom d’hôte ou de numéro de port à cette méthode si vous avez déjà établi un hôte distant avec la Connect méthode. Si vous le faites, cette méthode lève un SocketException. Si vous recevez un SocketException, utilisez-le SocketException.ErrorCode pour obtenir le code d’erreur spécifique. Une fois que vous avez obtenu ce code, vous pouvez consulter la documentation du code d’erreur de l’API Windows Sockets version 2 pour obtenir une description détaillée de l’erreur.

Cette méthode stocke dans la tâche toutes les exceptions non-utilisation que l’équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception est levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de façon synchrone. Pour les exceptions stockées, consultez les exceptions levées par Send(Byte[], Int32, String, Int32).

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

Source:

UDPClient.cs

Envoie de façon asynchrone un datagramme UDP à un hôte distant.

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)

Paramètres

datagram

ReadOnlyMemory<Byte>

Type ReadOnlyMemory<T>Byte qui spécifie le datagramme UDP que vous envisagez d’envoyer.

hostname

String

Nom de l’hôte distant auquel vous envisagez d’envoyer le datagramme.

port

Int32

Numéro de port distant avec lequel vous envisagez de communiquer.

cancellationToken

CancellationToken

Jeton à surveiller pour les demandes d’annulation. La valeur par défaut est Aucun.

Retours

ValueTask<Int32>

Qui ValueTask<TResult> représente l’opération d’envoi asynchrone. La valeur de sa propriété Result contient le nombre d’octets envoyés.

Exceptions

InvalidOperationException

L’hôte UdpClient distant par défaut a déjà été établi.

ObjectDisposedException

La UdpClient fermeture est terminée.

SocketException

Une erreur s’est produite lors de l’accès au socket.

OperationCanceledException

Le jeton d’annulation a été annulé. Cette exception est stockée dans la tâche retournée.