DataTable.LoadDataRow Metódus

Definíció

Névtér:

System.Data

Szerelvények:

netstandard.dll, System.Data.Common.dll

Megkeres és frissít egy adott sort. Ha nem található egyező sor, a rendszer új sort hoz létre a megadott értékekkel.

Túlterhelések

Name	Description
LoadDataRow(Object[], Boolean)	Megkeres és frissít egy adott sort. Ha nem található egyező sor, a rendszer új sort hoz létre a megadott értékekkel.
LoadDataRow(Object[], LoadOption)	Megkeres és frissít egy adott sort. Ha nem található egyező sor, a rendszer új sort hoz létre a megadott értékekkel.

LoadDataRow(Object[], Boolean)

Forrás:

DataTable.cs

Megkeres és frissít egy adott sort. Ha nem található egyező sor, a rendszer új sort hoz létre a megadott értékekkel.

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éterek

values

Object[]

Az új sor létrehozásához használt értékek tömbje.

fAcceptChanges

Boolean

true módosítások elfogadása; egyéb esetben false.

Válaszok

DataRow

Az új DataRow.

Kivételek

ArgumentException

A tömb nagyobb, mint a tábla oszlopainak száma.

InvalidCastException

Egy érték nem egyezik meg a megfelelő oszloptípussal.

ConstraintException

A sor hozzáadása érvénytelenít egy kényszert.

NoNullAllowedException

Null értéket próbál elhelyezni egy olyan oszlopban, ahol AllowDBNull hamis.

Példák

Az alábbi példa a LoadDataRow metódussal próbál meg egy sort keresni. Ha nem található ilyen sor, a rendszer az értékeket egy új sor létrehozásához használja.

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

Megjegyzések

A LoadDataRow metódus egy értéktömböt használ, és megkeresi az egyező érték(ek)et az elsődleges kulcsoszlop(ok)ban.

Ha egy oszlop alapértelmezett értékkel rendelkezik, adjon meg egy null értéket a tömbben az oszlop alapértelmezett értékének beállításához. Hasonlóképpen, ha egy oszlop tulajdonsága AutoIncrement igaz értékre van állítva, adjon át egy null értéket a tömbben a sor automatikusan generált értékének beállításához.

Ha a fAcceptChanges paraméter meg van true adva vagy nincs megadva, a rendszer hozzáadja az új adatokat, majd AcceptChanges meghívja a rendszer az összes módosítás elfogadására a DataTable; ha az argumentum az false, akkor az újonnan hozzáadott sorok beszúrásként lesznek megjelölve, a meglévő sorok módosításai pedig módosításként lesznek megjelölve.

Kivételek is előfordulhatnak egy vagy ColumnChanging egy RowChanging esemény során. Kivétel esetén a sor nem lesz hozzáadva a táblához.

Használata LoadDataRow a következővel BeginLoadData együtt: és EndLoadData.

Lásd még

• DataTables
• DataTable-események kezelése

LoadDataRow(Object[], LoadOption)

Forrás:

DataTable.cs

Megkeres és frissít egy adott sort. Ha nem található egyező sor, a rendszer új sort hoz létre a megadott értékekkel.

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

Paraméterek

values

Object[]

Az új sor létrehozásához használt értékek tömbje.

loadOption

LoadOption

Annak meghatározására szolgál, hogy a tömbértékek hogyan legyenek alkalmazva a meglévő sorok megfelelő értékeire.

Válaszok

DataRow

Az új DataRow.

Megjegyzések

A LoadDataRow metódus egy értéktömböt használ, és megkeresi az egyező érték(ek)et az elsődleges kulcsoszlop(ok)ban.

Ha egy oszlop alapértelmezett értékkel rendelkezik, adjon meg egy null értéket a tömbben az oszlop alapértelmezett értékének beállításához. Hasonlóképpen, ha egy oszlop tulajdonsága AutoIncrement igaz értékre van állítva, adjon át egy null értéket a tömbben a sor automatikusan generált értékének beállításához.

A paraméter értéke loadOption annak meghatározására szolgál, hogy a tömb értékei hogyan legyenek alkalmazva egy meglévő sorra. Ha például be van állítva, loadOption az OverwriteChanges egyes oszlopok értékeit Original a bejövő sor értékeire cseréli, a tulajdonság Currentértéke pedig a RowState következő.Unchanged

Kivételek is előfordulhatnak egy vagy ColumnChanging egy RowChanging esemény során. Kivétel esetén a sor nem lesz hozzáadva a táblához.

Használata LoadDataRow a következővel BeginLoadData együtt: és EndLoadData.

Lásd még

• DataTables