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
[<System.Serializable>]
type DataRow = class
Public Class DataRow
Dziedziczenie
DataRow
Atrybuty

Przykłady

Poniższy przykład tworzy nowe DataRow przez wywołanie NewRow metody DataTable obiektu.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

DataRowObiekty i DataColumn są podstawowymi składnikami DataTable .The DataRow and DataColumn objects are primary components of a DataTable. Użyj DataRow obiektu i jego właściwości i metod, aby pobrać i oszacować, a następnie wstawić, usunąć i zaktualizować 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. DataRowCollectionReprezentuje rzeczywiste DataRow obiekty w DataTable i DataColumnCollection zawiera DataColumn obiekty, które opisują 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 przeciążonej Item[] właściwości do zwrócenia lub ustawienia wartości DataColumn .Use the overloaded Item[] property to return or set the value of a DataColumn.

Użyj HasVersion właściwości i, IsNull Aby określić stan określonej wartości wiersza i RowState Właściwość, aby określić stan wiersza względem jego elementu nadrzędnego DataTable .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 NewRow metody DataTable obiektu.To create a new DataRow, use the NewRow method of the DataTable object. Po utworzeniu nowego elementu DataRow Uż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 AcceptChanges metodę 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ąć z elementu DataRow DataRowCollection przez wywołanie Remove metody DataRowCollection lub przez wywołanie Delete metody DataRow obiektu.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. RemoveMetoda usuwa wiersz z kolekcji.The Remove method removes the row from the collection. W przeciwieństwie Delete oznacza DataRow do usunięcia.In contrast, Delete marks the DataRow for removal. Faktyczne usunięcie odbywa się po wywołaniu AcceptChanges metody.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 faktycznym 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 elemencie 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 z DataRowCollection .Gets the current state of the row with regard to its relationship to the DataRowCollection.

Table

Pobiera, DataTable dla którego 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 AcceptChanges() wywołania.Commits all the changes made to this row since the last time AcceptChanges() was called.

BeginEdit()

Uruchamia operację edycji dla DataRow obiektu.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. Dotyczy to również RowError błędów ustawionych przy użyciu 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 elementu DataRelation .Gets the child rows of this DataRow using the specified DataRelation.

GetChildRows(DataRelation, DataRowVersion)

Pobiera wiersze podrzędne DataRow przy użyciu określonych elementów DataRelation i DataRowVersion .Gets the child rows of a DataRow using the specified DataRelation, and DataRowVersion.

GetChildRows(String)

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

GetChildRows(String, DataRowVersion)

Pobiera wiersze podrzędne z DataRow przy użyciu określonych RelationName elementów DataRelation i 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 nadrzędny wiersz obiektu DataRow przy użyciu określonego DataRelation .Gets the parent row of a DataRow using the specified DataRelation.

GetParentRow(DataRelation, DataRowVersion)

Pobiera nadrzędny wiersz obiektu DataRow przy użyciu określonych elementów DataRelation i DataRowVersion .Gets the parent row of a DataRow using the specified DataRelation, and DataRowVersion.

GetParentRow(String)

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

GetParentRow(String, DataRowVersion)

Pobiera nadrzędny wiersz obiektu DataRow przy użyciu określonych RelationName elementów DataRelation i DataRowVersion .Gets the parent row of a DataRow using the specified RelationName of a DataRelation, and DataRowVersion.

GetParentRows(DataRelation)

Pobiera wiersze nadrzędne, DataRow używając określonego DataRelation .Gets the parent rows of a DataRow using the specified DataRelation.

GetParentRows(DataRelation, DataRowVersion)

Pobiera wiersze nadrzędne DataRow , używając określonych elementów DataRelation i DataRowVersion .Gets the parent rows of a DataRow using the specified DataRelation, and DataRowVersion.

GetParentRows(String)

Pobiera wiersze nadrzędne, DataRow używając określonego elementu RelationName DataRelation .Gets the parent rows of a DataRow using the specified RelationName of a DataRelation.

GetParentRows(String, DataRowVersion)

Pobiera wiersze nadrzędne DataRow , używając określonych RelationName elementów DataRelation i DataRowVersion .Gets the parent rows of a DataRow using the specified RelationName of a DataRelation, and DataRowVersion.

GetType()

Pobiera Type bieżące wystąpienie.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ślona 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ślony DataColumn i DataRowVersion zawiera 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 elementu Object .Creates a shallow copy of the current Object.

(Odziedziczone po Object)
RejectChanges()

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

SetAdded()

Zmienia wartość RowState DataRow na 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 wartość RowState DataRow na Modified .Changes the RowState of a DataRow to Modified.

SetNull(DataColumn)

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

SetParentRow(DataRow)

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

SetParentRow(DataRow, DataRelation)

Ustawia wiersz nadrzędny obiektu DataRow z określonym nowym elementem nadrzędnym DataRow 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. Field<T>(DataRow, DataColumn)Metoda 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. Field<T>(DataRow, DataColumn, DataRowVersion)Metoda 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. Field<T>(DataRow, Int32)Metoda 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. Field<T>(DataRow, Int32, DataRowVersion)Metoda 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. Field<T>(DataRow, String)Metoda 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. Field<T>(DataRow, String, DataRowVersion)Metoda 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. SetField<T>(DataRow, DataColumn, T)Metoda 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 metodzie jest wywoływana w.Sets a new value for the specified column in the DataRow the method is called on. SetField<T>(DataRow, Int32, T)Metoda 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. SetField<T>(DataRow, String, T)Metoda 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ż