Partager via


Récupération des valeurs des champs Identité ou NuméroAuto (ADO.NET)

Dans une base de données relationnelle, une clé primaire est une colonne ou une combinaison de colonnes qui contient toujours des valeurs uniques. Si vous connaissez la valeur d'une clé primaire, vous pouvez rechercher la ligne qui la contient. Les moteurs de base de données relationnelle, comme SQL Server, Oracle et Microsoft Access/Jet prennent en charge la création de colonnes à incrémentation automatique qui peuvent être désignées comme clés primaires. Ces valeurs sont générées par le serveur lorsque des lignes sont ajoutées à une table. Dans SQL Server, vous définissez la propriété d'identité d'une colonne, dans Oracle vous créez une séquence et dans Microsoft Access vous créez une colonne NuméroAuto.

Un objet DataColumn peut également être utilisé pour générer des valeurs d'auto-incrémentation en affectant la valeur true à AutoIncrement. Cependant, vous risquez de vous retrouver avec des valeurs dupliquées dans des instances distinctes d'un objet DataTable, si plusieurs applications clientes génèrent chacune de leur côté des valeurs d'auto-incrémentation. Le fait de laisser le serveur générer des valeurs d'auto-incrémentation supprime les conflits potentiels en permettant à chaque utilisateur de récupérer la valeur générée pour chaque ligne insérée.

Au cours d'un appel de la méthode Update d'un objet DataAdapter, la base de données peut renvoyer des données à votre application ADO.NET sous la forme de paramètres de sortie ou de premier enregistrement retourné du jeu de résultats d'une instruction SELECT exécutée dans le même lot que l'instruction INSERT. ADO.NET peut récupérer ces valeurs et mettre à jour les colonnes correspondantes dans l'objet DataRow en cours de mise à jour.

Certains moteurs de base de données, comme Microsoft Access Jet, ne prennent pas en charge les paramètres de sortie et ne peuvent pas traiter plusieurs instructions dans un même lot. Avec le moteur de base de données Jet, vous pouvez récupérer la nouvelle valeur NuméroAuto générée pour une ligne insérée en exécutant une commande SELECT distincte dans un gestionnaire d'événements pour l'événement RowUpdated de l'objet DataAdapter.

RemarqueRemarque

Plutôt que d'utiliser une valeur d'auto-incrémentation, vous pouvez utiliser la méthode NewGuid d'un objet Guid pour générer un GUID, ou identificateur global unique, sur l'ordinateur client qui peut être copié sur le serveur dès qu'une nouvelle ligne est insérée.La méthode NewGuid génère une valeur binaire encodée sur 16 octets créée à l'aide d'un algorithme qui offre une forte probabilité qu'aucun valeur ne sera dupliquée.Dans une base de données SQL Server, un GUID est stocké dans une colonne uniqueidentifier qui peut être générée automatiquement par SQL Server à l'aide de la fonction NEWID() Transact-SQL.L'utilisation d'un GUID comme clé primaire peut nuire aux performances.SQL Server 2005 introduit la prise en charge de la fonction NEWSEQUENTIALID() qui génère un GUID séquentiel dont l'unicité globale n'est pas garantie, mais qui peut être indexé de manière plus efficace.

Extraction de valeurs de colonne d'identité SQL Server

Avec Microsoft SQL Server, vous pouvez créer une procédure stockée contenant un paramètre de sortie qui permet de retourner la valeur d'identité d'une ligne insérée. Le tableau suivant décrit les trois fonctions Transact-SQL disponibles dans SQL Server qui peuvent être utilisées pour récupérer la valeur des colonnes d'identité.

Fonction

Description

SCOPE_IDENTITY

Retourne la dernière valeur d'identité de l'étendue d'exécution actuelle. La fonction SCOPE_IDENTITY est recommandée dans la plupart des scénarios.

@@IDENTITY

Contient la dernière valeur d'identité générée dans toute table de la session active. La fonction @@IDENTITY peut être affectée par des déclencheurs et peut ne pas retourner la valeur d'identité que vous attendez.

IDENT_CURRENT

Retourne la dernière valeur d'identité générée pour une table spécifique dans toute session et portée.

La procédure stockée suivante montre comment insérer une nouvelle ligne dans la table Categories et utilise un paramètre de sortie pour retourner la nouvelle valeur d'identité générée par la fonction SCOPE_IDENTITY() de Transact-SQL.

CREATE PROCEDURE dbo.InsertCategory
  @CategoryName nvarchar(15),
  @Identity int OUT
AS
INSERT INTO Categories (CategoryName) VALUES(@CategoryName)
SET @Identity = SCOPE_IDENTITY()

La procédure stockée peut ensuite être spécifiée comme source de la propriété InsertCommand d'un objet SqlDataAdapter. La propriété CommandType de la propriété InsertCommand doit avoir la valeur StoredProcedure. La sortie d'identité est récupérée en créant un objet SqlParameter dont un objet ParameterDirection a la valeur Output. Lorsque InsertCommand est traité, la valeur d'identité auto-incrémentée est retournée et placée dans la colonne CategoryID de la ligne en cours si vous avez affecté la valeur UpdateRowSource.OutputParameters ou UpdateRowSource.Both à l'objet UpdatedRowSource.

Si la commande d'insertion exécute un lot qui comprend à la fois une instruction INSERT et une instruction SELECT qui retourne la nouvelle valeur d'identité, vous pouvez alors récupérer la nouvelle valeur en affectant la valeur UpdateRowSource.FirstReturnedRecord à la propriété UpdatedRowSource.

Private Sub RetrieveIdentity(ByVal connectionString As String)
    Using connection As SqlConnection = New SqlConnection( _
       connectionString)

        ' Create a SqlDataAdapter based on a SELECT query.
        Dim adapter As SqlDataAdapter = New SqlDataAdapter( _
           "SELECT CategoryID, CategoryName FROM dbo.Categories", _
           connection)

        ' Create the SqlCommand to execute the stored procedure. 
        adapter.InsertCommand = New SqlCommand("dbo.InsertCategory", _
           connection)
        adapter.InsertCommand.CommandType = CommandType.StoredProcedure

        ' Add the parameter for the CategoryName. Specifying the
        ' ParameterDirection for an input parameter is not required.
        adapter.InsertCommand.Parameters.Add( _
          "@CategoryName", SqlDbType.NVarChar, 15, "CategoryName")

        ' Add the SqlParameter to retrieve the new identity value.
        ' Specify the ParameterDirection as Output.
        Dim parameter As SqlParameter = _
           adapter.InsertCommand.Parameters.Add( _
          "@Identity", SqlDbType.Int, 0, "CategoryID")
        parameter.Direction = ParameterDirection.Output

        ' Create a DataTable and fill it.
        Dim categories As DataTable = New DataTable
        adapter.Fill(categories)

        ' Add a new row.
        Dim newRow As DataRow = categories.NewRow()
        newRow("CategoryName") = "New Category"
        categories.Rows.Add(newRow)

        ' Update the database.
        adapter.Update(categories)

        Console.WriteLine("List All Rows:")
        Dim row As DataRow
        For Each row In categories.Rows
            Console.WriteLine("{0}: {1}", row(0), row(1))
        Next
    End Using
End Sub
private static void RetrieveIdentity(string connectionString)
{
    using (SqlConnection connection =
               new SqlConnection(connectionString))
    {
        // Create a SqlDataAdapter based on a SELECT query.
        SqlDataAdapter adapter =
            new SqlDataAdapter(
            "SELECT CategoryID, CategoryName FROM dbo.Categories",
            connection);

        //Create the SqlCommand to execute the stored procedure.
        adapter.InsertCommand = new SqlCommand("dbo.InsertCategory", 
            connection);
        adapter.InsertCommand.CommandType = CommandType.StoredProcedure;

        // Add the parameter for the CategoryName. Specifying the
        // ParameterDirection for an input parameter is not required.
        adapter.InsertCommand.Parameters.Add(
           new SqlParameter("@CategoryName", SqlDbType.NVarChar, 15,
           "CategoryName"));

        // Add the SqlParameter to retrieve the new identity value.
        // Specify the ParameterDirection as Output.
        SqlParameter parameter = 
            adapter.InsertCommand.Parameters.Add(
            "@Identity", SqlDbType.Int, 0, "CategoryID");
        parameter.Direction = ParameterDirection.Output;

        // Create a DataTable and fill it.
        DataTable categories = new DataTable();
        adapter.Fill(categories);

        // Add a new row. 
        DataRow newRow = categories.NewRow();
        newRow["CategoryName"] = "New Category";
        categories.Rows.Add(newRow);

        adapter.Update(categories);

        Console.WriteLine("List All Rows:");
        foreach (DataRow row in categories.Rows)
        {
            {
                Console.WriteLine("{0}: {1}", row[0], row[1]);
            }
        }
    }
}

Fusion des nouvelles valeurs d'identité

Un scénario courant consiste à appeler la méthode GetChanges d'un objet DataTable pour créer une copie qui contient uniquement les lignes modifiées et pour utiliser une nouvelle copie lors de l'appel de la méthode Update d'un objet DataAdapter. Ceci s'avère très utile lorsque vous avez besoin de marshaler les lignes modifiées dans un autre composant qui effectue la mise à jour. Après la mise à jour, la copie peut contenir les nouvelles valeurs d'identité qui doivent ensuite être de nouveau fusionnées dans l'objet DataTable d'origine. Il est probable que les nouvelles valeurs d'identité soient différentes des valeurs d'origine de l'objet DataTable. Pour effectuer cette fusion, les valeurs d'origine des colonnes AutoIncrement de la copie doivent être conservées de manière à pouvoir rechercher et mettre à jour des lignes existantes dans l'objet DataTable d'origine, plutôt que d'ajouter de nouvelles lignes contenant les nouvelles valeurs d'identité. Pourtant, par défaut ces valeurs d'origine sont perdues après un appel de la méthode Update d'un objet DataAdapter, car la méthode AcceptChanges est appelée implicitement pour chaque objet DataRow mis à jour.

Il existe deux façons de conserver les valeurs d'origine d'un objet DataColumn dans un objet DataRow pendant la mise à jour d'un objet DataAdapter :

  • La première méthode de conservation des valeurs d'origine consiste à affecter la valeur false à la propriété AcceptChangesDuringUpdate de l'objet DataAdapter. Cela affecte tous les objets DataRow de l'objet DataTable en cours de mise à jour. Pour plus d'informations et pour obtenir un exemple de code, voir AcceptChangesDuringUpdate.

  • La seconde méthode consiste à écrire du code dans le gestionnaire d'événements RowUpdated de l'objet DataAdapter de manière à affecter la valeur SkipCurrentRow à la propriété Status. L'objet DataRow est mis à jour mais la valeur d'origine de chaque objet DataColumn est conservée. Cette méthode permet de conserver la valeur d'origine de certaines lignes et pas d'autres. Votre code peut par exemple conserver les valeurs d'origine des lignes ajoutées, mais pas des lignes modifiées ou supprimées en vérifiant tout d'abord la propriété StatementType, puis en affectant la valeur SkipCurrentRow à la propriété Status uniquement pour les lignes dont StatementType a la valeur Insert.

Si l'une de ces méthodes est utilisée pour conserver les valeurs d'origine dans un objet DataRow au cours de la mise à jour d'un objet DataAdapter, ADO.NET effectue une série d'actions afin d'affecter à l'objet DataRow les nouvelles valeurs retournées par des paramètres de sortie ou par la première ligne retournée d'un jeu de résultats, tout en continuant de conserver la valeur d'origine dans chaque objet DataColumn. Dans un premier temps, la méthode AcceptChanges de l'objet DataRow est appelée pour conserver les valeurs actuelles comme valeurs d'origine, puis les nouvelles valeurs sont assignées. Suite à cela, les objets DataRows dont la propriété RowState avait la valeur Added verront leur propriété RowState remplacée par Modified, ce qui peut être inattendu.

La manière dont les résultats de la commande sont appliqués à chaque objet DataRow en cours de mise à jour est déterminé par la propriété UpdatedRowSource de chaque DbCommand. Une valeur de l'énumération UpdateRowSource est affectée à cette propriété.

Le tableau suivant décrit comment les valeurs de l'énumération UpdateRowSource affectent la propriété RowState des lignes mises à jour.

Nom de membre

Description

Both

La méthode AcceptChanges est appelée et les valeurs des deux paramètres de sortie et/ou les valeurs de la première ligne de tout jeu de résultats retourné sont placées dans l'objet DataRow en cours de mise à jour. S'il n'y a aucune valeur à appliquer, l'objet RowState aura la valeur Unchanged.

FirstReturnedRecord

Si une ligne a été retournée, la méthode AcceptChanges est appelée et la ligne est mappée à la ligne modifiée dans l'objet DataTable, ce qui affecte la valeur Modified à RowState. Si aucune ligne n'est retournée, la méthode AcceptChanges n'est pas appelée et l'objet RowState conserve la valeur Added.

None

Tous les paramètres et toutes les lignes retournés sont ignorés. La méthode AcceptChanges n'est pas appelée et RowState conserve la valeur Added.

OutputParameters

La méthode AcceptChanges est appelée et tout paramètre de sortie est mappé à la ligne modifiée dans l'objet DataTable, ce qui affecte la valeur Modified à l'objet RowState. S'il n'existe aucun paramètres de sortie, l'objet RowState aura la valeur Unchanged.

Exemple

Cet exemple illustre l'extraction des lignes modifiées d'un objet DataTable et l'utilisation d'un objet SqlDataAdapter pour mettre à jour la source de données et récupérer une nouvelle valeur de colonne d'identité. La propriété InsertCommand exécute deux instructions Transact-SQL (INSERT et SELECT) qui utilisent la fonction SCOPE_IDENTITY pour récupérer la valeur d'identité.

INSERT INTO dbo.Shippers (CompanyName) 
VALUES (@CompanyName);
SELECT ShipperID, CompanyName FROM dbo.Shippers 
WHERE ShipperID = SCOPE_IDENTITY();

La propriété UpdatedRowSource de la commande d'insertion a la valeur UpdateRowSource.FirstReturnedRow et la propriété MissingSchemaAction de l'objet DataAdapter a la valeur MissingSchemaAction.AddWithKey. L'objet DataTable est rempli et le code ajoute une nouvelle ligne à l'objet DataTable. Les lignes modifiées sont ensuite extraites dans un nouvel objet DataTable, qui est passé à l'objet DataAdapter, qui met ensuite à jour le serveur.

Private Sub MergeIdentityColumns(ByVal connectionString As String)

    Using connection As SqlConnection = New SqlConnection( _
       connectionString)

        ' Create the DataAdapter
        Dim adapter As SqlDataAdapter = New SqlDataAdapter( _
          "SELECT ShipperID, CompanyName FROM dbo.Shippers", connection)

        ' Add the InsertCommand to retrieve new identity value.
        adapter.InsertCommand = New SqlCommand( _
            "INSERT INTO dbo.Shippers (CompanyName) " & _
            "VALUES (@CompanyName); " & _
            "SELECT ShipperID, CompanyName FROM dbo.Shippers " & _
            "WHERE ShipperID = SCOPE_IDENTITY();", _
            connection)

        ' Add the parameter for the inserted value.
        adapter.InsertCommand.Parameters.Add( _
           New SqlParameter("@CompanyName", SqlDbType.NVarChar, 40, _
           "CompanyName"))
        adapter.InsertCommand.UpdatedRowSource = UpdateRowSource.Both

        ' MissingSchemaAction adds any missing schema to 
        ' the DataTable, including identity columns
        adapter.MissingSchemaAction = MissingSchemaAction.AddWithKey

        ' Fill the DataTable.
        Dim shipper As New DataTable
        adapter.Fill(shipper)

        ' Add a new shipper. 
        Dim newRow As DataRow = shipper.NewRow()
        newRow("CompanyName") = "New Shipper"
        shipper.Rows.Add(newRow)

        ' Add changed rows to a new DataTable. This
        ' DataTable will be used by the DataAdapter.
        Dim dataChanges As DataTable = shipper.GetChanges()

        ' Add the event handler. 
        AddHandler adapter.RowUpdated, New _
           SqlRowUpdatedEventHandler(AddressOf OnRowUpdated)

        ' Update the datasource with the modified records.
        adapter.Update(dataChanges)

        ' Merge the two DataTables.
        shipper.Merge(dataChanges)

        ' Commit the changes.
        shipper.AcceptChanges()

        Console.WriteLine("Rows after merge.")
        Dim row As DataRow
        For Each row In shipper.Rows
            Console.WriteLine("{0}: {1}", row(0), row(1))
        Next
    End Using
End Sub
private static void MergeIdentityColumns(string connectionString)
{
    using (SqlConnection connection =
               new SqlConnection(connectionString))
    {
        // Create the DataAdapter
        SqlDataAdapter adapter =
            new SqlDataAdapter(
            "SELECT ShipperID, CompanyName FROM dbo.Shippers",
            connection);

        //Add the InsertCommand to retrieve new identity value.
        adapter.InsertCommand = new SqlCommand(
            "INSERT INTO dbo.Shippers (CompanyName) " +
            "VALUES (@CompanyName); " +
            "SELECT ShipperID, CompanyName FROM dbo.Shippers " +
            "WHERE ShipperID = SCOPE_IDENTITY();", connection);

        // Add the parameter for the inserted value.
        adapter.InsertCommand.Parameters.Add(
           new SqlParameter("@CompanyName", SqlDbType.NVarChar, 40,
           "CompanyName"));
        adapter.InsertCommand.UpdatedRowSource = UpdateRowSource.Both;

        // MissingSchemaAction adds any missing schema to 
        // the DataTable, including identity columns
        adapter.MissingSchemaAction = MissingSchemaAction.AddWithKey;

        // Fill the DataTable.
        DataTable shipper = new DataTable();
        adapter.Fill(shipper);

        // Add a new shipper. 
        DataRow newRow = shipper.NewRow();
        newRow["CompanyName"] = "New Shipper";
        shipper.Rows.Add(newRow);

        // Add changed rows to a new DataTable. This
        // DataTable will be used by the DataAdapter.
        DataTable dataChanges = shipper.GetChanges();

        // Add the event handler. 
        adapter.RowUpdated +=
            new SqlRowUpdatedEventHandler(OnRowUpdated);

        adapter.Update(dataChanges);
        connection.Close();

        // Merge the updates.
        shipper.Merge(dataChanges);

        // Commit the changes.
        shipper.AcceptChanges();

        Console.WriteLine("Rows after merge.");
        foreach (DataRow row in shipper.Rows)
        {
            {
                Console.WriteLine("{0}: {1}", row[0], row[1]);
            }
        }
    }
}

Le gestionnaire d'événements OnRowUpdated vérifie la propriété StatementType de l'objet SqlRowUpdatedEventArgs de manière à déterminer si la ligne est une insertion. S'il s'agit d'une insertion, la propriété Status a la valeur SkipCurrentRow. La ligne est mise à jour, mais ses valeurs d'origine sont conservées. Dans le corps principal de la procédure, la méthode Merge est appelée pour fusionner la nouvelle valeur d'identité dans l'objet DataTable d'origine et pour finir la méthode AcceptChanges est appelée.

Private Sub OnRowUpdated( _
    ByVal sender As Object, ByVal e As SqlRowUpdatedEventArgs)
    ' If this is an insert, then skip this row.
    If e.StatementType = StatementType.Insert Then
        e.Status = UpdateStatus.SkipCurrentRow
    End If
End Sub
protected static void OnRowUpdated(
    object sender, SqlRowUpdatedEventArgs e)
{
    // If this is an insert, then skip this row.
    if (e.StatementType == StatementType.Insert)
    {
        e.Status = UpdateStatus.SkipCurrentRow;
    }
}

Extraction des valeurs de champs NuméroAuto de Microsoft Access

Cette section comprend un exemple qui montre comment récupérer des valeurs Autonumber dans une base de données Jet 4.0. Le moteur de base de données Jet ne prend pas en charge l'exécution de plusieurs instructions dans un lot ni l'utilisation de paramètres de sortie. Il n'est donc pas possible d'utiliser l'une ou l'autre de ces techniques pour retourner la nouvelle valeur Autonumber assignée à la ligne insérée. Cependant, vous pouvez ajouter du code au gestionnaire d'événements RowUpdated qui exécute une instruction SELECT @@IDENTITY pour récupérer la nouvelle valeur Autonumber.

Exemple

Plutôt que d'ajouter des informations de schéma à l'aide de MissingSchemaAction.AddWithKey, cet exemple configure un objet DataTable avec le schéma correct avant d'appeler l'objet OleDbDataAdapter pour remplir l'objet DataTable. Dans ce cas, la colonne CategoryID est configurée pour décrémenter la valeur assignée à chaque ligne insérée à partir de zéro en affectant la valeur true à AutoIncrement, la valeur 0 à AutoIncrementSeed et la valeur -1 à AutoIncrementStep. Le code ajoute ensuite deux nouvelles lignes et utilise GetChanges pour ajouter les lignes modifiées à un nouvel objet DataTable qui est passé à la méthode Update.

Shared connection As OleDbConnection = Nothing

Private Shared Sub MergeIdentityColumns(ByVal connection As OleDbConnection)
    Using connection

        ' Create a DataAdapter based on a SELECT query.
        Dim adapter As OleDbDataAdapter = New OleDbDataAdapter( _
          "SELECT CategoryID, CategoryName FROM Categories", _
          connection)

        ' Create the INSERT command for the new category.
        adapter.InsertCommand = New OleDbCommand( _
          "INSERT INTO Categories (CategoryName) Values(?)", connection)
        adapter.InsertCommand.CommandType = CommandType.Text

        ' Add the parameter for the CategoryName.
        adapter.InsertCommand.Parameters.Add( _
          "@CategoryName", OleDbType.VarWChar, 15, "CategoryName")
        adapter.InsertCommand.UpdatedRowSource = UpdateRowSource.Both

        ' Create a DataTable.
        Dim categories As DataTable = New DataTable

        ' Create the CategoryID column and set its auto
        ' incrementing properties to decrement from zero.
        Dim column As New DataColumn()
        column.DataType = System.Type.GetType("System.Int32")
        column.ColumnName = "CategoryID"
        column.AutoIncrement = True
        column.AutoIncrementSeed = 0
        column.AutoIncrementStep = -1
        categories.Columns.Add(column)

        ' Create the CategoryName column.
        column = New DataColumn()
        column.DataType = System.Type.GetType("System.String")
        column.ColumnName = "CategoryName"
        categories.Columns.Add(column)

        ' Set the primary key on CategoryID.
        Dim pKey(1) As DataColumn
        pKey(0) = categories.Columns("CategoryID")
        categories.PrimaryKey = pKey

        ' Fetch the data and fill the DataTable.
        adapter.Fill(categories)

        ' Add a new row.
        Dim newRow As DataRow = categories.NewRow()
        newRow("CategoryName") = "New Category"
        categories.Rows.Add(newRow)

        ' Add another new row.
        Dim newRow2 As DataRow = categories.NewRow()
        newRow2("CategoryName") = "Another New Category"
        categories.Rows.Add(newRow2)

        ' Add changed rows to a new DataTable that will be
        ' used to post the inserts to the database.
        Dim dataChanges As DataTable = categories.GetChanges()

        ' Include an event to fill in the Autonumber value.
        AddHandler adapter.RowUpdated, _
          New OleDbRowUpdatedEventHandler(AddressOf OnRowUpdated)

        ' Update the database, inserting the new rows.
        adapter.Update(dataChanges)

        Console.WriteLine("Rows before merge:")
        Dim row1 As DataRow
        For Each row1 In categories.Rows
            Console.WriteLine("  {0}: {1}", row1(0), row1(1))
        Next

        ' Merge the two DataTables.
        categories.Merge(dataChanges)

        ' Commit the changes.
        categories.AcceptChanges()

        Console.WriteLine("Rows after merge:")
        Dim row As DataRow
        For Each row In categories.Rows
            Console.WriteLine("  {0}: {1}", row(0), row(1))
        Next
    End Using
End Sub
private static OleDbConnection connection = null;

private static void MergeIdentityColumns(OleDbConnection connection)
{
    using (connection)
    {
        // Create a DataAdapter based on a SELECT query.
        OleDbDataAdapter adapter = new OleDbDataAdapter(
         "SELECT CategoryID, CategoryName FROM Categories",
         connection);

        // Create the INSERT command for the new category.
        adapter.InsertCommand = new OleDbCommand(
          "INSERT INTO Categories (CategoryName) Values(?)", connection);
        adapter.InsertCommand.CommandType = CommandType.Text;

        // Add the parameter for the CategoryName.
        adapter.InsertCommand.Parameters.Add(
          "@CategoryName", OleDbType.VarWChar, 15, "CategoryName");
        adapter.InsertCommand.UpdatedRowSource = UpdateRowSource.Both;

        // Create a DataTable
        DataTable categories = new DataTable();

        // Create the CategoryID column and set its auto 
        // incrementing properties to decrement from zero. 
        DataColumn column = new DataColumn();
        column.DataType = System.Type.GetType("System.Int32");
        column.ColumnName = "CategoryID";
        column.AutoIncrement = true;
        column.AutoIncrementSeed = 0;
        column.AutoIncrementStep = -1;
        categories.Columns.Add(column);

        // Create the CategoryName column.
        column = new DataColumn();
        column.DataType = System.Type.GetType("System.String");
        column.ColumnName = "CategoryName";
        categories.Columns.Add(column);

        // Set the primary key on CategoryID.
        DataColumn[] pKey = new DataColumn[1];
        pKey[0] = categories.Columns["CategoryID"];
        categories.PrimaryKey = pKey;

        // Fetch the data and fill the DataTable
        adapter.Fill(categories);

        // Add a new row.
        DataRow newRow = categories.NewRow();
        newRow["CategoryName"] = "New Category";
        categories.Rows.Add(newRow);

        // Add another new row.
        DataRow newRow2 = categories.NewRow();
        newRow2["CategoryName"] = "Another New Category";
        categories.Rows.Add(newRow2);

        // Add changed rows to a new DataTable that will be
        // used to post the inserts to the database.
        DataTable dataChanges = categories.GetChanges();

        // Include an event to fill in the Autonumber value.
        adapter.RowUpdated +=
            new OleDbRowUpdatedEventHandler(OnRowUpdated);

        // Update the database, inserting the new rows. 
        adapter.Update(dataChanges);

        Console.WriteLine("Rows before merge:");
        foreach (DataRow row in categories.Rows)
        {
            {
                Console.WriteLine("  {0}: {1}", row[0], row[1]);
            }
        }

        // Merge the two DataTables.
        categories.Merge(dataChanges);

        // Commit the changes.
        categories.AcceptChanges();

        Console.WriteLine("Rows after merge:");
        foreach (DataRow row in categories.Rows)
        {
            {
                Console.WriteLine("  {0}: {1}", row[0], row[1]);
            }
        }
    }
}

Le gestionnaire d'événements RowUpdated utilise le même objet OleDbConnection ouvert que l'instruction Update de l'objet OleDbDataAdapter. Il vérifie le StatementType de l'objet OleDbRowUpdatedEventArgs pour les lignes insérées. Pour chaque ligne insérée, un nouvel objet OleDbCommand est créé pour exécuter l'instruction SELECT @@IDENTITY sur la connexion, ce qui retourne la nouvelle valeur Autonumber qui est placée dans la colonne CategoryID de l'objet DataRow. La valeur UpdateStatus.SkipCurrentRow est ensuite affectée à la propriété Status pour supprimer l'appel masqué à la méthode AcceptChanges. Dans le corps principal de la procédure, la méthode Merge est appelée pour fusionner les deux objets DataTable et pour finir la méthode AcceptChanges est appelée.

Private Shared Sub OnRowUpdated( _
    ByVal sender As Object, ByVal e As OleDbRowUpdatedEventArgs)
    ' Conditionally execute this code block on inserts only.
    If e.StatementType = StatementType.Insert Then
        ' Retrieve the Autonumber and store it in the CategoryID column.
        Dim cmdNewID As New OleDbCommand("SELECT @@IDENTITY", _
           connection)
        e.Row("CategoryID") = CInt(cmdNewID.ExecuteScalar)
        e.Status = UpdateStatus.SkipCurrentRow
    End If
End Sub
private static void OnRowUpdated(
  object sender, OleDbRowUpdatedEventArgs e)
{
    // Conditionally execute this code block on inserts only.
    if (e.StatementType == StatementType.Insert)
    {
        OleDbCommand cmdNewID = new OleDbCommand("SELECT @@IDENTITY",
            connection);
        // Retrieve the Autonumber and store it in the CategoryID column.
        e.Row["CategoryID"] = (int)cmdNewID.ExecuteScalar();
        e.Status = UpdateStatus.SkipCurrentRow;
    }
}

Voir aussi

Concepts

États et versions de ligne

AcceptChanges et RejectChanges

Fusion du contenu d'un DataSet (ADO.NET)

Mise à jour de sources de données à l'aide de DataAdapters (ADO.NET)

Autres ressources

Extraction et modification de données dans ADO.NET

DataAdapters et DataReaders (ADO.NET)