Freigeben über

NetworkState.IsDestinationReachable(String) Methode

  • Referenz

Definition

Namespace:
Microsoft.Office.InfoPath
Assembly:
Microsoft.Office.InfoPath.dll

Ruft einen Wert ab, der angibt, ob mit dem angegebenen Netzwerkziel eine Verbindung 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 auf Netzwerkkonnektivität zu überprüfende Adresse als URL (Uniform Resource Locator), UNC-Pfad (Universal Naming Convention) oder IP-Adresse an.

Gibt zurück

Boolean

true, falls mit der angegebenen URL, dem angegebenen UNC-Pfad oder der angegebenen IP-Adresse eine Verbindung 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.

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(
   "http://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( _
   "http://www.microsoft.com").ToString() 

' Display result in a message box.
MessageBox.Show("Can connect to Microsoft.com = " & result)

Gilt für: