Application.IsDestinationReachable メソッド
指定した URL (Uniform Resource Locator)、UNC (Universal Naming Convention) パス、または IP アドレスを使用して、目的のコンピューターに接続が可能かどうかを示す値を取得します。
名前空間: Microsoft.Office.InfoPath
アセンブリ: Microsoft.Office.InfoPath (Microsoft.Office.InfoPath.dll)
構文
'宣言
Public MustOverride Function IsDestinationReachable ( _
destination As String _
) As Boolean
'使用
Dim instance As Application
Dim destination As String
Dim returnValue As Boolean
returnValue = instance.IsDestinationReachable(destination)
public abstract bool IsDestinationReachable(
string destination
)
パラメーター
- destination
型: System.String
ネットワーク接続を確認する場所を、IP アドレス、UNC パス、または URL として指定します。
戻り値
型: System.Boolean
指定した URL、UNC、または IP アドレスへの接続が可能な場合は true、それ以外の場合は false。
例外
| 例外 | 条件 |
|---|---|
| FileNotFoundException | 目的の場所が見つかりません。 |
| ArgumentNullException | このメソッドに渡されたパラメーターは null 参照 (Visual Basic ではNothing ) です。 |
| ArgumentException | このメソッドに渡されたパラメーターは有効ではありません。たとえば、型または形式が正しくありません。 |
解説
destination に対して指定する値は、サーバー名と共有名を含む UNC パス (@"\\MyServer\MyShare" など) か、http、https、または file のいずれかのプロトコル識別子で始まる URL である必要があります。
注意
FormControl を使用するときに同じ機能を得るには、NetworkState クラスの IsDestinationReachable(String) メソッドを使用します。
このメンバーには、現在開いているフォームと同じドメインで実行中のフォーム、またはクロスドメインのアクセス許可が与えられたフォームのみがアクセスできます。
この型またはメンバーには、Microsoft InfoPath Filler で開かれたフォームを実行中のコードからのみアクセスできます。
例
次の例では、[ボタン] コントロールをクリックすると、指定した URL に対して接続が可能かどうかが表示されます。
public void CTRL1_Clicked(object sender, ClickedEventArgs e)
{
string result = this.Application.IsDestinationReachable(
"https://www.microsoft.com").ToString();
MessageBox.Show(result);
}
Public Sub CTRL1_Clicked(ByVal sender As Object, _
ByVal e As ClickedEventArgs)
result As String = Me.Application.IsDestinationReachable( _
"https://www.microsoft.com").ToString()
MessageBox.Show(result)
End Sub