DataRow Klasa

Definicja

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

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

Przykłady

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

Obiekty DataRow i DataColumn sąpodstawowymiDataTableskładnikami.The DataRow and DataColumn objects are primary components of a DataTable. Użyj obiektu i jego właściwości i metod, aby pobrać i oszacować, a następnie wstawić, usunąć i zaktualizować wartości DataTablew. DataRowUse the DataRow object and its properties and methods to retrieve and evaluate; and insert, delete, and update the values in the DataTable. ReprezentujerzeczywisteDataRow obiekty wDataTablei DataTablezawiera obiekty,któreopisująschematDataColumn. DataColumnCollection DataRowCollectionThe 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[String, DataRowVersion] właściwości do zwrócenia lub ustawienia wartości DataColumn.Use the overloaded Item[String, DataRowVersion] property to return or set the value of a DataColumn.

Użyj właściwości IsNull RowState i, aby określić stan określonej wartości wiersza i właściwość, aby określić stan wiersza względem jego elementu nadrzędnego DataTable. HasVersionUse 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, NewRow Użyj metody DataTable obiektu.To create a new DataRow, use the NewRow method of the DataTable object. Po utworzeniu nowego DataRowelementu Add Użyj metody, aby DataRowCollectiondodać nowy DataRow do.After creating a new DataRow, use the Add method to add the new DataRow to the DataRowCollection. Na koniec Wywołaj AcceptChanges metodę DataTable obiektu, 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 DataTabledo, zobacz Dodawanie danych do elementu DataTable.For more information about adding data to a DataTable, see Adding Data to a DataTable.

Można DataRow usunąć Remove DataRow z elementu przezDataRowCollectionwywołaniemetody lub przez wywołanie metodyobiektu.Delete DataRowCollectionYou 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. Remove Metoda usuwa wiersz z kolekcji.The Remove method removes the row from the collection. W przeciwieństwie Delete DataRow oznacza 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 DataColumnelemencie.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 DataRowCollectionz.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 RowError to również błędów ustawionych przy użyciu SetColumnError(Int32, String).This includes the RowError and errors set with SetColumnError(Int32, String).

Delete()

DataRowUsuwa.Deletes the DataRow.

EndEdit()

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

Equals(Object)

Określa, czy określony obiekt jest równy bieżącemu obiektowi.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 DataRelationelementu.Gets the child rows of this DataRow using the specified DataRelation.

GetChildRows(DataRelation, DataRowVersion)

Pobiera wiersze DataRow podrzędne przy użyciu określonych DataRelationelementów 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 RelationName DataRelationelementu.Gets the child rows of a DataRow using the specified RelationName of a DataRelation.

GetChildRows(String, DataRowVersion)

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

GetParentRow(String)

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

GetParentRow(String, DataRowVersion)

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

GetParentRows(DataRelation)

Pobiera wiersze DataRow nadrzędne, 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 DataRelationelementów i DataRowVersion.Gets the parent rows of a DataRow using the specified DataRelation, and DataRowVersion.

GetParentRows(String)

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

GetParentRows(String, DataRowVersion)

Pobiera wiersze DataRow nadrzędne DataRelation, używając określonych RelationName elementów i 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ś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 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 .AddedChanges 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 .ModifiedChanges 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 DataRow nadrzędny obiektu 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 DataRow nadrzędny obiektu 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, który reprezentuje 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ż