DataTable.LoadDataRow Metod

Definition

Söker efter och uppdaterar en viss rad. Om ingen matchande rad hittas skapas en ny rad med de angivna värdena.

Överlagringar

Name Description
LoadDataRow(Object[], Boolean)

Söker efter och uppdaterar en viss rad. Om ingen matchande rad hittas skapas en ny rad med de angivna värdena.

LoadDataRow(Object[], LoadOption)

Söker efter och uppdaterar en viss rad. Om ingen matchande rad hittas skapas en ny rad med de angivna värdena.

LoadDataRow(Object[], Boolean)

Källa:
DataTable.cs
Källa:
DataTable.cs
Källa:
DataTable.cs
Källa:
DataTable.cs
Källa:
DataTable.cs

Söker efter och uppdaterar en viss rad. Om ingen matchande rad hittas skapas en ny rad med de angivna värdena.

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

Parametrar

values
Object[]

En matris med värden som används för att skapa den nya raden.

fAcceptChanges
Boolean

true för att acceptera ändringar; annars false.

Returer

Den nya DataRow.

Undantag

Matrisen är större än antalet kolumner i tabellen.

Ett värde matchar inte dess respektive kolumntyp.

Om du lägger till raden ogiltigförklaras en begränsning.

Försöker placera en null i en kolumn där AllowDBNull är false.

Exempel

I följande exempel används LoadDataRow metoden för att försöka hitta en rad. Om ingen sådan rad hittas används värdena för att skapa en ny rad.

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

Kommentarer

Metoden LoadDataRow tar en matris med värden och hittar matchande värden i primärnyckelkolumnerna.

Om en kolumn har ett standardvärde skickar du ett null-värde i matrisen för att ange standardvärdet för kolumnen. På samma sätt, om en kolumn har sin AutoIncrement egenskap inställd på true, skickar du ett null-värde i matrisen för att ange det automatiskt genererade värdet för raden.

Om parametern fAcceptChanges har true angetts eller inte har angetts läggs de nya data till och anropas sedan AcceptChanges för att acceptera alla ändringar i DataTable. Om argumentet är falsemarkeras nyligen tillagda rader som infogningar och ändringar i befintliga rader markeras som ändringar.

Undantag kan också inträffa under en eller ColumnChanging en RowChanging händelse. Om ett undantag inträffar läggs inte raden till i tabellen.

Använd LoadDataRow tillsammans med BeginLoadData och EndLoadData.

Se även

Gäller för

LoadDataRow(Object[], LoadOption)

Källa:
DataTable.cs
Källa:
DataTable.cs
Källa:
DataTable.cs
Källa:
DataTable.cs
Källa:
DataTable.cs

Söker efter och uppdaterar en viss rad. Om ingen matchande rad hittas skapas en ny rad med de angivna värdena.

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

Parametrar

values
Object[]

En matris med värden som används för att skapa den nya raden.

loadOption
LoadOption

Används för att fastställa hur matrisvärdena tillämpas på motsvarande värden i en befintlig rad.

Returer

Den nya DataRow.

Kommentarer

Metoden LoadDataRow tar en matris med värden och hittar matchande värden i primärnyckelkolumnerna.

Om en kolumn har ett standardvärde skickar du ett null-värde i matrisen för att ange standardvärdet för kolumnen. På samma sätt, om en kolumn har sin AutoIncrement egenskap inställd på true, skickar du ett null-värde i matrisen för att ange det automatiskt genererade värdet för raden.

Värdet för parametern loadOption används för att fastställa hur värdena i matrisen tillämpas på en befintlig rad. Om loadOption till exempel är inställt på OverwriteChangesOriginalersätts värdena och Current för varje kolumn med värdena i den inkommande raden och RowState egenskapen är inställd på Unchanged.

Undantag kan också inträffa under en eller ColumnChanging en RowChanging händelse. Om ett undantag inträffar läggs inte raden till i tabellen.

Använd LoadDataRow tillsammans med BeginLoadData och EndLoadData.

Se även

Gäller för