AdoQueryConnection.Command Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene o establece el texto de cadena del comando SQL para un AdoQueryConnection objeto .
public:
abstract property System::String ^ Command { System::String ^ get(); void set(System::String ^ value); };
public abstract string Command { get; set; }
member this.Command : string with get, set
Public MustOverride Property Command As String
Valor de propiedad
Texto de comando SQL de la conexión de datos.
Ejemplos
En el ejemplo siguiente, la propiedad Command de la clase ADOQueryConnection y el Execute() método de la DataConnection clase se usan para consultar una tabla de 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, el método Execute se usa para actualizar los datos recuperados por la conexión de datos, lo que actualiza el registro mostrado en un control Tabla repetición que está 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
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 está limitado a trabajar solo con bases de datos de Microsoft SQL Server y Microsoft Access.
Ú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.