DataRowCollection.Add Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Voegt een DataRow toe aan de DataRowCollection.
Overloads
| Name | Description |
|---|---|
| Add(DataRow) |
Hiermee voegt u de opgegeven DataRow waarde toe aan het DataRowCollection object. |
| Add(Object[]) |
Hiermee maakt u een rij met opgegeven waarden en voegt u deze toe aan de DataRowCollection. |
Add(DataRow)
Hiermee voegt u de opgegeven DataRow waarde toe aan het DataRowCollection object.
public:
void Add(System::Data::DataRow ^ row);public void Add(System.Data.DataRow row);member this.Add : System.Data.DataRow -> unitPublic Sub Add (row As DataRow)Parameters
Uitzonderingen
De rij is null.
De rij behoort tot een andere tabel of behoort al tot deze tabel.
De toevoeging maakt een beperking ongeldig.
De toevoeging probeert een null in een DataColumn waar AllowDBNull onwaar te plaatsen.
Voorbeelden
In het volgende voorbeeld wordt de Add methode gebruikt om een nieuw DataRow object toe te DataRowCollection voegen.
private void ShowRows(DataTable table)
{
// Print the number of rows in the collection.
Console.WriteLine(table.Rows.Count);
// Print the value of columns 1 in each row
foreach(DataRow row in table.Rows)
{
Console.WriteLine(row[1]);
}
}
private void AddRow(DataTable table)
{
DataRowCollection rowCollection = table.Rows;
// Instantiate a new row using the NewRow method.
DataRow newRow = table.NewRow();
// Insert code to fill the row with values.
// Add the row to the DataRowCollection.
table.Rows.Add(newRow);
}
Private Sub ShowRows(Byval table As DataTable)
' Print the number of rows in the collection.
Console.WriteLine(table.Rows.Count)
Dim row As DataRow
' Print the value of columns 1 in each row
For Each row In table.Rows
Console.WriteLine(row(1))
Next
End Sub
Private Sub AddRow(ByVal table As DataTable)
' Instantiate a new row using the NewRow method.
Dim newRow As DataRow = table.NewRow()
' Insert code to fill the row with values.
' Add the row to the DataRowCollection.
table.Rows.Add(newRow)
End Sub
Opmerkingen
Als u een nieuwe DataRowwilt maken, moet u de NewRow methode van de DataTable klasse gebruiken. Wanneer u de NewRow methode gebruikt, wordt een nieuw DataRow object geretourneerd met behulp van het schema van het bovenliggende DataTableitem. Nadat u het DataRow object hebt gemaakt en de waarden voor elk van de kolommen hebt ingesteld, gebruikt u de Add methode om het object toe te voegen aan de verzameling.
Genereert een uitzondering als de gebruiker een uitzondering genereert in de RowChanging gebeurtenis. Als er een uitzondering optreedt, wordt de rij niet toegevoegd aan de tabel.
Zie ook
Van toepassing op
Add(Object[])
Hiermee maakt u een rij met opgegeven waarden en voegt u deze toe aan de DataRowCollection.
public:
virtual System::Data::DataRow ^ Add(cli::array <System::Object ^> ^ values);public:
System::Data::DataRow ^ Add(... cli::array <System::Object ^> ^ values);public virtual System.Data.DataRow Add(object[] values);public System.Data.DataRow Add(params object[] values);abstract member Add : obj[] -> System.Data.DataRow
override this.Add : obj[] -> System.Data.DataRowmember this.Add : obj[] -> System.Data.DataRowPublic Overridable Function Add (values As Object()) As DataRowPublic Function Add (ParamArray values As Object()) As DataRowParameters
- values
- Object[]
De matrix met waarden die worden gebruikt om de nieuwe rij te maken.
Retouren
De nieuwe rij.
Uitzonderingen
De matrix is groter dan het aantal kolommen in de tabel.
Een waarde komt niet overeen met het respectieve kolomtype.
Als u de rij toevoegt, wordt een beperking ongeldig.
Er wordt geprobeerd een null in een kolom te plaatsen waar AllowDBNull onwaar is.
Voorbeelden
In het volgende voorbeeld wordt de Add methode gebruikt om een nieuw DataRow object aan een DataRowCollectionte maken en toe te voegen.
private void AddRow(DataTable table)
{
// Create an array with three elements.
object[] rowVals = new object[3];
DataRowCollection rowCollection = table.Rows;
rowVals[0] = "hello";
rowVals[1] = "world";
rowVals[2] = "two";
// Add and return the new row.
DataRow row = rowCollection.Add(rowVals);
}
Private Sub AddRow(ByVal table As DataTable)
' Create an array with three elements.
Dim rowVals(2) As Object
Dim rowCollection As DataRowCollection = table.Rows
rowVals(0) = "hello"
rowVals(1) = "world"
rowVals(2) = "two"
' Add and return the new row.
Dim row As DataRow = rowCollection.Add(rowVals)
End Sub
Opmerkingen
Als een DataColumn object is AutoIncrement ingesteld op True, moet null worden doorgegeven om de standaardwaarde voor die kolom op te halen.
Er kunnen ook uitzonderingen optreden als u een uitzondering genereert tijdens een ColumnChanging of RowChanging meer gebeurtenissen. Als er een uitzondering optreedt, wordt de rij niet toegevoegd aan de tabel.