DataTable.LoadDataRow Methode

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

Parameters

Retouren

Het nieuwe DataRow.

Uitzonderingen

Voorbeelden

In het volgende voorbeeld wordt de LoadDataRow methode gebruikt om een rij te zoeken. Als er geen dergelijke rij wordt gevonden, worden de waarden gebruikt om een nieuwe rij te maken.

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

Opmerkingen

De LoadDataRow methode gebruikt een matrix met waarden en zoekt de overeenkomende waarden in de kolom(en) van de primaire sleutel.

Als een kolom een standaardwaarde heeft, geeft u een null-waarde in de matrix door om de standaardwaarde voor die kolom in te stellen. Als voor een kolom de eigenschap waar is AutoIncrement ingesteld, geeft u een null-waarde in de matrix door om de automatisch gegenereerde waarde voor de rij in te stellen.

Als de fAcceptChanges parameter al dan niet is true opgegeven, worden de nieuwe gegevens toegevoegd en vervolgens AcceptChanges aangeroepen om alle wijzigingen in de DataTableparameter te accepteren. Als het argument is false, worden nieuwe toegevoegde rijen gemarkeerd als invoegingen en worden wijzigingen in bestaande rijen gemarkeerd als wijzigingen.

Uitzonderingen kunnen ook optreden tijdens een ColumnChanging of RowChanging meer gebeurtenissen. Als er een uitzondering optreedt, wordt de rij niet toegevoegd aan de tabel.

Gebruik LoadDataRow in combinatie met BeginLoadData en EndLoadData.

Zie ook

• DataTables
• Gegevenstabel-gebeurtenissen verwerken

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

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

Parameters

Retouren

Het nieuwe DataRow.

Opmerkingen

De LoadDataRow methode gebruikt een matrix met waarden en zoekt de overeenkomende waarden in de kolom(en) van de primaire sleutel.

Als een kolom een standaardwaarde heeft, geeft u een null-waarde in de matrix door om de standaardwaarde voor die kolom in te stellen. Als voor een kolom de eigenschap waar is AutoIncrement ingesteld, geeft u een null-waarde in de matrix door om de automatisch gegenereerde waarde voor de rij in te stellen.

De waarde van de loadOption parameter wordt gebruikt om te bepalen hoe de waarden in de matrix worden toegepast op een bestaande rij. Als dit bijvoorbeeld loadOption is ingesteld OverwriteChangesop, worden de Original en Current waarden van elke kolom vervangen door de waarden in de binnenkomende rij en wordt de RowState eigenschap ingesteld op Unchanged.

Uitzonderingen kunnen ook optreden tijdens een ColumnChanging of RowChanging meer gebeurtenissen. Als er een uitzondering optreedt, wordt de rij niet toegevoegd aan de tabel.

Gebruik LoadDataRow in combinatie met BeginLoadData en EndLoadData.

Zie ook

• DataTables