OracleDataAdapter.UpdateCommand 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 uma instrução SQL ou um procedimento armazenado usado para atualizar registros no banco de dados.
public:
property System::Data::OracleClient::OracleCommand ^ UpdateCommand { System::Data::OracleClient::OracleCommand ^ get(); void set(System::Data::OracleClient::OracleCommand ^ value); };public System.Data.OracleClient.OracleCommand UpdateCommand { get; set; }member this.UpdateCommand : System.Data.OracleClient.OracleCommand with get, setPublic Property UpdateCommand As OracleCommandValor da propriedade
Um OracleCommand usado durante uma operação de atualização para atualizar registros no banco de dados que correspondem às linhas modificadas no DataSet.
Exemplos
O exemplo a seguir cria um OracleDataAdapter e define as SelectCommand propriedades e UpdateCommand . Ele pressupõe que você já tenha criado um OracleConnection objeto .
Public Shared Function CreateCustomerAdapter(conn As OracleConnection) As OracleDataAdapter
Dim da As OracleDataAdapter = New OracleDataAdapter()
Dim cmd As OracleCommand
Dim parm As OracleParameter
' Create the SelectCommand.
cmd = New OracleCommand("SELECT * FROM Dept " & _
"WHERE DName = pDName AND Loc = pLoc", conn)
cmd.Parameters.Add("pDName", OracleType.NVarChar, 14)
cmd.Parameters.Add("pLoc", OracleType.NVarChar, 13)
da.SelectCommand = cmd
' Create the UpdateCommand.
cmd = New OracleCommand("UPDATE Dept SET DeptNo = pDeptNo, DName = pDName " & _
"WHERE DeptNo = poldDeptNo", conn)
cmd.Parameters.Add("pDeptNo", OracleType.Number, 2, "DeptNo")
cmd.Parameters.Add("pDName", OracleType.NVarChar, 14, "DName")
parm = cmd.Parameters.Add("poldDeptNo", OracleType.Number, 2, "DeptNo")
parm.SourceVersion = DataRowVersion.Original
da.UpdateCommand = cmd
Return da
End Function
public static OracleDataAdapter CreateCustomerAdapter(OracleConnection conn)
{
OracleDataAdapter da = new OracleDataAdapter();
OracleCommand cmd;
OracleParameter parm;
// Create the SelectCommand.
cmd = new OracleCommand("SELECT * FROM Dept " +
"WHERE DName = pDName AND Loc = pLoc", conn);
cmd.Parameters.Add("pDName", OracleType.NVarChar, 14);
cmd.Parameters.Add("pLoc", OracleType.NVarChar, 13);
da.SelectCommand = cmd;
// Create the UpdateCommand.
cmd = new OracleCommand("UPDATE Dept SET DeptNo = pDeptNo, DName = pDName " +
"WHERE DeptNo = poldDeptNo", conn);
cmd.Parameters.Add("pDeptNo", OracleType.Number, 2, "DeptNo");
cmd.Parameters.Add("pDName", OracleType.NVarChar, 14, "DName");
parm = cmd.Parameters.Add("poldDeptNo", OracleType.Number, 2, "DeptNo");
parm.SourceVersion = DataRowVersion.Original;
da.UpdateCommand = cmd;
return da;
}
Comentários
Quando UpdateCommand é atribuído a um criado OracleCommandanteriormente, o OracleCommand não é clonado. Em vez disso, o UpdateCommand mantém uma referência ao objeto criado OracleCommand anteriormente.
Durante uma operação de atualização, se InsertCommand não estiver definido e as informações de chave primária estiverem presentes no DataSet, você poderá usar a OracleCommandBuilder classe para gerar InsertCommandautomaticamente e comandos adicionais necessários para reconciliar o DataSet com o banco de dados. Para fazer isso, defina a SelectCommand propriedade do OracleDataAdapter. A lógica de geração também exige que as informações de coluna de chave estejam presentes no DataSet. Para obter mais informações, consulte Gerando comandos com CommandBuilders.
Observação
Se a execução desse comando retornar linhas, essas linhas poderão ser mescladas com a DataSet dependendo de como você definir a UpdatedRowSource propriedade do OracleCommand objeto.
Quando você atualiza uma coluna com o LONG RAW tipo de dados, uma exceção é gerada quando você insere um valor de NULL na coluna. O tipo de dados Oracle LONG RAW é um tipo preterido no Oracle versão 8.0. Para evitar esse erro, use o BLOB tipo de dados em vez de LONG RAW.
