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 d’écho ICMP (Internet Control Message Protocol) à un ordinateur et reçoit un message de réponse d’écho ICMP correspondant de cet ordinateur en tant qu’opération asynchrone.
Surcharges
| Nom | Description |
|---|---|
| SendPingAsync(String, Int32, Byte[], PingOptions) |
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, et contrôler la fragmentation et les valeurs de temps à vie pour le paquet de message d’écho ICMP. |
| SendPingAsync(IPAddress) |
Envoyez un message d’écho ICMP (Internet Control Message Protocol) avec la mémoire tampon de données spécifiée à l’ordinateur qui a le message de réponse d’écho ICMP correspondant IPAddressà partir de cet ordinateur en tant qu’opération asynchrone. |
| SendPingAsync(String) |
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. |
| SendPingAsync(IPAddress, Int32) |
Envoyez un message d’écho ICMP (Internet Control Message Protocol) avec la mémoire tampon de données spécifiée à l’ordinateur qui a le message de réponse d’écho ICMP correspondant IPAddressà partir 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. |
| SendPingAsync(String, Int32) |
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. |
| SendPingAsync(IPAddress, Int32, Byte[]) |
Envoyez un message d’écho ICMP (Internet Control Message Protocol) avec la mémoire tampon de données spécifiée à l’ordinateur qui a le message de réponse d’écho ICMP correspondant IPAddressà partir 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 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 et une mémoire tampon à utiliser pour l’envoi et la réception. |
| SendPingAsync(IPAddress, Int32, Byte[], PingOptions) |
Envoie un message d’écho ICMP (Internet Control Message Protocol) avec la mémoire tampon de données spécifiée à l’ordinateur qui a le message de réponse d’écho ICMP correspondant IPAddressà partir 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, et contrôler la fragmentation et les valeurs de temps à vie 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 l’ordinateur auquel vous souhaitez vous connecter.
SendPingAsync(String, Int32, Byte[], PingOptions)
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, et contrôler la fragmentation et les valeurs de temps à vie pour le paquet de message d’écho ICMP.
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);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 qui est la destination du message d’écho ICMP. La valeur spécifiée pour ce paramètre peut être un nom d’hôte ou une représentation sous forme de chaîne d’une adresse IP.
- timeout
- Int32
Nombre maximal de millisecondes (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 d’écho ICMP et retourné dans le message de réponse d’écho ICMP. Le tableau ne peut pas contenir plus de 65 500 octets.
- options
- PingOptions
Objet PingOptions utilisé pour contrôler la fragmentation et les valeurs time-to-Live pour le paquet de messages d’écho ICMP.
Retours
Objet de tâche représentant l’opération asynchrone.
Exceptions
hostNameOrAddress est null ou est une chaîne vide (« »).
-ou-
buffer a la valeur null.
timeout est inférieur à zéro.
Un appel est SendAsync en cours.
Une exception a été levée lors de l’envoi ou de la réception des messages ICMP. Consultez l’exception interne pour l’exception exacte levée.
hostNameOrAddress impossible de résoudre une adresse IP valide.
Cet objet a été supprimé.
La taille des buffer octets dépasse 65500 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 bloque pas. L’objet retourné Task<TResult>> se termine une fois le paquet ICMP envoyé et la réponse a été reçue.
S’applique à
SendPingAsync(IPAddress)
Envoyez un message d’écho ICMP (Internet Control Message Protocol) avec la mémoire tampon de données spécifiée à l’ordinateur qui a le message de réponse d’écho ICMP correspondant IPAddressà partir 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 qui est la destination du message d’écho ICMP.
Retours
Objet de tâche représentant l’opération asynchrone.
Exceptions
address a la valeur null.
Un appel est SendPingAsync en cours.
Une exception a été levée lors de l’envoi ou de la réception des messages ICMP. Consultez l’exception interne pour l’exception exacte levée.
address n’est pas une adresse IP valide.
Cet objet a été supprimé.
Remarques
Cette opération ne bloque pas. L’objet retourné Task<TResult>> se termine une fois le paquet ICMP envoyé et la réponse a été reçue.
S’applique à
SendPingAsync(String)
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.
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 qui est la destination du message d’écho ICMP. La valeur spécifiée pour ce paramètre peut être un nom d’hôte ou une représentation sous forme de chaîne d’une adresse IP.
Retours
Objet de tâche représentant l’opération asynchrone.
Exceptions
hostNameOrAddress est null ou est une chaîne vide (« »).
Un appel à SendAsync(String, Object) la méthode 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 pour l’exception exacte levée.
hostNameOrAddress impossible de résoudre une adresse IP valide.
Cet objet a été supprimé.
Remarques
Cette opération ne bloque pas. L’objet retourné Task<TResult>> se termine une fois le paquet ICMP envoyé et la réponse a été reçue.
S’applique à
SendPingAsync(IPAddress, Int32)
Envoyez un message d’écho ICMP (Internet Control Message Protocol) avec la mémoire tampon de données spécifiée à l’ordinateur qui a le message de réponse d’écho ICMP correspondant IPAddressà partir 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.
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 qui est la destination du message d’écho ICMP.
- timeout
- Int32
Nombre maximal de millisecondes (après l’envoi du message d’écho) pour attendre le message de réponse d’écho ICMP.
Retours
Objet de tâche représentant l’opération asynchrone.
Exceptions
address a la valeur null.
Un appel à la SendAsync méthode 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 pour l’exception exacte levée.
address n’est pas une adresse IP valide.
Cet objet a été supprimé.
Remarques
Cette opération ne bloque pas. L’objet retourné Task<TResult>> se termine une fois le paquet ICMP envoyé et la réponse a été reçue.
S’applique à
SendPingAsync(String, Int32)
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.
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 qui est la destination du message d’écho ICMP. La valeur spécifiée pour ce paramètre peut être un nom d’hôte ou une représentation sous forme de chaîne d’une adresse IP.
- timeout
- Int32
Nombre maximal de millisecondes (après l’envoi du message d’écho) pour attendre le message de réponse d’écho ICMP.
Retours
Objet de tâche représentant l’opération asynchrone.
Exceptions
hostNameOrAddress a la valeur null.
timeout est inférieur à zéro.
Un appel à la SendAsync méthode 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 pour l’exception exacte levée.
hostNameOrAddress n’est pas une adresse IP valide.
Cet objet a été supprimé.
Remarques
Cette opération ne bloque pas. L’objet retourné Task<TResult>> se termine une fois le paquet ICMP envoyé et la réponse a été reçue.
S’applique à
SendPingAsync(IPAddress, Int32, Byte[])
Envoyez un message d’écho ICMP (Internet Control Message Protocol) avec la mémoire tampon de données spécifiée à l’ordinateur qui a le message de réponse d’écho ICMP correspondant IPAddressà partir 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 qui est la destination du message d’écho ICMP.
- timeout
- Int32
Nombre maximal de millisecondes (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 d’écho ICMP et retourné dans le message de réponse d’écho ICMP. 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 est SendPingAsync en cours.
Une exception a été levée lors de l’envoi ou de la réception des messages ICMP. Consultez l’exception interne pour l’exception exacte levée.
address n’est pas une adresse IP valide.
Cet objet a été supprimé.
La taille est buffer supérieure à 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 bloque pas. L’objet retourné Task<TResult>> se termine une fois le paquet ICMP envoyé et la réponse a été reçue.
S’applique à
SendPingAsync(String, Int32, Byte[])
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 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 qui est la destination du message d’écho ICMP. La valeur spécifiée pour ce paramètre peut être un nom d’hôte ou une représentation sous forme de chaîne d’une adresse IP.
- timeout
- Int32
Nombre maximal de millisecondes (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 d’écho ICMP et retourné dans le message de réponse d’écho ICMP. Le tableau ne peut pas contenir plus de 65 500 octets.
Retours
Objet de tâche représentant l’opération asynchrone.
Exceptions
hostNameOrAddress est null ou est une chaîne vide (« »).
-ou-
buffer a la valeur null.
timeout est inférieur à zéro.
Un appel est SendAsync en cours.
Une exception a été levée lors de l’envoi ou de la réception des messages ICMP. Consultez l’exception interne pour l’exception exacte levée.
hostNameOrAddress impossible de résoudre une adresse IP valide.
Cet objet a été supprimé.
La taille des buffer octets dépasse 65500 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 bloque pas. L’objet retourné Task<TResult>> se termine une fois le paquet ICMP envoyé et la réponse a été reçue.
S’applique à
SendPingAsync(IPAddress, Int32, Byte[], PingOptions)
Envoie un message d’écho ICMP (Internet Control Message Protocol) avec la mémoire tampon de données spécifiée à l’ordinateur qui a le message de réponse d’écho ICMP correspondant IPAddressà partir 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, et contrôler la fragmentation et les valeurs de temps à vie pour le paquet de message d’écho ICMP.
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);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 qui est la destination du message d’écho ICMP.
- timeout
- Int32
Nombre maximal de millisecondes (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 d’écho ICMP et retourné dans le message de réponse d’écho ICMP. Le tableau ne peut pas contenir plus de 65 500 octets.
- options
- PingOptions
Objet PingOptions utilisé pour contrôler la fragmentation et les valeurs time-to-Live pour le paquet de messages d’écho ICMP.
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 est SendPingAsync en cours.
Une exception a été levée lors de l’envoi ou de la réception des messages ICMP. Consultez l’exception interne pour l’exception exacte levée.
address n’est pas une adresse IP valide.
Cet objet a été supprimé.
La taille est buffer supérieure à 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 bloque pas. L’objet retourné Task<TResult>> se termine une fois le paquet ICMP envoyé et la réponse a été reçue.