DataTable.LoadDataRow Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
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.