NetworkState.IsDestinationReachable-Methode

Artikel
05/05/2015

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 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)

Siehe auch

Referenz

NetworkState Klasse

NetworkState-Member

Microsoft.Office.InfoPath-Namespace

Freigeben über