NetworkState.IsDestinationReachable-Methode
Ruft einen Wert ab, der angibt, ob mit dem angegebenen Netzwerkziel eine Verbindung 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 NetworkState
Dim destination As String
Dim returnValue As Boolean
returnValue = instance.IsDestinationReachable(destination)
public abstract bool IsDestinationReachable(
string destination
)
Parameter
destination
Typ: System.StringGibt die auf Netzwerkkonnektivität zu überprüfende Adresse als URL (Uniform Resource Locator), UNC-Pfad (Universal Naming Convention) oder IP-Adresse an.
Rückgabewert
Typ: System.Boolean
true, falls mit der angegebenen URL, dem angegebenen UNC-Pfad oder der angegebenen IP-Adresse eine Verbindung 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.
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.
Im folgenden Codebeispiel wird durch Klicken auf das Steuerelement Button angezeigt, ob eine Verbindung zur angegebenen URL hergestellt werden kann.
using Microsoft.Office.InfoPath;
string result = formControl1.XmlForm.NetworkState.IsDestinationReachable(
"https://www.microsoft.com").ToString();
// Display result in a message box.
MessageBox.Show("Can connect to Microsoft.com = " + result);
Imports Microsoft.Office.InfoPath
Dim result As String = _
formControl1.XmlForm.NetworkState.IsDestinationReachable( _
"https://www.microsoft.com").ToString()
' Display result in a message box.
MessageBox.Show("Can connect to Microsoft.com = " & result)