DataTable.LoadDataRow Méthode

Source:

DataTable.cs

Source:

DataTable.cs

Source:

DataTable.cs

public:
 System::Data::DataRow ^ LoadDataRow(cli::array <System::Object ^> ^ values, bool fAcceptChanges);

public System.Data.DataRow LoadDataRow (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

Retours

Nouvelle DataRow.

Exceptions

Exemples

L’exemple suivant utilise la LoadDataRow méthode pour tenter de trouver une ligne. Si aucune ligne de ce type n’est trouvée, les valeurs sont utilisées pour créer une ligne.

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.

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. De même, si la propriété d’une colonne a AutoIncrement la valeur true, transmettez une valeur null dans le tableau pour définir la valeur générée automatiquement pour la ligne.

Si le fAcceptChanges paramètre est true spécifié ou non, les nouvelles données sont ajoutées, puis AcceptChanges sont appelées pour accepter toutes les modifications apportées à ; DataTablesi l’argument est false, les lignes nouvellement ajoutées sont marquées comme insertions, et les modifications apportées aux lignes existantes sont marquées comme modifications.

Des exceptions peuvent également se produire pendant un ColumnChanging événement ou .RowChanging Si une exception se produit, la ligne n’est pas ajoutée à la table.

Utilisez LoadDataRow conjointement avec BeginLoadData et EndLoadData.

Voir aussi

• DataTables
• Gestion des événements de DataTable

Source:

DataTable.cs

Source:

DataTable.cs

Source:

DataTable.cs

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

public System.Data.DataRow LoadDataRow (object[] values, System.Data.LoadOption loadOption);

member this.LoadDataRow : obj[] * System.Data.LoadOption -> System.Data.DataRow

Public Function LoadDataRow (values As Object(), loadOption As LoadOption) As DataRow

Paramètres

Retours

Nouvelle DataRow.

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.

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. De même, si la propriété d’une colonne a AutoIncrement la valeur true, transmettez une valeur null dans le tableau pour définir la valeur générée automatiquement pour la ligne.

La valeur du loadOption paramètre est utilisée pour déterminer comment les valeurs du tableau sont appliquées à une ligne existante. Par exemple, si loadOption est défini sur OverwriteChanges, les Original valeurs et Current de chaque colonne sont remplacées par les valeurs de la ligne entrante et la propriété a la RowStateUnchangedvaleur .

Des exceptions peuvent également se produire pendant un ColumnChanging événement ou .RowChanging Si une exception se produit, la ligne n’est pas ajoutée à la table.

Utilisez LoadDataRow conjointement avec BeginLoadData et EndLoadData.

Voir aussi

• DataTables