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.String
Gibt 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 lautet 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 mit einem Servernamen und einem Freigabenamen wie beispielsweise @"\\\\MyServer\\MyShare" oder aber eine URL sein, die mit einer der folgenden Protokoll-IDs beginnt: http, https oder file.
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.
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)