Application.IsDestinationReachable-Methode
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. Der Parameter 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 den Member kann nur über Formulare zugegriffen werden, die in derselben Domäne wie das zurzeit geöffnete Formular ausgeführt werden, oder über Formulare, denen domänenübergreifende Berechtigungen erteilt wurden.
Auf diesen Typ oder diesen Member kann nur über Code zugegriffen werden, der in Formularen ausgeführt wird, die mit 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