DataTable.LoadDataRow Methode

Definition

Namespace:

System.Data

Assemblys:

netstandard.dll, System.Data.Common.dll

Sucht und aktualisiert eine bestimmte Zeile. Wenn keine übereinstimmende Zeile gefunden wird, wird mithilfe der angegebenen Werte eine neue Zeile erstellt.

Überlädt

Name	Beschreibung
LoadDataRow(Object[], Boolean)	Sucht und aktualisiert eine bestimmte Zeile. Wenn keine übereinstimmende Zeile gefunden wird, wird mithilfe der angegebenen Werte eine neue Zeile erstellt.
LoadDataRow(Object[], LoadOption)	Sucht und aktualisiert eine bestimmte Zeile. Wenn keine übereinstimmende Zeile gefunden wird, wird mithilfe der angegebenen Werte eine neue Zeile erstellt.

LoadDataRow(Object[], Boolean)

Quelle:

DataTable.cs

Sucht und aktualisiert eine bestimmte Zeile. Wenn keine übereinstimmende Zeile gefunden wird, wird mithilfe der angegebenen Werte eine neue Zeile erstellt.

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

Parameter

values

Object[]

Ein Array von Werten, die zum Erstellen der neuen Zeile verwendet werden.

fAcceptChanges

Boolean

true Änderungen annehmen; andernfalls false.

Gibt zurück

DataRow

Das neue DataRow.

Ausnahmen

ArgumentException

Das Array ist größer als die Anzahl der Spalten in der Tabelle.

InvalidCastException

Ein Wert stimmt nicht mit dem jeweiligen Spaltentyp überein.

ConstraintException

Durch Das Hinzufügen der Zeile wird eine Einschränkung ungültig.

NoNullAllowedException

Beim Versuch, eine Null in eine Spalte einzufügen, in AllowDBNull der "false" angegeben ist.

Beispiele

Im folgenden Beispiel wird die LoadDataRow Methode verwendet, um nach einer Zeile zu suchen. Wenn keine solche Zeile gefunden wird, werden die Werte verwendet, um eine neue Zeile zu erstellen.

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

Hinweise

Die LoadDataRow Methode verwendet ein Array von Werten und findet den übereinstimmenden Wert(n) in den Primärschlüsselspalten.

Wenn eine Spalte über einen Standardwert verfügt, übergeben Sie einen NULL-Wert im Array, um den Standardwert für diese Spalte festzulegen. Wenn eine Spalte ihre AutoIncrement Eigenschaft auf "true" festgelegt hat, übergeben Sie einen NULL-Wert im Array, um den automatisch generierten Wert für die Zeile festzulegen.

Wenn der fAcceptChanges Parameter angegeben ist true oder nicht, werden die neuen Daten hinzugefügt und dann AcceptChanges aufgerufen, um alle Änderungen im DataTable; wenn das Argument lautet false, werden neu hinzugefügte Zeilen als Einfügungen markiert, und Änderungen an vorhandenen Zeilen werden als Änderungen markiert.

Ausnahmen können auch während eines Ereignisses ColumnChanging auftreten RowChanging . Wenn eine Ausnahme auftritt, wird die Zeile nicht zur Tabelle hinzugefügt.

Wird LoadDataRow in Verbindung mit BeginLoadData und EndLoadData.

Weitere Informationen

• DataTables
• Behandeln von DataTable-Ereignissen

LoadDataRow(Object[], LoadOption)

Quelle:

DataTable.cs

Sucht und aktualisiert eine bestimmte Zeile. Wenn keine übereinstimmende Zeile gefunden wird, wird mithilfe der angegebenen Werte eine neue Zeile erstellt.

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

Parameter

values

Object[]

Ein Array von Werten, die zum Erstellen der neuen Zeile verwendet werden.

loadOption

LoadOption

Wird verwendet, um zu bestimmen, wie die Arraywerte auf die entsprechenden Werte in einer vorhandenen Zeile angewendet werden.

Gibt zurück

DataRow

Das neue DataRow.

Hinweise

Die LoadDataRow Methode verwendet ein Array von Werten und findet den übereinstimmenden Wert(n) in den Primärschlüsselspalten.

Wenn eine Spalte über einen Standardwert verfügt, übergeben Sie einen NULL-Wert im Array, um den Standardwert für diese Spalte festzulegen. Wenn eine Spalte ihre AutoIncrement Eigenschaft auf "true" festgelegt hat, übergeben Sie einen NULL-Wert im Array, um den automatisch generierten Wert für die Zeile festzulegen.

Der Wert des loadOption Parameters wird verwendet, um zu bestimmen, wie die Werte im Array auf eine vorhandene Zeile angewendet werden. Wenn sie beispielsweise loadOption auf " festgelegt ist , werden die Original Werte der Current einzelnen Spalten durch die Werte in der eingehenden Zeile ersetzt, und die RowState Eigenschaft wird auf UnchangedOverwriteChanges.

Ausnahmen können auch während eines Ereignisses ColumnChanging auftreten RowChanging . Wenn eine Ausnahme auftritt, wird die Zeile nicht zur Tabelle hinzugefügt.

Wird LoadDataRow in Verbindung mit BeginLoadData und EndLoadData.

Weitere Informationen

• DataTables