Ping.SendPingAsync 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 message ICMP d’écho à un ordinateur et reçoit un message ICMP de réponse à écho correspondant de cet ordinateur en tant qu’opération asynchrone.
Surcharges
| SendPingAsync(String, TimeSpan, Byte[], PingOptions, CancellationToken) |
Envoie un message d’écho ICMP (Internet Control Message Protocol) avec la mémoire tampon de données spécifiée à l’ordinateur spécifié et reçoit un message de réponse d’écho ICMP correspondant de cet ordinateur en tant qu’opération asynchrone. Cette surcharge vous permet de spécifier une valeur de délai d’attente pour l’opération, une mémoire tampon à utiliser pour l’envoi et la réception, des valeurs de fragmentation de contrôle et de durée de vie, et une CancellationToken pour le paquet de message d’écho ICMP. |
| SendPingAsync(IPAddress) |
Envoie un message ICMP d’écho avec le tampon de données spécifié à l’ordinateur qui a le IPAddress spécifié et reçoit un message ICMP de réponse à écho correspondant de cet ordinateur en tant qu’opération asynchrone. |
| SendPingAsync(String) |
Envoie un message ICMP d’écho à l’ordinateur spécifié avec le tampon de données spécifié et reçoit un message ICMP de réponse à écho correspondant de cet ordinateur en tant qu’opération asynchrone. |
| SendPingAsync(IPAddress, Int32) |
Envoie un message ICMP d’écho avec le tampon de données spécifié à l’ordinateur qui a le IPAddress spécifié et reçoit un message ICMP de réponse à écho correspondant de cet ordinateur en tant qu’opération asynchrone. Cette surcharge vous permet de spécifier une valeur de délai pour l’opération. |
| SendPingAsync(String, Int32) |
Envoie un message ICMP d’écho à l’ordinateur spécifié avec le tampon de données spécifié et reçoit un message ICMP de réponse à écho correspondant de cet ordinateur en tant qu’opération asynchrone. Cette surcharge vous permet de spécifier une valeur de délai pour l’opération. |
| SendPingAsync(IPAddress, Int32, Byte[]) |
Envoie un message ICMP d’écho avec le tampon de données spécifié à l’ordinateur qui a le IPAddress spécifié et reçoit un message ICMP de réponse à écho correspondant de cet ordinateur en tant qu’opération asynchrone. Cette surcharge vous permet de spécifier une valeur de délai d’attente pour l’opération et une mémoire tampon à utiliser pour l’envoi et la réception. |
| SendPingAsync(String, Int32, Byte[]) |
Envoie un message ICMP d’écho à l’ordinateur spécifié avec le tampon de données spécifié et reçoit un message ICMP de réponse à écho correspondant de cet ordinateur en tant qu’opération asynchrone. Cette surcharge vous permet de spécifier une valeur de délai d’attente pour l’opération et une mémoire tampon à utiliser pour l’envoi et la réception. |
| SendPingAsync(IPAddress, Int32, Byte[], PingOptions) |
Envoie un message ICMP d’écho avec le tampon de données spécifié à l’ordinateur qui a le IPAddress spécifié et reçoit un message ICMP de réponse à écho correspondant de cet ordinateur en tant qu’opération asynchrone. Cette surcharge vous permet de spécifier une valeur de délai d’attente pour l’opération, une mémoire tampon à utiliser pour les envois et les réceptions, et de contrôler la fragmentation et les valeurs de durée de vie pour le paquet de message ICMP d’écho. |
| SendPingAsync(String, Int32, Byte[], PingOptions) |
Envoie un message ICMP d’écho à l’ordinateur spécifié avec le tampon de données spécifié et reçoit un message ICMP de réponse à écho correspondant de cet ordinateur en tant qu’opération asynchrone. Cette surcharge vous permet de spécifier une valeur de délai d’attente pour l’opération, une mémoire tampon à utiliser pour les envois et les réceptions, et de contrôler la fragmentation et les valeurs de durée de vie pour le paquet de message ICMP d’écho. |
| SendPingAsync(IPAddress, TimeSpan, Byte[], PingOptions, CancellationToken) |
Envoie un message ICMP d’écho avec le tampon de données spécifié à l’ordinateur qui a le IPAddress spécifié et reçoit un message ICMP de réponse à écho correspondant de cet ordinateur en tant qu’opération asynchrone. Cette surcharge vous permet de spécifier une valeur de délai d’attente pour l’opération, une mémoire tampon à utiliser pour l’envoi et la réception, des valeurs de fragmentation de contrôle et de durée de vie, et une CancellationToken pour le paquet de message d’écho ICMP. |
Remarques
L’adresse IP retournée par l’une SendPingAsync des méthodes peut provenir d’un ordinateur distant malveillant. Ne vous connectez pas à l’ordinateur distant à l’aide de ceci. Utilisez DNS pour déterminer l’adresse IP de la machine à laquelle vous souhaitez vous connecter.
SendPingAsync(String, TimeSpan, Byte[], PingOptions, CancellationToken)
- Source:
- Ping.cs
- Source:
- Ping.cs
Envoie un message d’écho ICMP (Internet Control Message Protocol) avec la mémoire tampon de données spécifiée à l’ordinateur spécifié et reçoit un message de réponse d’écho ICMP correspondant de cet ordinateur en tant qu’opération asynchrone. Cette surcharge vous permet de spécifier une valeur de délai d’attente pour l’opération, une mémoire tampon à utiliser pour l’envoi et la réception, des valeurs de fragmentation de contrôle et de durée de vie, et une CancellationToken pour le paquet de message d’écho ICMP.
public System.Threading.Tasks.Task<System.Net.NetworkInformation.PingReply> SendPingAsync (string hostNameOrAddress, TimeSpan timeout, byte[]? buffer = default, System.Net.NetworkInformation.PingOptions? options = default, System.Threading.CancellationToken cancellationToken = default);member this.SendPingAsync : string * TimeSpan * byte[] * System.Net.NetworkInformation.PingOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.NetworkInformation.PingReply>Public Function SendPingAsync (hostNameOrAddress As String, timeout As TimeSpan, Optional buffer As Byte() = Nothing, Optional options As PingOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of PingReply)Paramètres
- hostNameOrAddress
- String
Ordinateur de destination pour le message d’écho ICMP. La valeur spécifiée pour ce paramètre peut être un nom d’hôte ou la représentation sous forme de chaîne d’une adresse IP.
- timeout
- TimeSpan
Durée d’attente (après l’envoi du message d’écho) pour attendre le message de réponse d’écho ICMP.
- buffer
- Byte[]
Tableau Byte qui contient les données à envoyer avec le message ICMP d’écho et à retourner dans le message ICMP de réponse à écho. Le tableau ne peut pas contenir plus de 65 500 octets.
- options
- PingOptions
Objet PingOptions utilisé pour contrôler la fragmentation et les valeurs de la durée de vie (Time-to-Live) du paquet de messages ICMP d’écho.
- cancellationToken
- CancellationToken
Jeton pour surveiller les requêtes d'annulation. La valeur par défaut est None.
Retours
Objet de tâche représentant l'opération asynchrone.
Exceptions
Le jeton d’annulation a été annulé. Cette exception est stockée dans la tâche retournée.
S’applique à
SendPingAsync(IPAddress)
- Source:
- Ping.cs
- Source:
- Ping.cs
- Source:
- Ping.cs
Envoie un message ICMP d’écho avec le tampon de données spécifié à l’ordinateur qui a le IPAddress spécifié et reçoit un message ICMP de réponse à écho correspondant de cet ordinateur en tant qu’opération asynchrone.
public:
System::Threading::Tasks::Task<System::Net::NetworkInformation::PingReply ^> ^ SendPingAsync(System::Net::IPAddress ^ address);public System.Threading.Tasks.Task<System.Net.NetworkInformation.PingReply> SendPingAsync (System.Net.IPAddress address);member this.SendPingAsync : System.Net.IPAddress -> System.Threading.Tasks.Task<System.Net.NetworkInformation.PingReply>Public Function SendPingAsync (address As IPAddress) As Task(Of PingReply)Paramètres
- address
- IPAddress
Adresse IP qui identifie l’ordinateur de destination pour le message ICMP d’écho.
Retours
Objet de tâche représentant l'opération asynchrone.
Exceptions
address a la valeur null.
Un appel à SendPingAsync est en cours.
Une exception a été levée lors de l’envoi ou de la réception des messages ICMP. Consultez l’exception interne de l’exception exacte qui a été levée.
address n’est pas une adresse IP valide.
Cet objet a été supprimé.
Remarques
Cette opération ne se bloque pas. L’objet retourné Task<TResult>> se termine une fois que le paquet ICMP a été envoyé et que la réponse a été reçue.
S’applique à
SendPingAsync(String)
- Source:
- Ping.cs
- Source:
- Ping.cs
- Source:
- Ping.cs
Envoie un message ICMP d’écho à l’ordinateur spécifié avec le tampon de données spécifié et reçoit un message ICMP de réponse à écho correspondant de cet ordinateur en tant qu’opération asynchrone.
public:
System::Threading::Tasks::Task<System::Net::NetworkInformation::PingReply ^> ^ SendPingAsync(System::String ^ hostNameOrAddress);public System.Threading.Tasks.Task<System.Net.NetworkInformation.PingReply> SendPingAsync (string hostNameOrAddress);member this.SendPingAsync : string -> System.Threading.Tasks.Task<System.Net.NetworkInformation.PingReply>Public Function SendPingAsync (hostNameOrAddress As String) As Task(Of PingReply)Paramètres
- hostNameOrAddress
- String
Ordinateur de destination pour le message d’écho ICMP. La valeur spécifiée pour ce paramètre peut être un nom d’hôte ou la représentation sous forme de chaîne d’une adresse IP.
Retours
Objet de tâche représentant l'opération asynchrone.
Exceptions
hostNameOrAddress a la valeur null ou est une chaîne vide ("").
Un appel à la méthode SendAsync(String, Object) est en cours.
Une exception a été levée lors de l’envoi ou de la réception des messages ICMP. Consultez l’exception interne de l’exception exacte qui a été levée.
hostNameOrAddress n’a pas pu être résolu en adresse IP valide.
Cet objet a été supprimé.
Remarques
Cette opération ne se bloque pas. L’objet retourné Task<TResult>> se termine une fois que le paquet ICMP a été envoyé et que la réponse a été reçue.
S’applique à
SendPingAsync(IPAddress, Int32)
- Source:
- Ping.cs
- Source:
- Ping.cs
- Source:
- Ping.cs
Envoie un message ICMP d’écho avec le tampon de données spécifié à l’ordinateur qui a le IPAddress spécifié et reçoit un message ICMP de réponse à écho correspondant de cet ordinateur en tant qu’opération asynchrone. Cette surcharge vous permet de spécifier une valeur de délai pour l’opération.
public:
System::Threading::Tasks::Task<System::Net::NetworkInformation::PingReply ^> ^ SendPingAsync(System::Net::IPAddress ^ address, int timeout);public System.Threading.Tasks.Task<System.Net.NetworkInformation.PingReply> SendPingAsync (System.Net.IPAddress address, int timeout);member this.SendPingAsync : System.Net.IPAddress * int -> System.Threading.Tasks.Task<System.Net.NetworkInformation.PingReply>Public Function SendPingAsync (address As IPAddress, timeout As Integer) As Task(Of PingReply)Paramètres
- address
- IPAddress
Adresse IP qui identifie l’ordinateur de destination pour le message ICMP d’écho.
- timeout
- Int32
Nombre maximal de millisecondes (après envoi du message d’écho) d’attente du message ICMP de réponse à écho.
Retours
Objet de tâche représentant l'opération asynchrone.
Exceptions
address a la valeur null.
Un appel à la méthode SendAsync est en cours.
Une exception a été levée lors de l’envoi ou de la réception des messages ICMP. Consultez l’exception interne de l’exception exacte qui a été levée.
address n’est pas une adresse IP valide.
Cet objet a été supprimé.
Remarques
Cette opération ne se bloque pas. L’objet retourné Task<TResult>> se termine une fois que le paquet ICMP a été envoyé et que la réponse a été reçue.
S’applique à
SendPingAsync(String, Int32)
- Source:
- Ping.cs
- Source:
- Ping.cs
- Source:
- Ping.cs
Envoie un message ICMP d’écho à l’ordinateur spécifié avec le tampon de données spécifié et reçoit un message ICMP de réponse à écho correspondant de cet ordinateur en tant qu’opération asynchrone. Cette surcharge vous permet de spécifier une valeur de délai pour l’opération.
public:
System::Threading::Tasks::Task<System::Net::NetworkInformation::PingReply ^> ^ SendPingAsync(System::String ^ hostNameOrAddress, int timeout);public System.Threading.Tasks.Task<System.Net.NetworkInformation.PingReply> SendPingAsync (string hostNameOrAddress, int timeout);member this.SendPingAsync : string * int -> System.Threading.Tasks.Task<System.Net.NetworkInformation.PingReply>Public Function SendPingAsync (hostNameOrAddress As String, timeout As Integer) As Task(Of PingReply)Paramètres
- hostNameOrAddress
- String
Ordinateur de destination pour le message d’écho ICMP. La valeur spécifiée pour ce paramètre peut être un nom d’hôte ou la représentation sous forme de chaîne d’une adresse IP.
- timeout
- Int32
Nombre maximal de millisecondes (après envoi du message d’écho) d’attente du message ICMP de réponse à écho.
Retours
Objet de tâche représentant l'opération asynchrone.
Exceptions
address a la valeur null.
timeout est inférieur à zéro.
Un appel à la méthode SendAsync est en cours.
Une exception a été levée lors de l’envoi ou de la réception des messages ICMP. Consultez l’exception interne de l’exception exacte qui a été levée.
address n’est pas une adresse IP valide.
Cet objet a été supprimé.
Remarques
Cette opération ne se bloque pas. L’objet retourné Task<TResult>> se termine une fois que le paquet ICMP a été envoyé et que la réponse a été reçue.
S’applique à
SendPingAsync(IPAddress, Int32, Byte[])
- Source:
- Ping.cs
- Source:
- Ping.cs
- Source:
- Ping.cs
Envoie un message ICMP d’écho avec le tampon de données spécifié à l’ordinateur qui a le IPAddress spécifié et reçoit un message ICMP de réponse à écho correspondant de cet ordinateur en tant qu’opération asynchrone. Cette surcharge vous permet de spécifier une valeur de délai d’attente pour l’opération et une mémoire tampon à utiliser pour l’envoi et la réception.
public:
System::Threading::Tasks::Task<System::Net::NetworkInformation::PingReply ^> ^ SendPingAsync(System::Net::IPAddress ^ address, int timeout, cli::array <System::Byte> ^ buffer);public System.Threading.Tasks.Task<System.Net.NetworkInformation.PingReply> SendPingAsync (System.Net.IPAddress address, int timeout, byte[] buffer);member this.SendPingAsync : System.Net.IPAddress * int * byte[] -> System.Threading.Tasks.Task<System.Net.NetworkInformation.PingReply>Public Function SendPingAsync (address As IPAddress, timeout As Integer, buffer As Byte()) As Task(Of PingReply)Paramètres
- address
- IPAddress
Adresse IP qui identifie l’ordinateur de destination pour le message ICMP d’écho.
- timeout
- Int32
Nombre maximal de millisecondes (après envoi du message d’écho) d’attente du message ICMP de réponse à écho.
- buffer
- Byte[]
Tableau Byte qui contient les données à envoyer avec le message ICMP d’écho et à retourner dans le message ICMP de réponse à écho. Le tableau ne peut pas contenir plus de 65 500 octets.
Retours
Objet de tâche représentant l'opération asynchrone.
Exceptions
address ou buffer est null.
timeout est inférieur à zéro.
Un appel à SendPingAsync est en cours.
Une exception a été levée lors de l’envoi ou de la réception des messages ICMP. Consultez l’exception interne de l’exception exacte qui a été levée.
address n’est pas une adresse IP valide.
Cet objet a été supprimé.
La taille de buffer dépasse 65 500 octets.
.NET 7 et versions ultérieures uniquement sur Linux : le processus n’est pas privilégié et buffer n’est pas vide.
Remarques
Cette opération ne se bloque pas. L’objet retourné Task<TResult>> se termine une fois que le paquet ICMP a été envoyé et que la réponse a été reçue.
S’applique à
SendPingAsync(String, Int32, Byte[])
- Source:
- Ping.cs
- Source:
- Ping.cs
- Source:
- Ping.cs
Envoie un message ICMP d’écho à l’ordinateur spécifié avec le tampon de données spécifié et reçoit un message ICMP de réponse à écho correspondant de cet ordinateur en tant qu’opération asynchrone. Cette surcharge vous permet de spécifier une valeur de délai d’attente pour l’opération et une mémoire tampon à utiliser pour l’envoi et la réception.
public:
System::Threading::Tasks::Task<System::Net::NetworkInformation::PingReply ^> ^ SendPingAsync(System::String ^ hostNameOrAddress, int timeout, cli::array <System::Byte> ^ buffer);public System.Threading.Tasks.Task<System.Net.NetworkInformation.PingReply> SendPingAsync (string hostNameOrAddress, int timeout, byte[] buffer);member this.SendPingAsync : string * int * byte[] -> System.Threading.Tasks.Task<System.Net.NetworkInformation.PingReply>Public Function SendPingAsync (hostNameOrAddress As String, timeout As Integer, buffer As Byte()) As Task(Of PingReply)Paramètres
- hostNameOrAddress
- String
Ordinateur de destination pour le message d’écho ICMP. La valeur spécifiée pour ce paramètre peut être un nom d’hôte ou la représentation sous forme de chaîne d’une adresse IP.
- timeout
- Int32
Nombre maximal de millisecondes (après envoi du message d’écho) d’attente du message ICMP de réponse à écho.
- buffer
- Byte[]
Tableau Byte qui contient les données à envoyer avec le message ICMP d’écho et à retourner dans le message ICMP de réponse à écho. Le tableau ne peut pas contenir plus de 65 500 octets.
Retours
Objet de tâche représentant l'opération asynchrone.
Exceptions
hostNameOrAddress a la valeur null ou est une chaîne vide ("").
-ou-
buffer a la valeur null.
timeout est inférieur à zéro.
Un appel à SendAsync est en cours.
Une exception a été levée lors de l’envoi ou de la réception des messages ICMP. Consultez l’exception interne de l’exception exacte qui a été levée.
hostNameOrAddress n’a pas pu être résolu en adresse IP valide.
Cet objet a été supprimé.
La taille de buffer dépasse 65 500 octets.
.NET 7 et versions ultérieures uniquement sur Linux : le processus n’est pas privilégié et buffer n’est pas vide.
Remarques
Cette opération ne se bloque pas. L’objet retourné Task<TResult>> se termine une fois que le paquet ICMP a été envoyé et que la réponse a été reçue.
S’applique à
SendPingAsync(IPAddress, Int32, Byte[], PingOptions)
- Source:
- Ping.cs
- Source:
- Ping.cs
- Source:
- Ping.cs
Envoie un message ICMP d’écho avec le tampon de données spécifié à l’ordinateur qui a le IPAddress spécifié et reçoit un message ICMP de réponse à écho correspondant de cet ordinateur en tant qu’opération asynchrone. Cette surcharge vous permet de spécifier une valeur de délai d’attente pour l’opération, une mémoire tampon à utiliser pour les envois et les réceptions, et de contrôler la fragmentation et les valeurs de durée de vie pour le paquet de message ICMP d’écho.
public:
System::Threading::Tasks::Task<System::Net::NetworkInformation::PingReply ^> ^ SendPingAsync(System::Net::IPAddress ^ address, int timeout, cli::array <System::Byte> ^ buffer, System::Net::NetworkInformation::PingOptions ^ options);public System.Threading.Tasks.Task<System.Net.NetworkInformation.PingReply> SendPingAsync (System.Net.IPAddress address, int timeout, byte[] buffer, System.Net.NetworkInformation.PingOptions? options);public System.Threading.Tasks.Task<System.Net.NetworkInformation.PingReply> SendPingAsync (System.Net.IPAddress address, int timeout, byte[] buffer, System.Net.NetworkInformation.PingOptions options);member this.SendPingAsync : System.Net.IPAddress * int * byte[] * System.Net.NetworkInformation.PingOptions -> System.Threading.Tasks.Task<System.Net.NetworkInformation.PingReply>Public Function SendPingAsync (address As IPAddress, timeout As Integer, buffer As Byte(), options As PingOptions) As Task(Of PingReply)Paramètres
- address
- IPAddress
Adresse IP qui identifie l’ordinateur de destination pour le message ICMP d’écho.
- timeout
- Int32
Nombre maximal de millisecondes (après envoi du message d’écho) d’attente du message ICMP de réponse à écho.
- buffer
- Byte[]
Tableau Byte qui contient les données à envoyer avec le message ICMP d’écho et à retourner dans le message ICMP de réponse à écho. Le tableau ne peut pas contenir plus de 65 500 octets.
- options
- PingOptions
Objet PingOptions utilisé pour contrôler la fragmentation et les valeurs de la durée de vie (Time-to-Live) du paquet de messages ICMP d’écho.
Retours
Objet de tâche représentant l'opération asynchrone.
Exceptions
address ou buffer est null.
timeout est inférieur à zéro.
Un appel à SendPingAsync est en cours.
Une exception a été levée lors de l’envoi ou de la réception des messages ICMP. Consultez l’exception interne de l’exception exacte qui a été levée.
address n’est pas une adresse IP valide.
Cet objet a été supprimé.
La taille de buffer dépasse 65 500 octets.
.NET 7 et versions ultérieures uniquement sur Linux : le processus n’est pas privilégié et buffer n’est pas vide.
Remarques
Cette opération ne se bloque pas. L’objet retourné Task<TResult>> se termine une fois que le paquet ICMP a été envoyé et que la réponse a été reçue.
S’applique à
SendPingAsync(String, Int32, Byte[], PingOptions)
- Source:
- Ping.cs
- Source:
- Ping.cs
- Source:
- Ping.cs
Envoie un message ICMP d’écho à l’ordinateur spécifié avec le tampon de données spécifié et reçoit un message ICMP de réponse à écho correspondant de cet ordinateur en tant qu’opération asynchrone. Cette surcharge vous permet de spécifier une valeur de délai d’attente pour l’opération, une mémoire tampon à utiliser pour les envois et les réceptions, et de contrôler la fragmentation et les valeurs de durée de vie pour le paquet de message ICMP d’écho.
public:
System::Threading::Tasks::Task<System::Net::NetworkInformation::PingReply ^> ^ SendPingAsync(System::String ^ hostNameOrAddress, int timeout, cli::array <System::Byte> ^ buffer, System::Net::NetworkInformation::PingOptions ^ options);public System.Threading.Tasks.Task<System.Net.NetworkInformation.PingReply> SendPingAsync (string hostNameOrAddress, int timeout, byte[] buffer, System.Net.NetworkInformation.PingOptions? options);public System.Threading.Tasks.Task<System.Net.NetworkInformation.PingReply> SendPingAsync (string hostNameOrAddress, int timeout, byte[] buffer, System.Net.NetworkInformation.PingOptions options);member this.SendPingAsync : string * int * byte[] * System.Net.NetworkInformation.PingOptions -> System.Threading.Tasks.Task<System.Net.NetworkInformation.PingReply>Public Function SendPingAsync (hostNameOrAddress As String, timeout As Integer, buffer As Byte(), options As PingOptions) As Task(Of PingReply)Paramètres
- hostNameOrAddress
- String
Ordinateur de destination pour le message d’écho ICMP. La valeur spécifiée pour ce paramètre peut être un nom d’hôte ou la représentation sous forme de chaîne d’une adresse IP.
- timeout
- Int32
Nombre maximal de millisecondes (après envoi du message d’écho) d’attente du message ICMP de réponse à écho.
- buffer
- Byte[]
Tableau Byte qui contient les données à envoyer avec le message ICMP d’écho et à retourner dans le message ICMP de réponse à écho. Le tableau ne peut pas contenir plus de 65 500 octets.
- options
- PingOptions
Objet PingOptions utilisé pour contrôler la fragmentation et les valeurs de la durée de vie (Time-to-Live) du paquet de messages ICMP d’écho.
Retours
Objet de tâche représentant l'opération asynchrone.
Exceptions
hostNameOrAddress a la valeur null ou est une chaîne vide ("").
-ou-
buffer a la valeur null.
timeout est inférieur à zéro.
Un appel à SendAsync est en cours.
Une exception a été levée lors de l’envoi ou de la réception des messages ICMP. Consultez l’exception interne de l’exception exacte qui a été levée.
hostNameOrAddress n’a pas pu être résolu en adresse IP valide.
Cet objet a été supprimé.
La taille de buffer dépasse 65 500 octets.
.NET 7 et versions ultérieures uniquement sur Linux : le processus n’est pas privilégié et buffer n’est pas vide.
Remarques
Cette opération ne se bloque pas. L’objet retourné Task<TResult>> se termine une fois que le paquet ICMP a été envoyé et que la réponse a été reçue.
S’applique à
SendPingAsync(IPAddress, TimeSpan, Byte[], PingOptions, CancellationToken)
- Source:
- Ping.cs
- Source:
- Ping.cs
Envoie un message ICMP d’écho avec le tampon de données spécifié à l’ordinateur qui a le IPAddress spécifié et reçoit un message ICMP de réponse à écho correspondant de cet ordinateur en tant qu’opération asynchrone. Cette surcharge vous permet de spécifier une valeur de délai d’attente pour l’opération, une mémoire tampon à utiliser pour l’envoi et la réception, des valeurs de fragmentation de contrôle et de durée de vie, et un CancellationToken pour le paquet de message d’écho ICMP.
public System.Threading.Tasks.Task<System.Net.NetworkInformation.PingReply> SendPingAsync (System.Net.IPAddress address, TimeSpan timeout, byte[]? buffer = default, System.Net.NetworkInformation.PingOptions? options = default, System.Threading.CancellationToken cancellationToken = default);member this.SendPingAsync : System.Net.IPAddress * TimeSpan * byte[] * System.Net.NetworkInformation.PingOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.NetworkInformation.PingReply>Public Function SendPingAsync (address As IPAddress, timeout As TimeSpan, Optional buffer As Byte() = Nothing, Optional options As PingOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of PingReply)Paramètres
- address
- IPAddress
Adresse IP qui identifie l’ordinateur de destination pour le message ICMP d’écho.
- timeout
- TimeSpan
Durée (après l’envoi du message d’écho) d’attente du message de réponse d’écho ICMP.
- buffer
- Byte[]
Tableau Byte qui contient les données à envoyer avec le message ICMP d’écho et à retourner dans le message ICMP de réponse à écho. Le tableau ne peut pas contenir plus de 65 500 octets.
- options
- PingOptions
Objet PingOptions utilisé pour contrôler la fragmentation et les valeurs de la durée de vie (Time-to-Live) du paquet de messages ICMP d’écho.
- cancellationToken
- CancellationToken
Jeton pour surveiller les requêtes d'annulation. La valeur par défaut est None.
Retours
Objet de tâche représentant l'opération asynchrone.
Exceptions
Le jeton d’annulation a été annulé. Cette exception est stockée dans la tâche retournée.
