(XPathNavigator) del método SharepointListQueryConnection.Execute

NOTA: esta API está ahora obsoleta.

Anula el método Execute predeterminado para permitir que se especifique otra ubicación para insertar los datos devueltos.

Espacio de nombres:  Microsoft.Office.InfoPath
Ensamblado:  Microsoft.Office.InfoPath (en Microsoft.Office.InfoPath.dll)

Sintaxis

'Declaración
<ObsoleteAttribute("The SharePointListQueryConnection class has been deprecated. Use SharePointListRWQueryConnection instead.")> _
Public MustOverride Sub Execute ( _
    output As XPathNavigator _
)
'Uso
Dim instance As SharepointListQueryConnection
Dim output As XPathNavigator

instance.Execute(output)

[ObsoleteAttribute("The SharePointListQueryConnection class has been deprecated. Use SharePointListRWQueryConnection instead.")]
public abstract void Execute(
    XPathNavigator output
)

Parámetros

• output
  Tipo: System.Xml.XPath.XPathNavigator

  Objeto XPathNavigator que especifica un nodo XML en el origen de datos principal o en uno secundario del formulario en que se van a insertar los datos devueltos. El objeto XPathNavigator que se pasa como parámetro output puede especificar también que los datos se inserten en cualquier archivo XML del equipo local o en un System.Xml.XmlDocument guardado en la memoria.

Excepciones

Excepción	Condición
WebException	La operación de consulta produjo un error o no devolvió ningún dato (la lista consultada está vacía).
ArgumentNullException	El parámetro pasado a este método es una referencia null (Nothing en Visual Basic).
ArgumentException	El parámetro pasado a este método no es válido. Por ejemplo, es de un tipo o formato no válido.

Comentarios

Si se establece el parámetro output en una referencia null (Nothing en Visual Basic) el resultado es el mismo que el uso del método Execute predeterminado para devolver datos utilizando la configuración declarativa definida en la plantilla de formulario.

Únicamente se puede acceder a este miembro con formularios que se ejecuten en el mismo dominio que el formulario que está actualmente abierto o con formularios a los que se hayan concedido permisos entre dominios.

Se puede acceder a este tipo o miembro desde el código que se ejecuta en los formularios abiertos en Microsoft InfoPath Filler o en un explorador web.

Ejemplos

En el ejemplo siguiente, se usa el método Execute(output) de la clase SharepointListQueryConnection para ejecutar una consulta en la conexión "Contacts" y guardar el resultado en un XmlDocument que se crea en la memoria. A continuación, se muestra el resultado guardado en el XmlDocument en el campo QueryOutput del formulario.

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 SharePoint list defined for the 
   // SharepointListQueryConnection and log the results
   // in the XmlDocument created above.
    SharepointListQueryConnection queryConnection = 
      (SharepointListQueryConnection)(DataConnections["Contacts"]);
    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 SharePoint list defined for the 
   ' SharepointListQueryConnection and log the results
   '  in the XmlDocument created above.
    Dim myQueryConnection As SharepointListQueryConnection  = _
      DirectCast(DataConnections["Contacts"], _
      SharepointListQueryConnection)
    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

Vea también

Referencia

clase SharepointListQueryConnection

Miembros SharepointListQueryConnection

Sobrecarga Execute

Espacio de nombres Microsoft.Office.InfoPath