DataRow Klasa

Definicja

Przedstawia wiersz danych w DataTable.Represents a row of data in a DataTable.

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

Przykłady

Poniższy przykład tworzy nowy DataRow, wywołując metodę NewRow obiektu DataTable.The following example creates a new DataRow by calling the NewRow method of the DataTable object.

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 DataTable.The DataRow and DataColumn objects are primary components of a DataTable. Użyj obiektu DataRow i jego właściwości i metod, aby pobrać i oszacować; Wstawianie, usuwanie i aktualizowanie wartości w DataTable.Use the DataRow object and its properties and methods to retrieve and evaluate; and insert, delete, and update the values in the DataTable. DataRowCollection reprezentuje rzeczywiste obiekty DataRow w DataTable, a DataColumnCollection zawiera obiekty DataColumn opisujące schemat DataTable.The DataRowCollection represents the actual DataRow objects in the DataTable, and the DataColumnCollection contains the DataColumn objects that describe the schema of the DataTable. Użyj właściwości przeciążone Item[], aby zwrócić lub ustawić wartość DataColumn.Use the overloaded Item[] property to return or set the value of a DataColumn.

Użyj właściwości HasVersion i IsNull, aby określić stan określonej wartości wiersza i Właściwość RowState, aby określić stan wiersza względem jego DataTablenadrzędnego.Use the HasVersion and IsNull properties to determine the status of a particular row value, and the RowState property to determine the state of the row relative to its parent DataTable.

Aby utworzyć nowy DataRow, użyj metody NewRow obiektu DataTable.To create a new DataRow, use the NewRow method of the DataTable object. Po utworzeniu nowego DataRowUżyj metody Add, aby dodać nowy DataRow do DataRowCollection.After creating a new DataRow, use the Add method to add the new DataRow to the DataRowCollection. Na koniec Wywołaj metodę AcceptChanges obiektu DataTable, aby potwierdzić dodanie.Finally, call the AcceptChanges method of the DataTable object to confirm the addition. Aby uzyskać więcej informacji na temat dodawania danych do DataTable, zobacz Dodawanie danych do elementu DataTable.For more information about adding data to a DataTable, see Adding Data to a DataTable.

Można usunąć DataRow z DataRowCollection, wywołując metodę Remove DataRowCollectionlub wywołując metodę Delete obiektu DataRow.You can delete a DataRow from the DataRowCollection by calling the Remove method of the DataRowCollection, or by calling the Delete method of the DataRow object. Metoda Remove usuwa wiersz z kolekcji.The Remove method removes the row from the collection. Z kolei Delete oznacza DataRow do usunięcia.In contrast, Delete marks the DataRow for removal. Faktyczne usunięcie odbywa się po wywołaniu metody AcceptChanges.The actual removal occurs when you call AcceptChanges method. Wywołując Delete, można programowo sprawdzić, które wiersze są oznaczone do usunięcia przed ich usunięciem.By calling Delete, you can programmatically check which rows are marked for removal before actually deleting them. Aby uzyskać więcej informacji, zobacz usuwanie elementu DataRow.For more information, see DataRow Deletion.

Konstruktory

DataRow(DataRowBuilder)

Inicjuje nowe wystąpienie obiektu DataRow.Initializes a new instance of the DataRow. Konstruuje wiersz z konstruktora.Constructs a row from the builder. Tylko do użytku wewnętrznego.Only for internal usage.

Właściwości

HasErrors

Pobiera wartość wskazującą, czy w wierszu występują błędy.Gets a value that indicates whether there are errors in a row.

Item[DataColumn, DataRowVersion]

Pobiera określoną wersję danych przechowywanych w określonym DataColumn.Gets the specified version of data stored in the specified DataColumn.

Item[DataColumn]

Pobiera lub ustawia dane przechowywane w określonym DataColumn.Gets or sets the data stored in the specified DataColumn.

Item[Int32, DataRowVersion]

Pobiera dane przechowywane w kolumnie, określone przez indeks i wersję danych do pobrania.Gets the data stored in the column, specified by index and version of the data to retrieve.

Item[Int32]

Pobiera lub ustawia dane przechowywane w kolumnie określonej przez indeks.Gets or sets the data stored in the column specified by index.

Item[String, DataRowVersion]

Pobiera określoną wersję danych przechowywanych w nazwanej kolumnie.Gets the specified version of data stored in the named column.

Item[String]

Pobiera lub ustawia dane przechowywane w kolumnie określonej przez nazwę.Gets or sets the data stored in the column specified by name.

ItemArray

Pobiera lub ustawia wszystkie wartości dla tego wiersza za pomocą tablicy.Gets or sets all the values for this row through an array.

RowError

Pobiera lub ustawia niestandardowy opis błędu dla wiersza.Gets or sets the custom error description for a row.

RowState

Pobiera bieżący stan wiersza w odniesieniu do jego relacji do DataRowCollection.Gets the current state of the row with regard to its relationship to the DataRowCollection.

Table

Pobiera DataTable, dla których ten wiersz zawiera schemat.Gets the DataTable for which this row has a schema.

Metody

AcceptChanges()

Zatwierdza wszystkie zmiany wprowadzone w tym wierszu od momentu ostatniego wywołania AcceptChanges().Commits all the changes made to this row since the last time AcceptChanges() was called.

BeginEdit()

Uruchamia operację edycji na obiekcie DataRow.Starts an edit operation on a DataRow object.

CancelEdit()

Anuluje bieżącą edycję w wierszu.Cancels the current edit on the row.

ClearErrors()

Czyści błędy dla wiersza.Clears the errors for the row. Obejmuje to RowError i błędy ustawione z SetColumnError(Int32, String).This includes the RowError and errors set with SetColumnError(Int32, String).

Delete()

Usuwa DataRow.Deletes the DataRow.

EndEdit()

Zamyka edycję w wierszu.Ends the edit occurring on the row.

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
GetChildRows(DataRelation)

Pobiera podrzędne wiersze tego DataRow przy użyciu określonego DataRelation.Gets the child rows of this DataRow using the specified DataRelation.

GetChildRows(DataRelation, DataRowVersion)

Pobiera wiersze podrzędne DataRow przy użyciu określonej DataRelationi DataRowVersion.Gets the child rows of a DataRow using the specified DataRelation, and DataRowVersion.

GetChildRows(String)

Pobiera wiersze podrzędne DataRow przy użyciu określonego RelationName DataRelation.Gets the child rows of a DataRow using the specified RelationName of a DataRelation.

GetChildRows(String, DataRowVersion)

Pobiera wiersze podrzędne DataRow przy użyciu określonego RelationName DataRelationi DataRowVersion.Gets the child rows of a DataRow using the specified RelationName of a DataRelation, and DataRowVersion.

GetColumnError(DataColumn)

Pobiera opis błędu określonego DataColumn.Gets the error description of the specified DataColumn.

GetColumnError(Int32)

Pobiera opis błędu dla kolumny określonej przez indeks.Gets the error description for the column specified by index.

GetColumnError(String)

Pobiera opis błędu dla kolumny określonej przez nazwę.Gets the error description for a column, specified by name.

GetColumnsInError()

Pobiera tablicę kolumn, które zawierają błędy.Gets an array of columns that have errors.

GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetParentRow(DataRelation)

Pobiera wiersz nadrzędny DataRow przy użyciu określonego DataRelation.Gets the parent row of a DataRow using the specified DataRelation.

GetParentRow(DataRelation, DataRowVersion)

Pobiera wiersz nadrzędny DataRow przy użyciu określonej DataRelationi DataRowVersion.Gets the parent row of a DataRow using the specified DataRelation, and DataRowVersion.

GetParentRow(String)

Pobiera wiersz nadrzędny DataRow przy użyciu określonego RelationName DataRelation.Gets the parent row of a DataRow using the specified RelationName of a DataRelation.

GetParentRow(String, DataRowVersion)

Pobiera wiersz nadrzędny DataRow przy użyciu określonego RelationName DataRelationi DataRowVersion.Gets the parent row of a DataRow using the specified RelationName of a DataRelation, and DataRowVersion.

GetParentRows(DataRelation)

Pobiera wiersze nadrzędne DataRow przy użyciu określonego DataRelation.Gets the parent rows of a DataRow using the specified DataRelation.

GetParentRows(DataRelation, DataRowVersion)

Pobiera wiersze nadrzędne DataRow przy użyciu określonej DataRelationi DataRowVersion.Gets the parent rows of a DataRow using the specified DataRelation, and DataRowVersion.

GetParentRows(String)

Pobiera wiersze nadrzędne DataRow przy użyciu określonego RelationName DataRelation.Gets the parent rows of a DataRow using the specified RelationName of a DataRelation.

GetParentRows(String, DataRowVersion)

Pobiera wiersze nadrzędne DataRow przy użyciu określonej RelationName DataRelationi DataRowVersion.Gets the parent rows of a DataRow using the specified RelationName of a DataRelation, and DataRowVersion.

GetType()

Pobiera Type bieżącego wystąpienia.Gets the Type of the current instance.

(Odziedziczone po Object)
HasVersion(DataRowVersion)

Pobiera wartość wskazującą, czy istnieje określona wersja.Gets a value that indicates whether a specified version exists.

IsNull(DataColumn)

Pobiera wartość wskazującą, czy określony DataColumn zawiera wartość null.Gets a value that indicates whether the specified DataColumn contains a null value.

IsNull(DataColumn, DataRowVersion)

Pobiera wartość wskazującą, czy określone DataColumn i DataRowVersion zawierają wartość null.Gets a value that indicates whether the specified DataColumn and DataRowVersion contains a null value.

IsNull(Int32)

Pobiera wartość wskazującą, czy kolumna o określonym indeksie zawiera wartość null.Gets a value that indicates whether the column at the specified index contains a null value.

IsNull(String)

Pobiera wartość wskazującą, czy nazwana kolumna zawiera wartość null.Gets a value that indicates whether the named column contains a null value.

MemberwiseClone()

Tworzy skróconą kopię bieżącego Object.Creates a shallow copy of the current Object.

(Odziedziczone po Object)
RejectChanges()

Odrzuca wszystkie zmiany wprowadzone w wierszu od momentu ostatniego wywołania AcceptChanges().Rejects all changes made to the row since AcceptChanges() was last called.

SetAdded()

Zmienia RowState DataRow do Added.Changes the RowState of a DataRow to Added.

SetColumnError(DataColumn, String)

Ustawia opis błędu dla kolumny określonej jako DataColumn.Sets the error description for a column specified as a DataColumn.

SetColumnError(Int32, String)

Ustawia opis błędu dla kolumny określonej przez indeks.Sets the error description for a column specified by index.

SetColumnError(String, String)

Ustawia opis błędu dla kolumny określonej przez nazwę.Sets the error description for a column specified by name.

SetModified()

Zmienia RowState DataRow do Modified.Changes the RowState of a DataRow to Modified.

SetNull(DataColumn)

Ustawia wartość określonego DataColumn na wartość null.Sets the value of the specified DataColumn to a null value.

SetParentRow(DataRow)

Ustawia wiersz nadrzędny DataRow z określonym nowym DataRownadrzędnym.Sets the parent row of a DataRow with specified new parent DataRow.

SetParentRow(DataRow, DataRelation)

Ustawia wiersz nadrzędny DataRow z określonym nowym DataRow nadrzędnym i DataRelation.Sets the parent row of a DataRow with specified new parent DataRow and DataRelation.

ToString()

Zwraca ciąg reprezentujący bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)

Metody rozszerzania

Field<T>(DataRow, DataColumn)

Zapewnia jednoznacznie dostęp do każdej wartości kolumny w określonym wierszu.Provides strongly-typed access to each of the column values in the specified row. Metoda Field<T>(DataRow, DataColumn) obsługuje również Typy dopuszczające wartości null.The Field<T>(DataRow, DataColumn) method also supports nullable types.

Field<T>(DataRow, DataColumn, DataRowVersion)

Zapewnia jednoznacznie dostęp do każdej wartości kolumny w określonym wierszu.Provides strongly-typed access to each of the column values in the specified row. Metoda Field<T>(DataRow, DataColumn, DataRowVersion) obsługuje również Typy dopuszczające wartości null.The Field<T>(DataRow, DataColumn, DataRowVersion) method also supports nullable types.

Field<T>(DataRow, Int32)

Zapewnia jednoznacznie dostęp do każdej wartości kolumny w określonym wierszu.Provides strongly-typed access to each of the column values in the specified row. Metoda Field<T>(DataRow, Int32) obsługuje również Typy dopuszczające wartości null.The Field<T>(DataRow, Int32) method also supports nullable types.

Field<T>(DataRow, Int32, DataRowVersion)

Zapewnia jednoznacznie dostęp do każdej wartości kolumny w określonym wierszu.Provides strongly-typed access to each of the column values in the specified row. Metoda Field<T>(DataRow, Int32, DataRowVersion) obsługuje również Typy dopuszczające wartości null.The Field<T>(DataRow, Int32, DataRowVersion) method also supports nullable types.

Field<T>(DataRow, String)

Zapewnia jednoznacznie dostęp do każdej wartości kolumny w określonym wierszu.Provides strongly-typed access to each of the column values in the specified row. Metoda Field<T>(DataRow, String) obsługuje również Typy dopuszczające wartości null.The Field<T>(DataRow, String) method also supports nullable types.

Field<T>(DataRow, String, DataRowVersion)

Zapewnia jednoznacznie dostęp do każdej wartości kolumny w określonym wierszu.Provides strongly-typed access to each of the column values in the specified row. Metoda Field<T>(DataRow, String, DataRowVersion) obsługuje również Typy dopuszczające wartości null.The Field<T>(DataRow, String, DataRowVersion) method also supports nullable types.

SetField<T>(DataRow, DataColumn, T)

Ustawia nową wartość dla określonej kolumny w DataRow.Sets a new value for the specified column in the DataRow. Metoda SetField<T>(DataRow, DataColumn, T) obsługuje również Typy dopuszczające wartości null.The SetField<T>(DataRow, DataColumn, T) method also supports nullable types.

SetField<T>(DataRow, Int32, T)

Ustawia nową wartość dla określonej kolumny w DataRow Metoda jest wywoływana.Sets a new value for the specified column in the DataRow the method is called on. Metoda SetField<T>(DataRow, Int32, T) obsługuje również Typy dopuszczające wartości null.The SetField<T>(DataRow, Int32, T) method also supports nullable types.

SetField<T>(DataRow, String, T)

Ustawia nową wartość dla określonej kolumny w DataRow.Sets a new value for the specified column in the DataRow. Metoda SetField<T>(DataRow, String, T) obsługuje również Typy dopuszczające wartości null.The SetField<T>(DataRow, String, T) method also supports nullable types.

Dotyczy

Bezpieczeństwo wątkowe

Ten typ jest bezpieczny dla wielowątkowych operacji odczytu.This type is safe for multithreaded read operations. Należy zsynchronizować wszystkie operacje zapisu.You must synchronize any write operations.

Zobacz też