Application.IsDestinationReachable-Methode

Artikel
05/05/2015

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.

Namespace: Microsoft.Office.InfoPath
Assembly: Microsoft.Office.InfoPath (in Microsoft.Office.InfoPath.dll)

Syntax

'Declaration
Public MustOverride Function IsDestinationReachable ( _
    destination As String _
) As Boolean
'Usage
Dim instance As Application
Dim destination As String
Dim returnValue As Boolean

returnValue = instance.IsDestinationReachable(destination)

public abstract bool IsDestinationReachable(
    string destination
)

Parameter

destination
Typ: System.String

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

Rückgabewert

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

Ausnahmen

Ausnahme	Bedingung
FileNotFoundException	Die Position des Ziels kann nicht gefunden werden.
ArgumentNullException	Der an diese Methode übergebene Parameter ist ein Nullverweis (Nothing in Visual Basic).
ArgumentException	Der an diese Methode übergebene Parameter ist nicht gültig. Er weist beispielsweise den falschen Typ oder das falsche Format auf.

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

Um die gleiche Funktionalität zu erhalten, wenn Sie mit FormControl arbeiten, verwenden Sie die IsDestinationReachable(String)-Methode der NetworkState-Klasse.

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.

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(
      "https://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( _
      "https://www.microsoft.com").ToString()
   MessageBox.Show(result)
End Sub

Siehe auch

Referenz

Application Klasse

Application-Member

Microsoft.Office.InfoPath-Namespace

Share via