Application.IsDestinationReachable(String) Methode

Referenz

Definition

Namespace:: Microsoft.Office.InfoPath

Assembly:: Microsoft.Office.InfoPath.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft einen Wert ab, mit dem angegeben wird, ob mithilfe der angegebenen URL (Uniform Resource Locator), dem UNC-Pfad (UNC = Universal Naming Convention) oder der IP-Adresse eine Verbindung zum Zielcomputer hergestellt werden kann.

public:
 abstract bool IsDestinationReachable(System::String ^ destination);

public abstract bool IsDestinationReachable (string destination);

abstract member IsDestinationReachable : string -> bool

Public MustOverride Function IsDestinationReachable (destination As String) As Boolean

Parameter

destination: String

Gibt die zu überprüfende Position für Netzwerkkonnektivität als IP-Adresse, UNC-Pfad oder URLs an.

Gibt zurück

Boolean

true, wenn eine Verbindung zum angegebenen URL, zum UNC-Pfad oder zur IP-Adresse hergestellt werden kann; andernfalls false.

Ausnahmen

FileNotFoundException

Die Position des Ziels kann nicht gefunden werden.

ArgumentNullException

Der an diese Methode übergebene Parameter ist ein NULL-Verweis (Nothing in Visual Basic).

ArgumentException

Der an diese Methode übergebene Parameter ist nicht gültig. Der Parameter weist beispielsweise den falschen Typ oder das falsche Format auf.

Beispiele

Im folgenden Beispiel wird durch Klicken auf das Steuerelement Button angezeigt, ob eine Verbindung zum angegebenen URL hergestellt werden kann.

public void CTRL1_Clicked(object sender, ClickedEventArgs e)
{
   string result = this.Application.IsDestinationReachable(
      "http://www.microsoft.com").ToString();
   MessageBox.Show(result);
}

Public Sub CTRL1_Clicked(ByVal sender As Object, _
   ByVal e As ClickedEventArgs)
   result As String = Me.Application.IsDestinationReachable( _
      "http://www.microsoft.com").ToString()
   MessageBox.Show(result)
End Sub

Hinweise

Der für destination angegebene Wert muss entweder ein UNC-Pfad sein, der einen Servernamen und einen Freigabenamen enthält, z. B. @"\\MyServer\MyShare", oder eine URL, die mit einem der folgenden Protokollbezeichner beginnt: http, https oder file.

Hinweis: Verwenden Sie die -Methode der -Klasse, IsDestinationReachable(String) um die gleiche Funktionalität bei Verwendung FormControlvon NetworkState zu erhalten.

Auf dieses Mitglied kann nur mithilfe von Formularen zugegriffen werden, die in der gleichen Domäne wie das derzeit geöffnete Formular ausgeführt werden oder denen domänenübergreifende Berechtigungen zugewiesen wurden.

Auf diesen Typ oder dieses Mitglied kann nur über Code zugegriffen werden, der in Formularen ausgeführt wird, die in Microsoft InfoPath Filler geöffnet wurden.

Gilt für:

Freigeben über