AdoQueryConnection.Command (Propiedad)

Obtiene o establece el texto de cadena de comando SQL de un objeto AdoQueryConnection.

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

Sintaxis

Public MustOverride Property Command As String

Dim instance As AdoQueryConnection
Dim value As String

value = instance.Command

instance.Command = value

public abstract string Command { get; set; }

Valor de propiedad

Texto de comando SQL de la conexión de datos.

Comentarios

La propiedad Command del objeto ADOQueryConnection contiene el texto del comando SQL utilizado por la conexión de datos ADO para recuperar datos de un origen de datos ActiveX Data Objects/OLEDB externo.

Nota:
El objeto ADOQueryConnection únicamente funciona con bases de datos de Microsoft SQL Server y Microsoft Access.

Sólo pueden tener acceso a este miembro los formularios que se ejecuten en el mismo dominio que el formulario abierto actualmente o los formularios a los que se hayan concedido permisos entre dominios.

Se puede tener acceso a este tipo o miembro desde un código ejecutado en formularios abiertos en Microsoft Office InfoPath 2007 o en un explorador Web.

Ejemplo

En el siguiente ejemplo, la propiedad Command de la clase ADOQueryConnection y el método Execute de la clase DataConnection se usan para hacer una consulta en una tabla en un origen de datos secundario denominado Employees. La consulta se ejecuta en la conexión de datos creada en el modo de diseño de InfoPath en la base de datos que contiene la tabla Employees, que también se llama "Employees".

Primero se usa el valor escrito por el usuario en el campo my:EmpID para actualizar el texto de comando SQL mediante la propiedad Command. A continuación, se usa el método Execute para actualizar los datos recuperados por la conexión de datos, que actualiza el registro mostrado en un control de Tabla extensible enlazado a la tabla Employees del formulario. En este ejemplo es necesario el campo my:EmpID del origen de datos principal enlazado a un control Cuadro de texto en una vista con un control Button para llamar al siguiente código.

public void RefreshData_Clicked(object sender, ClickedEventArgs e)
{
   // Get the Employees connection from the 
   // DataConnections collection.
   AdoQueryConnection myAdoQueryConnection =
      (AdoQueryConnection)(this.DataConnections["Employees"]);

   // Get the employee's ID from the EmpID field in 
   // the main data source.
   XPathNavigator myNav = 
      CreateNavigator().SelectSingleNode("/my:myFields/my:EmpID", 
      NamespaceManager);
   // Assign the value from the field to a variable.
   string employeeID = myNav.InnerXml;

   // Change the SQL command for Employees connection to retrieve 
   // the record of the Employee's ID entered by the user.
   myAdoQueryConnection.Command = 
      "select * from [Employees] where [EmployeeID] = " + employeeID;

   // Execute the updated command against the data connection to 
   // refresh the data.
   myAdoQueryConnection.Execute();
}

Public Sub RefreshData_Clicked(ByVal sender As Object, ByVal e As ClickedEventArgs)
   ' Get the Employees connection from the 
   ' DataConnections collection.
   Dim myAdoQueryConnection As AdoQueryConnection = _
      DirectCast(Me.DataConnections("Employees"), AdoQueryConnection)

   ' Get the employee's ID from the EmpID field in 
   ' the main data source.
   Dim myNav As XPathNavigator = _
      CreateNavigator().SelectSingleNode("/my:myFields/my:EmpID", _
      NamespaceManager)
   Dim employeeID As String = myNav.InnerXml

   ' Change the SQL command for Employees connection to retrieve 
   ' the record of the Employee's ID entered by the user.
   myAdoQueryConnection.Command = _
      "select * from [Employees] where [EmployeeID] = " + employeeID

   ' Execute the updated command against the data connection to 
   ' refresh the data.
    myAdoQueryConnection.Execute()
End Sub

Vea también

Referencia

AdoQueryConnection (Clase)
AdoQueryConnection (Miembros)
Microsoft.Office.InfoPath (Espacio de nombres)