DataRow Klasse

Definition

public ref class DataRow

public class DataRow

[System.Serializable]
public class DataRow

type DataRow = class

[<System.Serializable>]
type DataRow = class

Public Class DataRow

Vererbung

Object

DataRow

Attribute

SerializableAttribute

Beispiele

Im folgenden Beispiel wird eine neue DataRow erstellt, indem die NewRow -Methode des DataTable -Objekts aufgerufen wird.

private void CreateNewDataRow()
{
    // Use the MakeTable function below to create a new table.
    DataTable table;
    table = MakeNamesTable();

    // Once a table has been created, use the
    // NewRow to create a DataRow.
    DataRow row;
    row = table.NewRow();

    // Then add the new row to the collection.
    row["fName"] = "John";
    row["lName"] = "Smith";
    table.Rows.Add(row);

    foreach(DataColumn column in table.Columns)
        Console.WriteLine(column.ColumnName);
    dataGrid1.DataSource=table;
}

private DataTable MakeNamesTable()
{
    // Create a new DataTable titled 'Names.'
    DataTable namesTable = new DataTable("Names");

    // Add three column objects to the table.
    DataColumn idColumn = new  DataColumn();
    idColumn.DataType = System.Type.GetType("System.Int32");
    idColumn.ColumnName = "id";
    idColumn.AutoIncrement = true;
    namesTable.Columns.Add(idColumn);

    DataColumn fNameColumn = new DataColumn();
    fNameColumn.DataType = System.Type.GetType("System.String");
    fNameColumn.ColumnName = "Fname";
    fNameColumn.DefaultValue = "Fname";
    namesTable.Columns.Add(fNameColumn);

    DataColumn lNameColumn = new DataColumn();
    lNameColumn.DataType = System.Type.GetType("System.String");
    lNameColumn.ColumnName = "LName";
    namesTable.Columns.Add(lNameColumn);

    // Create an array for DataColumn objects.
    DataColumn [] keys = new DataColumn [1];
    keys[0] = idColumn;
    namesTable.PrimaryKey = keys;

    // Return the new DataTable.
    return namesTable;
}

Private Sub CreateNewDataRow()
    ' Use the MakeTable function below to create a new table.
    Dim table As DataTable
    table = MakeNamesTable()

    ' Once a table has been created, use the 
    ' NewRow to create a DataRow.
    Dim row As DataRow 
    row = table.NewRow()

    ' Then add the new row to the collection.
    row("fName") = "John"
    row("lName") = "Smith"
    table.Rows.Add(row)
    
    Dim column As DataColumn
    For Each column in table.Columns
       Console.WriteLine(column.ColumnName)
    Next
    DataGrid1.DataSource=table
 End Sub
 
 Private Function MakeNamesTable() As DataTable
    ' Create a new DataTable titled 'Names.'
    Dim namesTable As New DataTable("Names") 

    ' Add three column objects to the table.
    Dim idColumn As New DataColumn()
    idColumn.DataType = System.Type.GetType("System.Int32")
    idColumn.ColumnName = "id"
    idColumn.AutoIncrement = True
    namesTable.Columns.Add(idColumn)

    Dim fNameColumn As New DataColumn()
    fNameColumn.DataType = System.Type.GetType("System.String")
    fNameColumn.ColumnName = "Fname"
    fNameColumn.DefaultValue = "Fname"
    namesTable.Columns.Add(fNameColumn)

    Dim lNameColumn As New DataColumn()
    lNameColumn.DataType = System.Type.GetType("System.String")
    lNameColumn.ColumnName = "LName"
    namesTable.Columns.Add(lNameColumn)

    ' Create an array for DataColumn objects.
    Dim keys(0) As DataColumn 
    keys(0) = idColumn
    namesTable.PrimaryKey = keys

    ' Return the new DataTable.
    MakeNamesTable = namesTable
 End Function

Hinweise

Die DataRow -Objekte und DataColumn sind primäre Komponenten eines DataTable. Verwenden Sie das DataRow -Objekt und seine Eigenschaften und Methoden zum Abrufen und Auswerten, und fügen Sie die Werte in ein, löschen und aktualisieren Sie die Werte in .DataTable Stellt DataRowCollection die tatsächlichen DataRow Objekte in dar DataTable, und enthält DataColumnCollection die -Objekte, die DataColumn das Schema von DataTablebeschreiben. Verwenden Sie die überladene Item[] Eigenschaft, um den Wert eines DataColumnzurückzugeben oder festzulegen.

Verwenden Sie die HasVersion Eigenschaften undIsNull, um die status eines bestimmten Zeilenwerts zu bestimmen, und die RowState -Eigenschaft, um den Zustand der Zeile relativ zu ihrem übergeordneten DataTableWert zu bestimmen.

Um eine neue DataRowzu erstellen, verwenden Sie die NewRow -Methode des DataTable -Objekts. Nachdem Sie eine neue DataRowerstellt haben, verwenden Sie die Add -Methode, um das neue DataRow dem hinzuzufügen DataRowCollection. Rufen Sie schließlich die AcceptChanges -Methode des DataTable -Objekts auf, um die Addition zu bestätigen. Weitere Informationen zum Hinzufügen von Daten zu einem DataTablefinden Sie unter Hinzufügen von Daten zu einer DataTable.

Sie können eine DataRow aus dem DataRowCollection löschen, indem Sie die Remove -Methode von DataRowCollectionaufrufen oder die Delete -Methode des DataRow -Objekts aufrufen. Die Remove -Methode entfernt die Zeile aus der Auflistung. Markiert im Gegensatz dazu Delete den für das DataRow Entfernen. Die tatsächliche Entfernung erfolgt, wenn Sie die Methode aufrufen AcceptChanges . Durch aufrufen Deletekönnen Sie programmgesteuert überprüfen, welche Zeilen zum Entfernen markiert sind, bevor sie tatsächlich gelöscht werden. Weitere Informationen finden Sie unter Löschen von DataRow.

Konstruktoren

Eigenschaften

Methoden

Erweiterungsmethoden

Gilt für:

Threadsicherheit

Dieser Typ ist für Multithread-Lesevorgänge sicher. Sie müssen alle Schreibvorgänge synchronisieren.

Weitere Informationen

• AcceptChanges()
• Add(DataRow)
• DataColumnCollection
• DataColumn
• DataRowView
• DataTable
• HasVersion(DataRowVersion)
• IsNull(Int32)
• Item[Int32]
• NewRow()
• DataRowCollection
• Verwenden von DataSets in ADO.NET