OracleDataAdapter Classe

Définition

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

Héritage

Object

MarshalByRefObject

Component

DataAdapter

DbDataAdapter

OracleDataAdapter

Attributs

ObsoleteAttribute

Implémente

IDataAdapter IDbDataAdapter ICloneable

Remarques

Ce type est déconseillé et sera supprimé dans une version ultérieure du .NET Framework. Pour plus d’informations, consultez Oracle et ADO.NET.

Sert OracleDataAdapter de pont entre un DataSet et une base de données pour récupérer et enregistrer des données. Le OracleDataAdapter fournit ce pont en utilisant Fill pour charger des données de la base de données dans le DataSet, et en utilisant Update pour envoyer les modifications apportées dans le DataSet retour à la source de données.

Lorsque le OracleDataAdapter remplit un DataSet, il crée les tables et colonnes nécessaires pour les données retournées si elles n’existent pas déjà. Toutefois, les informations de clé primaire ne sont pas incluses dans le schéma créé implicitement, sauf si la MissingSchemaAction propriété est définie sur AddWithKey. Vous pouvez également créer OracleDataAdapter le schéma du , y compris les informations de clé primaire, avant de le remplir avec des données à l’aide DataSetFillSchemade . Pour plus d’informations, consultez Ajout de contraintes existantes à un DataSet.

Inclut également les propriétés , InsertCommand, DeleteCommand, UpdateCommandet TableMappings pour faciliter le SelectCommandOracleDataAdapter chargement et la mise à jour des données.

Le fournisseur de données .NET Framework pour Oracle ne prend pas en charge les instructions SQL par lots. Toutefois, il vous permet d’utiliser plusieurs REF CURSOR paramètres de sortie pour remplir un DataSet, chacun dans son propre DataTable. Vous devez définir les paramètres, les marquer comme paramètres de sortie et indiquer qu’il s’agit REF CURSOR de types de données. Notez que vous ne pouvez pas utiliser la Update méthode lorsque le est rempli à l’aide OracleDataAdapterREF CURSOR de paramètres retournés par une procédure stockée, car Oracle ne fournit pas les informations nécessaires pour déterminer le nom de la table et les noms de colonne lors de l’exécution de l’instruction SQL. L’exemple C# suivant suppose que vous avez créé cette procédure stockée.

Créez le package Oracle suivant sur le serveur 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;  
/  

Créez le corps du package Oracle suivant sur le serveur 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;  
 /  

L’exemple C# suivant montre comment obtenir des informations de table et de colonne à l’aide de la procédure stockée.

// 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);  

L’exemple Visual Basic suivant montre comment utiliser un OracleDataAdapter pour remplir un à l’aide d’un DataSet oracle REF CURSOR. Ces exemples utilisent des tables définies dans le schéma Oracle Scott/Tiger et nécessitent le package PL/SQL et le corps de package suivants. Vous devez les créer sur votre serveur pour utiliser les exemples.

Créez le package Oracle suivant sur le serveur 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;  
/  

Créez le corps du package Oracle suivant sur le serveur 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;  
 /  

Cet exemple Visual Basic exécute une procédure stockée PL/SQL qui retourne deux REF CURSOR paramètres et remplit un DataSet avec les lignes retournées.

' 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)  

Après avoir utilisé pour OracleDataAdapter effectuer une Fill opération ou FillSchema , la DataColumn.ReadOnly propriété retourne toujours false, qu’une colonne puisse être mise à jour ou non, car le serveur Oracle ne retourne pas ces informations.

Constructeurs

Champs

Propriétés

Méthodes

Événements

Implémentations d’interfaces explicites

S’applique à

Voir aussi

• Extraction et modification de données dans ADO.NET