My.Computer.Network.Ping-Methode

Artikel
08/20/2008

Aktualisiert: November 2007

Sendet ein Pingsignal an den angegebenen Server.

' Usage
Dim value As Boolean = My.Computer.Network.Ping(hostNameOrAddress)
Dim value As Boolean = My.Computer.Network.Ping(address)
Dim value As Boolean = My.Computer.Network.Ping(hostNameOrAddress ,timeout)
Dim value As Boolean = My.Computer.Network.Ping(address ,timeout)
' Declaration
Public Function Ping( _
   ByVal hostNameOrAddress As String _
) As Boolean
' -or-
Public Function Ping( _
   ByVal address As System.Uri _
) As Boolean
' -or-
Public Function Ping( _
   ByVal hostNameOrAddress As String, _
   ByVal timeout As Integer _
) As Boolean
' -or-
Public Function Ping( _
   ByVal address As System.Uri, _
   ByVal timeout As Integer _
) As Boolean

Parameter

hostNameOrAddress
String. Der URL, der Computername oder die IP-Nummer des Servers, an den ein Pingsignal gesendet werden soll. Erforderlich.
address
Uri. Der URI des Servers, an den ein Pingsignal gesendet werden soll. Erforderlich.
timeout
Int32. Die Zeitschwelle in Millisekunden zum Herstellen der Verbindung mit dem Ziel. Der Standardwert beträgt 500. Erforderlich.

Rückgabewert

Boolean, um anzugeben, ob der Vorgang erfolgreich ausgeführt wurde.

Ausnahmen

Die folgenden Bedingungen verursachen möglicherweise das Auslösen einer Ausnahme:

Es ist keine Netzwerkverbindung verfügbar (InvalidOperationException).
Der URL war nicht gültig (PingException).

Hinweise

Die Ping-Methode ist keine absolut sichere Methode zum Bestimmen der Verfügbarkeit eines Remotecomputers: Der Pinganschluss des Zielcomputers ist möglicherweise deaktiviert, und die Pinganforderung kann durch eine Firewall oder einen Router blockiert werden.

Der DNS der an die Ping-Methode übergebenen Adresse muss auflösbar sein, und der Adresse darf nicht "http://" vorangestellt sein.

Aufgaben

In der folgenden Tabelle werden Beispiele für Aufgaben mit der My.Computer.Network.Ping-Methode aufgeführt.

Zweck	Weitere Informationen finden Sie unter
Bestimmen, ob ein Remotecomputer oder Remotehost verfügbar ist	Gewusst wie: Ermitteln, ob ein Remotecomputer verfügbar ist in Visual Basic

Beispiel

Im Beispiel wird gemeldet, ob an den Server ein Pingsignal gesendet werden kann, indem bestimmt wird, ob die Ping-Methode True zurückgibt.

If My.Computer.Network.Ping("198.01.01.01") Then
   MsgBox("Server pinged successfully.")
Else
   MsgBox("Ping request timed out.")
End If

Ersetzen Sie "198.01.01.01" durch die IP-Adresse, den URL oder Computernamen des Servers, an den ein Pingsignal gesendet werden soll.

Im Beispiel wird gemeldet, ob an den Server ein Pingsignal gesendet werden kann, indem bestimmt wird, ob die Ping-Methode True zurückgegeben hat, und es wird ein Timeoutintervall von 1000 Millisekunden angegeben.

If My.Computer.Network.Ping("www.cohowinery.com",1000) Then
   MsgBox("Server pinged successfully.")
Else
   MsgBox("Ping request timed out.")
End If

Ersetzen Sie "www.cohowinery.com" durch die IP-Adresse, den URL oder Computernamen des Servers, an den ein Pingsignal gesendet werden soll.

Anforderungen

Namespace: Microsoft.VisualBasic.Devices

Klasse: Network

Assembly: Visual Basic-Laufzeitbibliothek (in Microsoft.VisualBasic.dll)

Verfügbarkeit nach Projekttyp

Projekttyp	Verfügbar
Windows-Anwendung	Ja
Klassenbibliothek	Ja
Konsolenanwendung	Ja
Windows-Steuerelementbibliothek	Ja
Web-Steuerelementbibliothek	Ja
Windows-Dienst	Ja
Website	Ja

Berechtigungen

Die folgenden Berechtigungen sind möglicherweise erforderlich:

Berechtigung	Beschreibung
FileIOPermission	Steuert die Fähigkeit, auf Dateien und Ordner zuzugreifen. Zugeordnete Enumeration: Unrestricted.
SecurityPermission	Beschreibt einen Satz von Sicherheitsberechtigungen, die auf Code angewendet werden. Zugeordnete Enumeration: ControlPrincipal.
WebPermission	Steuert die Rechte für den Zugriff auf HTTP-Internetressourcen. Zugeordnete Enumeration: Unrestricted.
SocketPermission	Steuert die Rechte zum Herstellen oder Annehmen von Verbindungen über eine Transportadresse. Zugeordnete Enumeration: Unrestricted.
PerformanceCounterPermission	Steuert den Zugriff auf eine Leistungsindikatorkomponente von Windows NT. Zugeordnete Enumeration: Unrestricted.
NetworkInformationPermission	Steuert den Zugriff auf Netzwerkinformationen und auf die Datenverkehrsstatistik für den lokalen Computer. Zugeordnete Enumeration: Ping.

Weitere Informationen finden Sie unter Codezugriffssicherheit und unter Anfordern von Berechtigungen.

Siehe auch

Referenz

My.Computer.Network-Objekt

System.Uri

Network.Ping

Freigeben über