EmailSubmitConnection.Execute メソッド (XPathNavigator)
既定の Execute メソッドをオーバーライドし、送信する別のソースのデータの指定を許可します。
名前空間: Microsoft.Office.InfoPath
アセンブリ: Microsoft.Office.InfoPath (Microsoft.Office.InfoPath.dll)
構文
'宣言
Public MustOverride Sub Execute ( _
input As XPathNavigator _
)
'使用
Dim instance As EmailSubmitConnection
Dim input As XPathNavigator
instance.Execute(input)
public abstract void Execute(
XPathNavigator input
)
パラメーター
- input
型: System.Xml.XPath.XPathNavigator
送信するデータを含む XML ノードに配置された XPathNavigator オブジェクト。
例外
例外 | 条件 |
---|---|
ArgumentNullException | このメソッドに渡されるパラメーターは null 参照 (Visual Basic ではNothing ) です。 |
ArgumentException | このメソッドに渡されるパラメーターは有効ではありません。たとえば、型または形式が正しくありません。 |
解説
このメソッドは、フォームのメイン データ ソースを送信する既定の Execute() メソッド (DataConnection ベース クラスから継承) をオーバーライドします。input パラメーターに指定された XPathNavigator オブジェクトは、送信するデータを含む XML ノードを示す必要があります。送信するデータは、任意の DataSource オブジェクトによって指定できます。
input パラメーターに NULL を設定すると、フォーム テンプレートに定義された宣言の設定を使用してフォーム全体を送信する既定の Execute() メソッドを使用するのと同じ効果があります。
このメンバーには、現在開いているフォームと同じドメインで実行中のフォーム、またはクロスドメインのアクセス許可が与えられたフォームのみがアクセスできます。
この型またはメンバーには、Microsoft InfoPath Filler または Web ブラウザーで開かれたフォームを実行中のコードからアクセスできます。
例
次の例では、Execute(XPathNavigator) メソッドを使って、"Email Submit" という名前のデータ接続にフォームを送信します。このときに、フォームのメイン データ ソースではなく "QueryTypedDataSet" という名前のデータ ソースからのデータを使用します。
public void FormEvents_Submit(object sender, SubmitEventArgs e)
{
XmlForm myXmlForm = this;
XPathNavigator myNav = myXmlForm.DataSources[
"QueryTypedDataSet"].CreateNavigator();
EmailSubmitConnection mySubmit = (EmailSubmitConnection)myXmlForm.
DataConnections["Email Submit"];
mySubmit.Execute(myNav);
}
Public Sub FormEvents_Submit(ByVal sender As Object, _
ByVal e As SubmitEventArgs)
Dim myXmlForm As XmlForm = Me
Dim myNav As XPathNavigator = myXmlForm.DataSources(_
"QueryTypedDataSet").CreateNavigator()
EmailSubmitConnection mySubmit = DirectCast( _
myXmlForm.DataConnections("Email Submit"),EmailSubmitConnection)
mySubmit.Execute(myNav)
End Sub