FileQueryConnection.Execute 메서드 (XPathNavigator)

반환되는 데이터를 삽입할 다른 위치를 지정할 수 있도록 기본 Execute 메서드를 재정의합니다.

네임스페이스:  Microsoft.Office.InfoPath
어셈블리:  Microsoft.Office.InfoPath(Microsoft.Office.InfoPath.dll)

구문

‘선언
Public MustOverride Sub Execute ( _
    output As XPathNavigator _
)
‘사용 방법
Dim instance As FileQueryConnection
Dim output As XPathNavigator

instance.Execute(output)

public abstract void Execute(
    XPathNavigator output
)

매개 변수

• output
  형식: System.Xml.XPath.XPathNavigator
  양식의 기본 또는 보조 데이터 원본에서 반환 데이터를 삽입할 XML 노드를 지정하는 XPathNavigator입니다. 또한 output 매개 변수로 전달된 XPathNavigator를 사용하면 데이터를 로컬 컴퓨터의 XML 파일 또는 메모리의 XmlDocument에 삽입하도록 지정할 수도 있습니다.

예외

예외	조건
WebException	쿼리 작업이 실패했습니다.
ArgumentNullException	이 메서드에 전달된 매개 변수가 Null 참조(Visual Basic의Nothing )입니다.
ArgumentException	이 메서드에 전달된 매개 변수가 유효하지 않습니다. 예를 들면 유형이나 형식이 잘못되었습니다.

주의

output 매개 변수를 Null 참조(Visual Basic의Nothing )로 설정하면 양식 서식 파일에 정의된 선언적 설정을 사용하여 데이터를 반환하기 위해 기본 Execute 메서드(DataConnection 기본 클래스에서 상속됨)를 사용하는 것과 결과가 같습니다.

이 멤버는 현재 열려 있는 양식과 같은 도메인에서 실행하는 양식 또는 도메인 간 권한이 부여된 양식에서만 액세스할 수 있습니다.

이 형식 또는 멤버는 Microsoft InfoPath Filer 또는 웹 브라우저에서 연 양식에서 실행되는 코드에서 액세스할 수 있습니다.

예

다음 예제에서는 FileQueryConnection 클래스의 Execute(output) 메서드를 사용하여 "List.xml" 파일에 대해 쿼리를 실행하고, 그 결과를 메모리에 만든 XmlDocument에 저장합니다. 그런 다음 XmlDocument에 저장된 결과를 양식의 QueryOutput 필드에 표시합니다.

public void ExecuteOutput_Clicked(object sender, ClickedEventArgs e)
{
   // Create the XmlDocument to accept the query results.
   XmlDocument outputFile = new XmlDocument();
   outputFile.LoadXml(
      "<?xml version=\"1.0\" encoding=\"utf-8\" ?><outputRoot></outputRoot>");

   // Create XmlNamespaceManager for XmlDocument object. When
   // creating a more complex document, use AddNamespace method
   // to add a mapping from namespace prefix to namespace URL for 
   // each namespace to this object.
   XmlNamespaceManager outputFileNamespaceManager = 
      new XmlNamespaceManager(outputFile.NameTable);

   // Create an XPathNavigator positioned at the root of the
   // XmlDocument output file created above.
   XPathNavigator outputFileNavigator = outputFile.CreateNavigator();
   XPathNavigator outputRootNavigator = 
      outputFileNavigator.SelectSingleNode("/outputRoot", 
      outputFileNamespaceManager);

   // Query the XML file defined for the FileQueryConnection
   // and log the results in the XmlDocument created above.
    FileQueryConnection queryConnection = 
      (FileQueryConnection)(DataConnections["List.xml"]);
    queryConnection.Execute(outputRootNavigator);

   // Insert the results of the query from the XmlDocument in the 
   // QueryOutput field of the main data source of the form.
   XPathNavigator mainNavigator = MainDataSource.CreateNavigator();
   XPathNavigator queryOutputNavigator = 
      mainNavigator.SelectSingleNode("/my:myFields/my:QueryOutput",
      NamespaceManager);
    queryOutputNavigator.SetValue(outputRootNavigator.InnerXml);
}

Public Sub ExecuteOutput_Clicked(ByVal sender As Object , _
   ByVal e As ClickedEventArgs)
{
   ' Create the XmlDocument to accept the query results.
   Dim outputFile As XmlDocument = new XmlDocument()
   outputFile.LoadXml(
      "<?xml version=\"1.0\" encoding=\"utf-8\" ?><outputRoot></outputRoot>")

   ' Create XmlNamespaceManager for XmlDocument object. When
   ' creating a more complex document, use AddNamespace method
   ' to add a mapping from namespace prefix to namespace URL for 
   ' each namespace to this object.
   Dim outputFileNamespaceManager As XmlNamespaceManager  = _
      new XmlNamespaceManager(outputFile.NameTable)

   ' Create an XPathNavigator positioned at the root of the
   ' XmlDocument output file created above.
   Dim outputFileNavigator As XPathNavigator = _
      outputFile.CreateNavigator()
   Dim outputRootNavigator As XPathNavigator = 
      outputFileNavigator.SelectSingleNode("/outputRoot", 
      outputFileNamespaceManager)

   ' Query the XML file defined for the FileQueryConnection
   ' and log the results in the XmlDocument created above.
    Dim myQueryConnection As FileQueryConnection  = _
      DirectCast(DataConnections["List.xml"], FileQueryConnection)
    myQueryConnection.Execute(outputRootNavigator);

   ' Insert the results of the query from the XmlDocument 
   ' in the QueryOutput field of the main data source of the form.
   Dim mainNavigator As XPathNavigator  = _
      MainDataSource.CreateNavigator()
   Dim queryOutputNavigator As XPathNavigator  = 
      mainNavigator.SelectSingleNode("/my:myFields/my:QueryOutput", _
      NamespaceManager)
    queryOutputNavigator.SetValue(outputRootNavigator.InnerXml)
End Sub

참고 항목

참조

FileQueryConnection 클래스

FileQueryConnection 멤버

Execute 오버로드

Microsoft.Office.InfoPath 네임스페이스