OracleDataAdapter Classe

Definição

public ref class OracleDataAdapter sealed : System::Data::Common::DbDataAdapter, System::Data::IDbDataAdapter

public ref class OracleDataAdapter sealed : System::Data::Common::DbDataAdapter, ICloneable

public sealed class OracleDataAdapter : System.Data.Common.DbDataAdapter, System.Data.IDbDataAdapter

public sealed class OracleDataAdapter : System.Data.Common.DbDataAdapter, ICloneable

[System.Obsolete("OracleDataAdapter has been deprecated. http://go.microsoft.com/fwlink/?LinkID=144260", false)]
public sealed class OracleDataAdapter : System.Data.Common.DbDataAdapter, ICloneable

type OracleDataAdapter = class
    inherit DbDataAdapter
    interface IDbDataAdapter
    interface IDataAdapter

type OracleDataAdapter = class
    inherit DbDataAdapter
    interface IDbDataAdapter
    interface IDataAdapter
    interface ICloneable

[<System.Obsolete("OracleDataAdapter has been deprecated. http://go.microsoft.com/fwlink/?LinkID=144260", false)>]
type OracleDataAdapter = class
    inherit DbDataAdapter
    interface IDbDataAdapter
    interface IDataAdapter
    interface ICloneable

Public NotInheritable Class OracleDataAdapter
Inherits DbDataAdapter
Implements IDbDataAdapter

Public NotInheritable Class OracleDataAdapter
Inherits DbDataAdapter
Implements ICloneable

Herança

Object

MarshalByRefObject

Component

DataAdapter

DbDataAdapter

OracleDataAdapter

Atributos

ObsoleteAttribute

Implementações

IDataAdapter IDbDataAdapter ICloneable

Comentários

Esse tipo foi preterido e será removido em uma versão futura do .NET Framework. Para obter mais informações, consulte Oracle e ADO.NET.

O OracleDataAdapter serve como uma ponte entre um DataSet e um banco de dados para recuperar e salvar dados. O OracleDataAdapter fornece essa ponte usando Fill para carregar dados do banco de dados no DataSete usando Update para enviar alterações feitas na DataSet parte de trás para a fonte de dados.

Quando o OracleDataAdapter preenche um DataSet, ele cria as tabelas e colunas necessárias para os dados retornados se eles ainda não existirem. No entanto, as informações de chave primária não são incluídas no esquema criado implicitamente, a menos que a MissingSchemaAction propriedade esteja definida como AddWithKey. Você também pode ter a criação OracleDataAdapter do esquema do , incluindo informações de DataSetchave primária, antes de preenchê-lo com dados usando FillSchema. Para obter mais informações, consulte Adicionando restrições existentes a um Conjunto de Dados.

O OracleDataAdapter também inclui as propriedades , InsertCommand, DeleteCommand, UpdateCommande TableMappings para facilitar o SelectCommandcarregamento e a atualização de dados.

O provedor de dados .NET Framework para Oracle não dá suporte a instruções SQL em lote. No entanto, ele permite que você use vários REF CURSOR parâmetros de saída para preencher um DataSet, cada um em seu próprio DataTable. Você deve definir os parâmetros, marcá-los como parâmetros de saída e indicar que eles são REF CURSOR tipos de dados. Observe que você não pode usar o Update método quando o OracleDataAdapter é preenchido usando REF CURSOR parâmetros retornados por um procedimento armazenado, pois o Oracle não fornece as informações necessárias para determinar quais são os nomes de tabela e coluna quando a instrução SQL é executada. O exemplo de C# a seguir pressupõe que você tenha criado esse procedimento armazenado.

Crie o seguinte pacote Oracle no servidor Oracle.

CREATE OR REPLACE PACKAGE CURSPKG AS   
   TYPE T_CURSOR IS REF CURSOR;   
   PROCEDURE OPEN_ONE_CURSOR (N_EMPNO IN NUMBER,   
      IO_CURSOR OUT T_CURSOR);   
   PROCEDURE OPEN_TWO_CURSORS (EMPCURSOR OUT T_CURSOR,   
      DEPTCURSOR OUT T_CURSOR);  
END CURSPKG;  
/  

Crie o seguinte corpo do pacote Oracle no servidor Oracle.

CREATE OR REPLACE PACKAGE BODY CURSPKG AS   
    PROCEDURE OPEN_ONE_CURSOR (N_EMPNO IN NUMBER,   
                               IO_CURSOR OUT T_CURSOR)   
    IS   
        V_CURSOR T_CURSOR;   
    BEGIN   
        IF N_EMPNO <> 0 THEN   
             OPEN V_CURSOR FOR   
             SELECT EMP.EMPNO, EMP.ENAME, DEPT.DEPTNO, DEPT.DNAME   
                  FROM EMP, DEPT   
                  WHERE EMP.DEPTNO = DEPT.DEPTNO   
                        AND EMP.EMPNO = N_EMPNO;   
        ELSE   
             OPEN V_CURSOR FOR   
             SELECT EMP.EMPNO, EMP.ENAME, DEPT.DEPTNO, DEPT.DNAME   
                  FROM EMP, DEPT   
                  WHERE EMP.DEPTNO = DEPT.DEPTNO;   
        END IF;   
        IO_CURSOR := V_CURSOR;   
    END OPEN_ONE_CURSOR;   
    PROCEDURE OPEN_TWO_CURSORS (EMPCURSOR OUT T_CURSOR,   
                                DEPTCURSOR OUT T_CURSOR)   
    IS   
        V_CURSOR1 T_CURSOR;   
        V_CURSOR2 T_CURSOR;   
    BEGIN   
        OPEN V_CURSOR1 FOR SELECT * FROM EMP;   
        OPEN V_CURSOR2 FOR SELECT * FROM DEPT;   
        EMPCURSOR  := V_CURSOR1;   
        DEPTCURSOR := V_CURSOR2;   
    END OPEN_TWO_CURSORS;   
END CURSPKG;  
 /  

O exemplo de C# a seguir demonstra como você pode obter informações de tabela e coluna usando o procedimento armazenado.

// GetConnectionString() returns a connection string for  
// the data source.  

string connString = GetConnectionString();  
DataSet ds = new DataSet();  
OracleConnection conn = new OracleConnection(connString);  
OracleCommand cmd = conn.CreateCommand();  

cmd.CommandText = "CURSPKG.OPEN_TWO_CURSORS";  
cmd.CommandType = CommandType.StoredProcedure;  
cmd.Parameters.Add("EMPCURSOR", OracleType.Cursor).Direction =   
       ParameterDirection.Output;  
cmd.Parameters.Add("DEPTCURSOR", OracleType.Cursor).Direction =   
       ParameterDirection.Output;  

OracleDataAdapter da = new OracleDataAdapter(cmd);  
da.TableMappings.Add("Table", "Emp");  
da.TableMappings.Add("Table1", "Dept");  
da.Fill(ds);  

ds.Relations.Add("EmpDept", ds.Tables["Dept"].Columns["Deptno"],   
      ds.Tables["Emp"].Columns["Deptno"], false);  

O exemplo do Visual Basic a seguir demonstra como usar um OracleDataAdapter para preencher um DataSet usando um Oracle REF CURSOR. Esses exemplos usam tabelas definidas no esquema Oracle Scott/Tiger e exigem o seguinte pacote PL/SQL e o corpo do pacote. Você deve criá-los no servidor para usar os exemplos.

Crie o seguinte pacote Oracle no servidor Oracle.

CREATE OR REPLACE PACKAGE CURSPKG AS   
   TYPE T_CURSOR IS REF CURSOR;   
   PROCEDURE OPEN_ONE_CURSOR (N_EMPNO IN NUMBER,   
      IO_CURSOR OUT T_CURSOR);   
   PROCEDURE OPEN_TWO_CURSORS (EMPCURSOR OUT T_CURSOR,   
      DEPTCURSOR OUT T_CURSOR);  
END CURSPKG;  
/  

Crie o seguinte corpo do pacote Oracle no servidor Oracle.

CREATE OR REPLACE PACKAGE BODY CURSPKG AS   
    PROCEDURE OPEN_ONE_CURSOR (N_EMPNO IN NUMBER,   
                               IO_CURSOR OUT T_CURSOR)   
    IS   
        V_CURSOR T_CURSOR;   
    BEGIN   
        IF N_EMPNO <> 0 THEN   
             OPEN V_CURSOR FOR   
             SELECT EMP.EMPNO, EMP.ENAME, DEPT.DEPTNO, DEPT.DNAME   
                  FROM EMP, DEPT   
                  WHERE EMP.DEPTNO = DEPT.DEPTNO   
                        AND EMP.EMPNO = N_EMPNO;   
        ELSE   
             OPEN V_CURSOR FOR   
             SELECT EMP.EMPNO, EMP.ENAME, DEPT.DEPTNO, DEPT.DNAME   
                  FROM EMP, DEPT   
                  WHERE EMP.DEPTNO = DEPT.DEPTNO;   
        END IF;   
        IO_CURSOR := V_CURSOR;   
    END OPEN_ONE_CURSOR;   
    PROCEDURE OPEN_TWO_CURSORS (EMPCURSOR OUT T_CURSOR,   
                                DEPTCURSOR OUT T_CURSOR)   
    IS   
        V_CURSOR1 T_CURSOR;   
        V_CURSOR2 T_CURSOR;   
    BEGIN   
        OPEN V_CURSOR1 FOR SELECT * FROM EMP;   
        OPEN V_CURSOR2 FOR SELECT * FROM DEPT;   
        EMPCURSOR  := V_CURSOR1;   
        DEPTCURSOR := V_CURSOR2;   
    END OPEN_TWO_CURSORS;   
END CURSPKG;  
 /  

Este exemplo do Visual Basic executa um procedimento armazenado PL/SQL que retorna dois REF CURSOR parâmetros e preenche um DataSet com as linhas retornadas.

' GetConnectionString() returns a connection string for  
' the data source.  

    Dim connString As New String(GetConnectionString())  
    Dim ds As New DataSet()  
    Dim conn As New OracleConnection(connString)  
    Dim cmd As OracleCommand = conn.CreateCommand()  

    cmd.CommandText = "CURSPKG.OPEN_TWO_CURSORS"  
    cmd.CommandType = CommandType.StoredProcedure  
    cmd.Parameters.Add("EMPCURSOR", OracleType.Cursor).Direction = _  
       ParameterDirection.Output  
    cmd.Parameters.Add("DEPTCURSOR", OracleType.Cursor).Direction = _  
       ParameterDirection.Output  

    Dim da As New OracleDataAdapter(cmd)  
    da.TableMappings.Add("Table", "Emp")  
    da.TableMappings.Add("Table1", "Dept")  
    da.Fill(ds)  

    ds.Relations.Add("EmpDept", ds.Tables("Dept").Columns("Deptno"), _  
      ds.Tables("Emp").Columns("Deptno"), False)  

Depois de usar o OracleDataAdapter para executar uma Fill operação ou FillSchema , a DataColumn.ReadOnly propriedade sempre retorna false, independentemente de uma coluna ser atualizada ou não, porque o servidor Oracle não retorna essas informações.

Construtores

Campos

Propriedades

Métodos

Eventos

Implantações explícitas de interface

Aplica-se a

Confira também

• Recuperando e modificando dados no ADO.NET