DataRow Klasa

Definicja

Reprezentuje wiersz danych w obiekcie DataTable.

public ref class DataRow
public class DataRow
[System.Serializable]
public class DataRow
type DataRow = class
[<System.Serializable>]
type DataRow = class
Public Class DataRow
Dziedziczenie
DataRow
Atrybuty

Przykłady

Poniższy przykład tworzy nowy DataRow obiekt przez wywołanie NewRow metody DataTable obiektu .

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

Uwagi

Obiekty DataRow i DataColumn są podstawowymi składnikami obiektu DataTable. DataRow Użyj obiektu oraz jego właściwości i metod, aby pobrać i ocenić, a także wstawić, usunąć i zaktualizować wartości w obiekcie DataTable. Obiekt DataRowCollection reprezentuje rzeczywiste DataRow obiekty w obiekcie DataTable, a DataColumnCollection obiekt zawiera DataColumn obiekty opisujące schemat obiektu DataTable. Użyj właściwości przeciążonejItem[], aby zwrócić lub ustawić wartość .DataColumn

HasVersion Użyj właściwości i IsNull , aby określić stan określonej wartości wiersza i RowState właściwość w celu określenia stanu wiersza względem jego nadrzędnego DataTable.

Aby utworzyć nowy DataRowelement , użyj NewRow metody DataTable obiektu . Po utworzeniu nowego DataRowobiektu użyj Add metody , aby dodać nowy DataRow element do klasy DataRowCollection. Na koniec wywołaj metodę AcceptChangesDataTable obiektu, aby potwierdzić dodanie. Aby uzyskać więcej informacji na temat dodawania danych do elementu DataTable, zobacz Dodawanie danych do tabeli DataTable.

Obiekt można usunąć DataRow , DataRowCollection wywołując Remove metodę DataRowCollection, lub wywołując metodę DeleteDataRow obiektu . Metoda Remove usuwa wiersz z kolekcji. Z kolei oznacza Delete wartość DataRow do usunięcia. Rzeczywiste usunięcie występuje podczas wywoływania AcceptChanges metody. DeleteWywołując metodę , można programowo sprawdzić, które wiersze są oznaczone do usunięcia przed ich faktycznym usunięciem. Aby uzyskać więcej informacji, zobacz Usuwanie elementu DataRow.

Konstruktory

DataRow(DataRowBuilder)

Inicjuje nowe wystąpienie klasy DataRow przy użyciu określonego konstruktora. Tylko w przypadku użycia wewnętrznego.

Właściwości

HasErrors

Pobiera wartość wskazującą, czy występują błędy w wierszu.

Item[DataColumn, DataRowVersion]

Pobiera określoną wersję danych przechowywanych w określonym DataColumnpliku .

Item[DataColumn]

Pobiera lub ustawia dane przechowywane w określonym DataColumnobiekcie .

Item[Int32, DataRowVersion]

Pobiera dane przechowywane w kolumnie określonej przez indeks i wersję danych do pobrania.

Item[Int32]

Pobiera lub ustawia dane przechowywane w kolumnie określonej przez indeks.

Item[String, DataRowVersion]

Pobiera określoną wersję danych przechowywanych w nazwanej kolumnie.

Item[String]

Pobiera lub ustawia dane przechowywane w kolumnie określonej przez nazwę.

ItemArray

Pobiera lub ustawia wszystkie wartości dla tego wiersza za pośrednictwem tablicy.

RowError

Pobiera lub ustawia niestandardowy opis błędu dla wiersza.

RowState

Pobiera bieżący stan wiersza w odniesieniu do jego relacji z .DataRowCollection

Table

Pobiera schemat DataTable , dla którego ten wiersz ma schemat.

Metody

AcceptChanges()

Zatwierdza wszystkie zmiany wprowadzone w tym wierszu od czasu ostatniego AcceptChanges() wywołania.

BeginEdit()

Uruchamia operację edycji obiektu DataRow .

CancelEdit()

Anuluje bieżącą edycję w wierszu.

ClearErrors()

Czyści błędy dla wiersza. Obejmuje to błędy RowError i ustawione za pomocą polecenia SetColumnError(Int32, String).

Delete()

Usuwa element DataRow.

EndEdit()

Kończy edycję występującą w wierszu.

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.

(Odziedziczone po Object)
GetChildRows(DataRelation)

Pobiera podrzędne wiersze tego DataRow elementu przy użyciu określonego DataRelationelementu .

GetChildRows(DataRelation, DataRowVersion)

Pobiera podrzędne wiersze obiektu DataRow przy użyciu określonych DataRelationparametrów i DataRowVersion.

GetChildRows(String)

Pobiera podrzędne wiersze obiektu DataRow przy użyciu określonego RelationName elementu DataRelation.

GetChildRows(String, DataRowVersion)

Pobiera podrzędne wiersze obiektu DataRow przy użyciu określonego RelationName elementu DataRelation, i DataRowVersion.

GetColumnError(DataColumn)

Pobiera opis błędu określonego DataColumnelementu .

GetColumnError(Int32)

Pobiera opis błędu dla kolumny określonej przez indeks.

GetColumnError(String)

Pobiera opis błędu dla kolumny określonej przez nazwę.

GetColumnsInError()

Pobiera tablicę kolumn, które zawierają błędy.

GetHashCode()

Służy jako domyślna funkcja skrótu.

(Odziedziczone po Object)
GetParentRow(DataRelation)

Pobiera wiersz nadrzędny obiektu DataRow przy użyciu określonego DataRelationelementu .

GetParentRow(DataRelation, DataRowVersion)

Pobiera wiersz nadrzędny obiektu DataRow przy użyciu określonych DataRelationelementów i DataRowVersion.

GetParentRow(String)

Pobiera wiersz nadrzędny obiektu DataRow przy użyciu określonego RelationName elementu DataRelation.

GetParentRow(String, DataRowVersion)

Pobiera wiersz nadrzędny obiektu DataRow przy użyciu określonego RelationNameDataRelationelementu , i DataRowVersion.

GetParentRows(DataRelation)

Pobiera wiersze nadrzędne obiektu DataRow przy użyciu określonego DataRelationelementu .

GetParentRows(DataRelation, DataRowVersion)

Pobiera wiersze nadrzędne obiektu DataRow przy użyciu określonych DataRelationelementów i DataRowVersion.

GetParentRows(String)

Pobiera wiersze nadrzędne obiektu DataRow przy użyciu określonego RelationName elementu DataRelation.

GetParentRows(String, DataRowVersion)

Pobiera wiersze nadrzędne obiektu DataRow przy użyciu określonego RelationName elementu DataRelation, i DataRowVersion.

GetType()

Type Pobiera wartość bieżącego wystąpienia.

(Odziedziczone po Object)
HasVersion(DataRowVersion)

Pobiera wartość wskazującą, czy określona wersja istnieje.

IsNull(DataColumn)

Pobiera wartość wskazującą, czy określona DataColumn wartość zawiera wartość null.

IsNull(DataColumn, DataRowVersion)

Pobiera wartość wskazującą, czy określona DataColumn i DataRowVersion zawiera wartość null.

IsNull(Int32)

Pobiera wartość wskazującą, czy kolumna w określonym indeksie zawiera wartość null.

IsNull(String)

Pobiera wartość wskazującą, czy nazwana kolumna zawiera wartość null.

MemberwiseClone()

Tworzy płytkią kopię bieżącego Objectelementu .

(Odziedziczone po Object)
RejectChanges()

Odrzuca wszystkie zmiany wprowadzone w wierszu od AcceptChanges() ostatniego wywołania.

SetAdded()

Zmienia element RowState typu DataRow na Added.

SetColumnError(DataColumn, String)

Ustawia opis błędu dla kolumny określonej jako DataColumn.

SetColumnError(Int32, String)

Ustawia opis błędu dla kolumny określonej przez indeks.

SetColumnError(String, String)

Ustawia opis błędu dla kolumny określonej przez nazwę.

SetModified()

Zmienia element RowState typu DataRow na Modified.

SetNull(DataColumn)

Ustawia wartość określonej DataColumn wartości na wartość null.

SetParentRow(DataRow)

Ustawia wiersz nadrzędny obiektu DataRow z określonym nowym elementem nadrzędnym DataRow.

SetParentRow(DataRow, DataRelation)

Ustawia wiersz nadrzędny obiektu DataRow z określonym nowym elementem nadrzędnym DataRow i DataRelation.

ToString()

Zwraca ciąg reprezentujący bieżący obiekt.

(Odziedziczone po Object)

Metody rozszerzania

Field<T>(DataRow, DataColumn)

Zapewnia silnie typizowany dostęp do każdej z wartości kolumn w określonym wierszu. Metoda Field<T>(DataRow, DataColumn) obsługuje również typy dopuszczane do wartości null.

Field<T>(DataRow, DataColumn, DataRowVersion)

Zapewnia silnie typizowany dostęp do każdej z wartości kolumn w określonym wierszu. Metoda Field<T>(DataRow, DataColumn, DataRowVersion) obsługuje również typy dopuszczane do wartości null.

Field<T>(DataRow, Int32)

Zapewnia silnie typizowany dostęp do każdej z wartości kolumn w określonym wierszu. Metoda Field<T>(DataRow, Int32) obsługuje również typy dopuszczane do wartości null.

Field<T>(DataRow, Int32, DataRowVersion)

Zapewnia silnie typizowany dostęp do każdej z wartości kolumn w określonym wierszu. Metoda Field<T>(DataRow, Int32, DataRowVersion) obsługuje również typy dopuszczane do wartości null.

Field<T>(DataRow, String)

Zapewnia silnie typizowany dostęp do każdej z wartości kolumn w określonym wierszu. Metoda Field<T>(DataRow, String) obsługuje również typy dopuszczane do wartości null.

Field<T>(DataRow, String, DataRowVersion)

Zapewnia silnie typizowany dostęp do każdej z wartości kolumn w określonym wierszu. Metoda Field<T>(DataRow, String, DataRowVersion) obsługuje również typy dopuszczane do wartości null.

SetField<T>(DataRow, DataColumn, T)

Ustawia nową wartość dla określonej kolumny w obiekcie DataRow. Metoda SetField<T>(DataRow, DataColumn, T) obsługuje również typy dopuszczane do wartości null.

SetField<T>(DataRow, Int32, T)

Ustawia nową wartość dla określonej kolumny w metodzie DataRow jest wywoływana. Metoda SetField<T>(DataRow, Int32, T) obsługuje również typy dopuszczane do wartości null.

SetField<T>(DataRow, String, T)

Ustawia nową wartość dla określonej kolumny w obiekcie DataRow. Metoda SetField<T>(DataRow, String, T) obsługuje również typy dopuszczane do wartości null.

Dotyczy

Bezpieczeństwo wątkowe

Ten typ jest bezpieczny dla operacji odczytu wielowątkowego. Należy zsynchronizować wszystkie operacje zapisu.

Zobacz też