My.Computer.Network.Ping-Methode

  • Artikel

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:

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