FileSubmitConnection.Execute メソッド (XPathNavigator)
既定の Execute メソッドをオーバーライドして、送信に別のデータ ソースを指定できるようにします。
名前空間: Microsoft.Office.InfoPath
アセンブリ: Microsoft.Office.InfoPath (Microsoft.Office.InfoPath.dll)
構文
'宣言
Public MustOverride Sub Execute ( _
input As XPathNavigator _
)
'使用
Dim instance As FileSubmitConnection
Dim input As XPathNavigator
instance.Execute(input)
public abstract void Execute(
XPathNavigator input
)
パラメーター
- input
型: System.Xml.XPath.XPathNavigator
送信するデータが格納されたフォームの XML ノードに配置されている XPathNavigator。
例外
| 例外 | 条件 |
|---|---|
| WebException | 送信操作が失敗しました。 |
| ArgumentNullException | このメソッドに渡されたパラメーターは null 参照 (Visual Basic ではNothing ) です。 |
| ArgumentException | このメソッドに渡されたパラメーターは有効ではありません。たとえば、型または形式が正しくありません。 |
解説
このメソッドは、フォーム テンプレート内で宣言で定義されているデータを送信する既定の Execute メソッド (DataConnection 基本クラスから継承されたメソッド) をオーバーライドします。input パラメーターに指定された XPathNavigator オブジェクトは、送信されるデータが格納されている XML 要素を指している必要があります。送信するデータは、任意の DataSource オブジェクトで指定できます。
input パラメーターに null 参照 (Visual Basic ではNothing ) を設定すると、フォーム テンプレート内で定義された宣言の設定を使用してデータを送信する Execute メソッドを使用した場合と同じ結果が得られます。
このメンバーには、現在開いているフォームと同じドメインで実行中のフォーム、またはクロスドメインのアクセス許可が与えられたフォームのみがアクセスできます。
この型またはメンバーには、Microsoft InfoPath Filler または Web ブラウザーで開かれたフォームを実行中のコードからアクセスできます。
例
次の例では、Execute(input) メソッドを使用して FileSubmitConnection オブジェクトにより定義された SharePoint Library への送信操作を実行して、フォームのメインのデータ ソース内の UniqueValue ノードの内容を送信しています。
public void ExecuteInput_Clicked(object sender, ClickedEventArgs e)
{
string UniqueValueXPath = "/my:myFields/my:UniqueValue";
XPathNavigator mainNavigator = MainDataSource.CreateNavigator();
XPathNavigator uniqueValueNavigator =
mainNavigator.SelectSingleNode(UniqueValueXPath,
NamespaceManager);
FileSubmitConnection submitConnection =
(FileSubmitConnection)(DataConnections["SharePoint Library"]);
submitConnection.Execute(uniqueValueNavigator);
}
Public Sub ExecuteInput_Clicked(ByVal sender As Object, _
ByVal e As ClickedEventArgs)
Dim UniqueValueXPath As String = "/my:myFields/my:UniqueValue"
Dim mainNavigator As XPathNavigator =
MainDataSource.CreateNavigator()
Dim uniqueValueNavigator As XPathNavigator =
mainNavigator.SelectSingleNode(UniqueValueXPath,
NamespaceManager)
Dim submitConnection As FileSubmitConnection =
DirectCast(DataConnections["SharePoint Library"], _
FileSubmitConnection)
submitConnection.Execute(uniqueValueNavigator)
End Sub