NetworkState.IsDestinationReachable メソッド
指定したネットワークの場所に接続できるかどうかを示す値を取得します。
名前空間: Microsoft.Office.InfoPath
アセンブリ: Microsoft.Office.InfoPath (Microsoft.Office.InfoPath.dll)
構文
'宣言
Public MustOverride Function IsDestinationReachable ( _
destination As String _
) As Boolean
'使用
Dim instance As NetworkState
Dim destination As String
Dim returnValue As Boolean
returnValue = instance.IsDestinationReachable(destination)
public abstract bool IsDestinationReachable(
string destination
)
パラメーター
- destination
型: System.String
URL (Uniform Resource Locator)、UNC (Universal Naming Convention) パス、または IP アドレスを使用するネットワーク接続を確認する場所を指定します。
戻り値
型: System.Boolean
指定した URL、UNC パス、または IP アドレスに接続できる場合は true、そうでない場合は false。
例外
例外 | 条件 |
---|---|
FileNotFoundException | 接続先の場所が見つかりません。 |
ArgumentNullException | このメソッドに渡されたパラメーターは null 参照 (Visual Basic ではNothing ) です。 |
ArgumentException | このメソッドに渡されたパラメーターは有効ではありません。たとえば、型または形式が正しくありません。 |
解説
destination に対して指定する値は、サーバー名と共有名を含む UNC パス (@"\\MyServer\MyShare" など) か、http、https、または file のいずれかのプロトコル識別子で始まる URL である必要があります。
このメンバーには、現在開いているフォームと同じドメインで実行中のフォーム、またはクロスドメインのアクセス許可が与えられたフォームのみがアクセスできます。
この型またはメンバーには、Microsoft InfoPath Filler で開かれたフォームを実行中のコードからのみアクセスできます。
次のコード例では、Button コントロールをクリックすると、指定した URL に接続できるかどうかが表示されます。
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)