DataTable.LoadDataRow DataTable.LoadDataRow DataTable.LoadDataRow DataTable.LoadDataRow Method

Définition

Recherche et met à jour une ligne spécifique.Finds and updates a specific row. Si aucune ligne correspondante n'est détectée, une nouvelle ligne est créée à l'aide des valeurs données.If no matching row is found, a new row is created using the given values.

Surcharges

LoadDataRow(Object[], Boolean) LoadDataRow(Object[], Boolean) LoadDataRow(Object[], Boolean) LoadDataRow(Object[], Boolean)

Recherche et met à jour une ligne spécifique.Finds and updates a specific row. Si aucune ligne correspondante n'est détectée, une nouvelle ligne est créée à l'aide des valeurs données.If no matching row is found, a new row is created using the given values.

LoadDataRow(Object[], LoadOption) LoadDataRow(Object[], LoadOption) LoadDataRow(Object[], LoadOption)

Recherche et met à jour une ligne spécifique.Finds and updates a specific row. Si aucune ligne correspondante n'est détectée, une nouvelle ligne est créée à l'aide des valeurs données.If no matching row is found, a new row is created using the given values.

LoadDataRow(Object[], Boolean) LoadDataRow(Object[], Boolean) LoadDataRow(Object[], Boolean) LoadDataRow(Object[], Boolean)

Recherche et met à jour une ligne spécifique.Finds and updates a specific row. Si aucune ligne correspondante n'est détectée, une nouvelle ligne est créée à l'aide des valeurs données.If no matching row is found, a new row is created using the given values.

public:
 System::Data::DataRow ^ LoadDataRow(cli::array <System::Object ^> ^ values, bool fAcceptChanges);
public System.Data.DataRow LoadDataRow (object[] values, bool fAcceptChanges);
member this.LoadDataRow : obj[] * bool -> System.Data.DataRow
Public Function LoadDataRow (values As Object(), fAcceptChanges As Boolean) As DataRow

Paramètres

values
Object[]

Tableau des valeurs utilisées pour créer la nouvelle ligne.An array of values used to create the new row.

fAcceptChanges
Boolean Boolean Boolean Boolean

true pour accepter les modifications ; sinon, false.true to accept changes; otherwise false.

Retours

Exceptions

Le tableau contient un nombre de colonnes supérieur à celui de la table.The array is larger than the number of columns in the table.

Une valeur ne correspond pas à son type de colonne respectif.A value doesn't match its respective column type.

L'ajout de la ligne rend une contrainte non valide.Adding the row invalidates a constraint.

Tentative d'insertion d'une valeur null dans une colonne dont AllowDBNull a la valeur false.Attempting to put a null in a column where AllowDBNull is false.

Exemples

L’exemple suivant utilise la LoadDataRow méthode pour tenter de trouver une ligne.The following example uses the LoadDataRow method to attempt to find a row. Si aucune ligne de ce type n’est trouvée, les valeurs sont utilisées pour créer une nouvelle ligne.If no such row is found, the values are used to create a new row.

using System;
using System.Data;

class MyDataSet {
   public static void Main() {
      DataTable dt = new DataTable();

      DataColumn dc1 = new DataColumn("col1");
      DataColumn dc2 = new DataColumn("col2");
      DataColumn dc3 = new DataColumn("col3");

      dt.Columns.Add(dc1);
      dt.Columns.Add(dc2);
      dt.Columns.Add(dc3);

      // Create an array for the values.
      object[] newRow = new object[3];

      // Set the values of the array.
      newRow[0] = "Hello";
      newRow[1] = "World";
      newRow[2] = "two";
      DataRow row;

      dt.BeginLoadData();

      // Add the new row to the rows collection.
      row = dt.LoadDataRow(newRow, true);

      foreach (DataRow dr in dt.Rows) {
         Console.WriteLine(String.Format("Row: {0}, {1}, {2}", dr["col1"], dr["col2"], dr["col3"]));
      }

      dt.EndLoadData();
   }
}
Imports System.Data

Class MyDataSet
   Public Shared Sub Main()
      Dim dt As New DataTable()

      Dim dc1 As New DataColumn("col1")
      Dim dc2 As New DataColumn("col2")
      Dim dc3 As New DataColumn("col3")

      dt.Columns.Add(dc1)
      dt.Columns.Add(dc2)
      dt.Columns.Add(dc3)

      ' Create an array for the values.
      Dim newRow As Object() = New Object(2) {}

      ' Set the values of the array.
      newRow(0) = "Hello"
      newRow(1) = "World"
      newRow(2) = "two"
      Dim row As DataRow

      dt.BeginLoadData()

      ' Add the new row to the rows collection.
      row = dt.LoadDataRow(newRow, True)

      For Each dr As DataRow In dt.Rows
         Console.WriteLine([String].Format("Row: {0}, {1}, {2}", dr("col1"), dr("col2"), dr("col3")))
      Next

      dt.EndLoadData()
   End Sub
End Class

Remarques

La LoadDataRow méthode prend un tableau de valeurs et recherche la ou les valeurs correspondantes dans la ou les colonnes de clé primaire.The LoadDataRow method takes an array of values and finds the matching value(s) in the primary key column(s).

Si une colonne a une valeur par défaut, transmettez une valeur null dans le tableau pour définir la valeur par défaut de cette colonne.If a column has a default value, pass a null value in the array to set the default value for that column. De même, si la AutoIncrement propriété d’une colonne a la valeur true, transmettez une valeur null dans le tableau pour définir la valeur générée automatiquement pour la ligne.Similarly, if a column has its AutoIncrement property set to true, pass a null value in the array to set the automatically generated value for the row.

Si le fAcceptChanges paramètre est true ou n’est pas spécifié, les nouvelles données sont ajoutées AcceptChanges , puis DataTableest appelé pour accepter toutes les modifications dans ; si l' falseargument a la valeur, les lignes récemment ajoutées sont marquées comme insertions et les modifications apportées à les lignes existantes sont marquées comme des modifications.If the fAcceptChanges parameter is true or not specified, the new data is added and then AcceptChanges is called to accept all changes in the DataTable; if the argument is false, newly added rows are marked as insertions, and changes to existing rows are marked as modifications.

Des exceptions peuvent également se produire pendant ColumnChanging un RowChanging événement ou.Exceptions can also occur during either a ColumnChanging or RowChanging event. Si une exception se produit, la ligne n’est pas ajoutée à la table.If an exception occurs, the row is not added to the table.

Utilisez LoadDataRow conjointement avec BeginLoadData et. EndLoadDataUse LoadDataRow in conjunction with BeginLoadData and EndLoadData.

Voir aussi

LoadDataRow(Object[], LoadOption) LoadDataRow(Object[], LoadOption) LoadDataRow(Object[], LoadOption)

Recherche et met à jour une ligne spécifique.Finds and updates a specific row. Si aucune ligne correspondante n'est détectée, une nouvelle ligne est créée à l'aide des valeurs données.If no matching row is found, a new row is created using the given values.

public:
 System::Data::DataRow ^ LoadDataRow(cli::array <System::Object ^> ^ values, System::Data::LoadOption loadOption);
public System.Data.DataRow LoadDataRow (object[] values, System.Data.LoadOption loadOption);
member this.LoadDataRow : obj[] * System.Data.LoadOption -> System.Data.DataRow

Paramètres

values
Object[]

Tableau des valeurs utilisées pour créer la nouvelle ligne.An array of values used to create the new row.

loadOption
LoadOption LoadOption LoadOption LoadOption

Utilisé pour déterminer comment les valeurs de tableau sont appliquées aux valeurs correspondantes dans une ligne existante.Used to determine how the array values are applied to the corresponding values in an existing row.

Retours

Remarques

La LoadDataRow méthode prend un tableau de valeurs et recherche la ou les valeurs correspondantes dans la ou les colonnes de clé primaire.The LoadDataRow method takes an array of values and finds the matching value(s) in the primary key column(s).

Si une colonne a une valeur par défaut, transmettez une valeur null dans le tableau pour définir la valeur par défaut de cette colonne.If a column has a default value, pass a null value in the array to set the default value for that column. De même, si la AutoIncrement propriété d’une colonne a la valeur true, transmettez une valeur null dans le tableau pour définir la valeur générée automatiquement pour la ligne.Similarly, if a column has its AutoIncrement property set to true, pass a null value in the array to set the automatically generated value for the row.

La valeur du loadOption paramètre est utilisée pour déterminer la façon dont les valeurs du tableau sont appliquées à une ligne existante.The value of the loadOption parameter is used to determine how the values in the array are applied to an existing row. Par exemple, si loadOption a la OverwriteChangesvaleur, les Original valeurs Current et de chaque colonne sont remplacées par les Unchangedvaleurs de la ligne entrante RowState et la propriété a la valeur.For example, if loadOption is set to OverwriteChanges, the Original and Current values of each column are replaced with the values in the incoming row and the RowState property is set to Unchanged.

Des exceptions peuvent également se produire pendant ColumnChanging un RowChanging événement ou.Exceptions can also occur during either a ColumnChanging or RowChanging event. Si une exception se produit, la ligne n’est pas ajoutée à la table.If an exception occurs, the row is not added to the table.

Utilisez LoadDataRow conjointement avec BeginLoadData et. EndLoadDataUse LoadDataRow in conjunction with BeginLoadData and EndLoadData.

Voir aussi

S’applique à