UdpClient.SendAsync Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Envoie un datagramme UDP à un hôte distant de manière asynchrone.
Surcharges
| SendAsync(Byte[], Int32) |
Envoie un datagramme UDP à un hôte distant de manière asynchrone. |
| SendAsync(ReadOnlyMemory<Byte>, CancellationToken) |
Envoie un datagramme UDP à un hôte distant de manière asynchrone. |
| SendAsync(Byte[], Int32, IPEndPoint) |
Envoie un datagramme UDP à un hôte distant de manière asynchrone. |
| SendAsync(ReadOnlyMemory<Byte>, IPEndPoint, CancellationToken) |
Envoie un datagramme UDP à un hôte distant de manière asynchrone. |
| SendAsync(Byte[], Int32, String, Int32) |
Envoie un datagramme UDP à un hôte distant de manière asynchrone. |
| SendAsync(ReadOnlyMemory<Byte>, String, Int32, CancellationToken) |
Envoie un datagramme UDP à un hôte distant de manière asynchrone. |
SendAsync(Byte[], Int32)
- Source:
- UDPClient.cs
- Source:
- UDPClient.cs
- Source:
- UDPClient.cs
Envoie un datagramme UDP à un hôte distant de manière asynchrone.
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 à envoyer, représenté sous la forme d’un tableau d’octets.
- bytes
- Int32
Nombre d’octets dans le datagramme.
Retours
Retourne Task<TResult>.
Exceptions
dgram a la valeur null.
UdpClient a déjà établi un hôte distant par défaut.
Le UdpClient est fermé.
Une erreur s’est produite pendant 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 Connect pas avant d’appeler cette surcharge, la méthode lève un SocketException. Si vous recevez un SocketException, utilisez SocketException.ErrorCode pour obtenir le code d’erreur spécifique. Une fois ce code obtenu, vous pouvez vous référer à 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 de 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 sera levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de manière synchrone. Pour connaître les exceptions stockées, consultez les exceptions levées par Send(Byte[], Int32).
S’applique à
SendAsync(ReadOnlyMemory<Byte>, CancellationToken)
- Source:
- UDPClient.cs
- Source:
- UDPClient.cs
- Source:
- UDPClient.cs
Envoie un datagramme UDP à un hôte distant de manière asynchrone.
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>
de ReadOnlyMemory<T> Type Byte qui spécifie le datagramme UDP que vous envisagez d’envoyer.
- cancellationToken
- CancellationToken
Jeton pour surveiller les requêtes d'annulation. La valeur par défaut est Aucun.
Retours
ValueTask<TResult> qui représente l’opération d’envoi asynchrone. La valeur de sa propriété Result contient le nombre d’octets envoyés.
Exceptions
Le UdpClient est fermé.
Une erreur s’est produite pendant l’accès au socket.
Le jeton d’annulation a été annulé. Cette exception est stockée dans la tâche retournée.
S’applique à
SendAsync(Byte[], Int32, IPEndPoint)
- Source:
- UDPClient.cs
- Source:
- UDPClient.cs
- Source:
- UDPClient.cs
Envoie un datagramme UDP à un hôte distant de manière asynchrone.
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);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 à envoyer, représenté sous la forme d’un tableau d’octets.
- bytes
- Int32
Nombre d’octets dans le datagramme.
- endPoint
- IPEndPoint
IPEndPoint qui représente l’hôte et le port auxquels envoyer le datagramme.
Retours
Retourne Task<TResult>.
Exceptions
dgram a la valeur null.
UdpClient a déjà établi un hôte distant par défaut.
UdpClient est fermé.
Une erreur s’est produite pendant 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 un à l’aide IPEndPoint de l’adresse IP et du 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é de .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 à une autre adresse de diffusion, utilisez la méthode pour obtenir le Client sous-jacent 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èvera un SocketException. Si vous recevez un SocketException, utilisez SocketException.ErrorCode pour obtenir le code d’erreur spécifique. Une fois ce code obtenu, vous pouvez vous référer à 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 de 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 sera levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de manière synchrone. Pour connaître les exceptions stockées, consultez les exceptions levées par Send(Byte[], Int32, IPEndPoint).
S’applique à
SendAsync(ReadOnlyMemory<Byte>, IPEndPoint, CancellationToken)
- Source:
- UDPClient.cs
- Source:
- UDPClient.cs
- Source:
- UDPClient.cs
Envoie un datagramme UDP à un hôte distant de manière asynchrone.
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>
de ReadOnlyMemory<T> Type Byte qui spécifie le datagramme UDP que vous envisagez d’envoyer.
- endPoint
- IPEndPoint
IPEndPoint qui représente l’hôte et le port auxquels envoyer le datagramme.
- cancellationToken
- CancellationToken
Jeton pour surveiller les requêtes d'annulation. La valeur par défaut est Aucun.
Retours
ValueTask<TResult> qui représente l’opération d’envoi asynchrone. La valeur de sa propriété Result contient le nombre d’octets envoyés.
Exceptions
UdpClient a déjà établi un hôte distant par défaut et endPoint n’est pas null.
Le UdpClient est fermé.
Une erreur s’est produite pendant l’accès au socket.
Le jeton d’annulation a été annulé. Cette exception est stockée dans la tâche retournée.
S’applique à
SendAsync(Byte[], Int32, String, Int32)
- Source:
- UDPClient.cs
- Source:
- UDPClient.cs
- Source:
- UDPClient.cs
Envoie un datagramme UDP à un hôte distant de manière asynchrone.
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);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 à 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 voulez envoyer le datagramme.
- port
- Int32
Numéro de port distant avec lequel vous souhaitez communiquer.
Retours
Retourne Task<TResult>.
Exceptions
dgram a la valeur null.
UdpClient a déjà établi un hôte distant par défaut.
Le UdpClient est fermé.
Une erreur s’est produite pendant l’accès au socket.
Remarques
Cette méthode envoie des datagrammes aux valeurs spécifiées par les hostname paramètres et port . 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 à une autre adresse de diffusion, utilisez la méthode pour obtenir le Client sous-jacent 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èvera un SocketException. Si vous recevez un SocketException, utilisez SocketException.ErrorCode pour obtenir le code d’erreur spécifique. Une fois ce code obtenu, vous pouvez vous référer à 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 de 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 sera levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de manière synchrone. Pour connaître les exceptions stockées, consultez les exceptions levées par Send(Byte[], Int32, String, Int32).
S’applique à
SendAsync(ReadOnlyMemory<Byte>, String, Int32, CancellationToken)
- Source:
- UDPClient.cs
- Source:
- UDPClient.cs
- Source:
- UDPClient.cs
Envoie un datagramme UDP à un hôte distant de manière asynchrone.
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>
de ReadOnlyMemory<T> Type Byte qui spécifie le datagramme UDP que vous envisagez d’envoyer.
- hostname
- String
Nom de l’hôte distant auquel vous voulez envoyer le datagramme.
- port
- Int32
Numéro de port distant avec lequel vous souhaitez communiquer.
- cancellationToken
- CancellationToken
Jeton pour surveiller les requêtes d'annulation. La valeur par défaut est Aucun.
Retours
ValueTask<TResult> qui représente l’opération d’envoi asynchrone. La valeur de sa propriété Result contient le nombre d’octets envoyés.
Exceptions
UdpClient a déjà établi un hôte distant par défaut.
Le UdpClient est fermé.
Une erreur s’est produite pendant l’accès au socket.
Le jeton d’annulation a été annulé. Cette exception est stockée dans la tâche retournée.
