DataTable.LoadDataRow Metoda

Definicja

Przestrzeń nazw:

System.Data

Zestaw:

System.Data.Common.dll

Znajduje i aktualizuje określony wiersz. Jeśli nie znaleziono pasującego wiersza, zostanie utworzony nowy wiersz przy użyciu podanych wartości.

Przeciążenia

LoadDataRow(Object[], Boolean)	Znajduje i aktualizuje określony wiersz. Jeśli nie znaleziono pasującego wiersza, zostanie utworzony nowy wiersz przy użyciu podanych wartości.
LoadDataRow(Object[], LoadOption)	Znajduje i aktualizuje określony wiersz. Jeśli nie znaleziono pasującego wiersza, zostanie utworzony nowy wiersz przy użyciu podanych wartości.

LoadDataRow(Object[], Boolean)

Źródło:

DataTable.cs

Znajduje i aktualizuje określony wiersz. Jeśli nie znaleziono pasującego wiersza, zostanie utworzony nowy wiersz przy użyciu podanych wartości.

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

Parametry

values

Object[]

Tablica wartości używanych do utworzenia nowego wiersza.

fAcceptChanges

Boolean

true akceptowanie zmian; w przeciwnym razie false.

Zwraca

DataRow

Nowy DataRowelement .

Wyjątki

ArgumentException

Tablica jest większa niż liczba kolumn w tabeli.

InvalidCastException

Wartość nie jest zgodna z odpowiednim typem kolumny.

ConstraintException

Dodanie wiersza unieważnia ograniczenie.

NoNullAllowedException

Próba umieszczenia wartości null w kolumnie, w której AllowDBNull wartość jest fałszem.

Przykłady

W poniższym przykładzie użyto LoadDataRow metody , aby spróbować znaleźć wiersz. Jeśli taki wiersz nie zostanie znaleziony, wartości zostaną użyte do utworzenia nowego wiersza.

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

Uwagi

Metoda LoadDataRow przyjmuje tablicę wartości i znajduje pasujące wartości w kolumnach klucza podstawowego.

Jeśli kolumna ma wartość domyślną, przekaż wartość null w tablicy, aby ustawić wartość domyślną dla tej kolumny. Podobnie jeśli kolumna ma ustawioną AutoIncrement właściwość true, przekaż wartość null w tablicy, aby ustawić automatycznie wygenerowaną wartość dla wiersza.

fAcceptChanges Jeśli parametr jest true określony, nowe dane są dodawane, a następnie AcceptChanges jest wywoływane w celu zaakceptowania wszystkich zmian w elemecie DataTable; jeśli argument to false, nowo dodane wiersze są oznaczone jako wstawiania, a zmiany w istniejących wierszach są oznaczone jako modyfikacje.

Wyjątki mogą również wystąpić podczas ColumnChanging zdarzenia lub RowChanging . Jeśli wystąpi wyjątek, wiersz nie zostanie dodany do tabeli.

Użyj LoadDataRow w połączeniu z i BeginLoadDataEndLoadData.

Zobacz też

• Elementy DataTable
• Obsługa zdarzeń elementu DataTable

LoadDataRow(Object[], LoadOption)

Źródło:

DataTable.cs

Znajduje i aktualizuje określony wiersz. Jeśli nie znaleziono pasującego wiersza, zostanie utworzony nowy wiersz przy użyciu podanych wartości.

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

Parametry

values

Object[]

Tablica wartości używanych do utworzenia nowego wiersza.

loadOption

LoadOption

Służy do określania sposobu stosowania wartości tablicy do odpowiednich wartości w istniejącym wierszu.

Zwraca

DataRow

Nowy DataRowelement .

Uwagi

Metoda LoadDataRow przyjmuje tablicę wartości i znajduje pasujące wartości w kolumnach klucza podstawowego.

Jeśli kolumna ma wartość domyślną, przekaż wartość null w tablicy, aby ustawić wartość domyślną dla tej kolumny. Podobnie jeśli kolumna ma ustawioną AutoIncrement właściwość true, przekaż wartość null w tablicy, aby ustawić automatycznie wygenerowaną wartość dla wiersza.

Wartość parametru loadOption służy do określania sposobu stosowania wartości w tablicy do istniejącego wiersza. Jeśli na przykład ustawiono OverwriteChangeswartość , Original wartości i Current każdej kolumny zostaną zastąpione wartościami w wierszu przychodzącym, a RowState właściwość ma wartość Unchanged.loadOption

Wyjątki mogą również wystąpić podczas ColumnChanging zdarzenia lub RowChanging . Jeśli wystąpi wyjątek, wiersz nie zostanie dodany do tabeli.

Użyj LoadDataRow w połączeniu z i BeginLoadDataEndLoadData.

Zobacz też

• Elementy DataTable