AdoSubmitConnection.Command Propiedad

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

Cadena del comando SQL para la conexión de datos.

Ejemplos

En el ejemplo siguiente, la propiedad Command de la clase AdoSubmitConnection 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 realiza mediante 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 se llama "EmployeesSubmit".

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, que actualiza el registro mostrado en un control De tabla repetición que enlaza 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.
   AdoSubmitConnection myAdoSubmitConnection =
      (AdoSubmitConnection)(this.DataConnections["EmployeesSubmit"]);

   // 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.
   myAdoSubmitConnection.Command = 
      "select * from [Employees] where [EmployeeID] = " + employeeID;

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

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

   ' 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.
    myAdoSubmitConnection.Execute()
End Sub

Comentarios

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

Importante: Un objeto ADOSubmitConnection solo puede existir cuando hay un objeto ADOQueryConnection correspondiente y las conexiones de datos representadas por ambos objetos comparten el mismo conjunto de valores de propiedad. Si se cambia el valor de la propiedad para el objeto ADOSubmitConnection, también cambiará el valor de la misma propiedad para el objeto ADOQueryConnection correspondiente.

Nota: El objeto ADOSubmitConnection 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.

Únicamente se puede acceder a este tipo o miembro desde el código que se ejecuta en los formularios abiertos en Microsoft InfoPath Filler.

Se aplica a