AdoSubmitConnection.Command Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém ou define o texto da cadeia de caracteres de comando SQL para um AdoSubmitConnection 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 da propriedade
A cadeia de caracteres de comando SQL para a conexão de dados.
Exemplos
No exemplo a seguir, a propriedade Command da classe AdoSubmitConnection e o Execute() método da DataConnection classe são usados para consultar uma tabela em uma fonte de dados secundária chamada Employees. A consulta é executada na conexão de dados criada no modo de design do InfoPath para o banco de dados que contém a tabela Employees , que é chamada de "EmployeesSubmit".
Primeiro, o valor inserido pelo usuário no campo my:EmpID é usado para atualizar o texto do comando SQL usando a propriedade Command . Em seguida, o método Execute é usado para atualizar os dados recuperados pela conexão de dados, que atualiza o registro exibido em um controle Tabela Repetida que vincula à tabela Funcionários no formulário. Este exemplo requer o campo my:EmpID no main fonte de dados vinculada a um controle Text Box em uma exibição que contém um controle Button para invocar o código a seguir.
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
Comentários
A propriedade Command do objeto ADOSubmitConnection contém o texto de comando SQL usado pela conexão de dados ADO para enviar dados a uma fonte de dados externa do ActiveX Data Objects/OLEDB.
Importante: um objeto ADOSubmitConnection só pode existir quando há um objeto ADOQueryConnection correspondente e as conexões de dados representadas por ambos os objetos compartilham o mesmo conjunto de valores de propriedade. Alterar o valor dessa propriedade para o objeto ADOSubmitConnection também alterará o valor da mesma propriedade para o objeto ADOQueryConnection correspondente.
Observação: o objeto ADOSubmitConnection está limitado a funcionar apenas com bancos de dados microsoft SQL Server e Microsoft Access.
This member can be accessed only by forms running in the same domain as the currently open form, or by forms that have been granted cross-domain permissions.
This type or member can be accessed only from code running in forms opened in Microsoft InfoPath Filler.