DataRow Třída

Definice

Představuje řádek dat v DataTable.Represents a row of data in a DataTable.

public ref class DataRow
[System.Serializable]
public class DataRow
type DataRow = class
Public Class DataRow
Dědičnost
DataRow
Atributy

Příklady

Následující příklad vytvoří nový DataRow NewRow voláním metody DataTable objektu.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

Poznámky

Objekty DataRow a DataColumn jsouprimárnímiDataTablesoučástmi.The DataRow and DataColumn objects are primary components of a DataTable. Použijte objekt a jeho vlastnosti a metody k načtení a vyhodnocení a vložení, odstranění a aktualizaci hodnot DataTablev. DataRowUse the DataRow object and its properties and methods to retrieve and evaluate; and insert, delete, and update the values in the DataTable. PředstavujeskutečnéDataRow objekty vDataTablea DataTableobsahuje objekty,DataColumn které popisují schéma. 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. Pomocí přetížené Item[String, DataRowVersion] vlastnosti můžete vrátit nebo nastavit hodnotu DataColumn.Use the overloaded Item[String, DataRowVersion] property to return or set the value of a DataColumn.

Pomocí vlastností IsNull RowState a určete stav konkrétní hodnoty řádku a vlastnost, která určí stav řádku relativně vzhledem k jeho nadřazenému objektu 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.

Chcete-li vytvořit DataRownový, NewRow použijte metodu DataTable objektu.To create a new DataRow, use the NewRow method of the DataTable object. Po DataRowvytvoření nového Add použijte metodu k DataRow přidání nového do. DataRowCollectionAfter creating a new DataRow, use the Add method to add the new DataRow to the DataRowCollection. Nakonec zavolejte AcceptChanges metodu DataTable objektu pro potvrzení přidání.Finally, call the AcceptChanges method of the DataTable object to confirm the addition. Další informace o přidávání dat do DataTable, najdete v tématu Přidání dat do objektu DataTable.For more information about adding data to a DataTable, see Adding Data to a DataTable.

Můžete DataRow odstranit Remove DataRow z ,DataRowCollectionvolánímmetody,nebo voláním metodyobjektu.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 odebere řádek z kolekce.The Remove method removes the row from the collection. Naproti tomu Delete DataRow označení pro odebrání.In contrast, Delete marks the DataRow for removal. Ke skutečnému odebrání dojde při volání AcceptChanges metody.The actual removal occurs when you call AcceptChanges method. Voláním Deletemůžete programově ověřit, které řádky jsou označeny pro odebrání, než je skutečně odstraníte.By calling Delete, you can programmatically check which rows are marked for removal before actually deleting them. Další informace najdete v tématu odstranění objektu DataRow.For more information, see DataRow Deletion.

Konstruktory

DataRow(DataRowBuilder)

Inicializuje novou instanci objektu DataRow.Initializes a new instance of the DataRow. Sestaví řádek z tvůrce.Constructs a row from the builder. Pouze pro interní použití.Only for internal usage.

Vlastnosti

HasErrors

Načte hodnotu, která označuje, zda jsou v řádku chyby.Gets a value that indicates whether there are errors in a row.

Item[DataColumn, DataRowVersion]

Načte zadanou verzi dat uloženou v zadaném DataColumn.Gets the specified version of data stored in the specified DataColumn.

Item[DataColumn]

Získá nebo nastaví data uložená v zadaném DataColumn.Gets or sets the data stored in the specified DataColumn.

Item[Int32, DataRowVersion]

Načte data uložená ve sloupci, která jsou určena indexem a verzí dat, která mají být načtena.Gets the data stored in the column, specified by index and version of the data to retrieve.

Item[Int32]

Získá nebo nastaví data uložená ve sloupci zadaném indexem.Gets or sets the data stored in the column specified by index.

Item[String, DataRowVersion]

Načte zadanou verzi dat uloženou v pojmenovaném sloupci.Gets the specified version of data stored in the named column.

Item[String]

Získá nebo nastaví data uložená ve sloupci určeném názvem.Gets or sets the data stored in the column specified by name.

ItemArray

Získá nebo nastaví všechny hodnoty pro tento řádek pomocí pole.Gets or sets all the values for this row through an array.

RowError

Získá nebo nastaví vlastní popis chyby pro řádek.Gets or sets the custom error description for a row.

RowState

Získá aktuální stav řádku s ohledem na jeho vztah k DataRowCollection.Gets the current state of the row with regard to its relationship to the DataRowCollection.

Table

Získá, DataTable pro který má tento řádek schéma.Gets the DataTable for which this row has a schema.

Metody

AcceptChanges()

Potvrdí všechny změny provedené na tomto řádku od posledního AcceptChanges() volání.Commits all the changes made to this row since the last time AcceptChanges() was called.

BeginEdit()

Spustí operaci DataRow Edit objektu.Starts an edit operation on a DataRow object.

CancelEdit()

Zruší aktuální úpravu řádku.Cancels the current edit on the row.

ClearErrors()

Vymaže chyby pro řádek.Clears the errors for the row. To zahrnuje chyby RowError a SetColumnError(Int32, String)nastavené na.This includes the RowError and errors set with SetColumnError(Int32, String).

Delete()

DataRowOdstraní.Deletes the DataRow.

EndEdit()

Ukončí úpravy, ke kterým došlo na řádku.Ends the edit occurring on the row.

Equals(Object)

Určuje, zda se zadaný objekt rovná aktuálnímu objektu.Determines whether the specified object is equal to the current object.

(Zděděno od Object)
GetChildRows(DataRelation)

Načte podřízené řádky tohoto DataRow typu pomocí zadaného. DataRelationGets the child rows of this DataRow using the specified DataRelation.

GetChildRows(DataRelation, DataRowVersion)

Načte podřízené řádky DataRow pomocí zadaného DataRelationa DataRowVersion.Gets the child rows of a DataRow using the specified DataRelation, and DataRowVersion.

GetChildRows(String)

Načte podřízené řádky s DataRow použitím zadaného RelationName objektu DataRelation.Gets the child rows of a DataRow using the specified RelationName of a DataRelation.

GetChildRows(String, DataRowVersion)

Načte DataRow podřízené řádky s použitím zadaného RelationName DataRelationtypu a a DataRowVersion.Gets the child rows of a DataRow using the specified RelationName of a DataRelation, and DataRowVersion.

GetColumnError(DataColumn)

Získá popis chyby určeného DataColumntypu.Gets the error description of the specified DataColumn.

GetColumnError(Int32)

Získá popis chyby pro sloupec určený indexem.Gets the error description for the column specified by index.

GetColumnError(String)

Získá popis chyby pro sloupec zadaný pomocí názvu.Gets the error description for a column, specified by name.

GetColumnsInError()

Získá pole sloupců, které obsahují chyby.Gets an array of columns that have errors.

GetHashCode()

Slouží jako výchozí funkce hash.Serves as the default hash function.

(Zděděno od Object)
GetParentRow(DataRelation)

Načte nadřazený řádek DataRow pomocí zadaného DataRelationelementu.Gets the parent row of a DataRow using the specified DataRelation.

GetParentRow(DataRelation, DataRowVersion)

Načte nadřazený řádek DataRow pomocí zadaného DataRelationa DataRowVersion.Gets the parent row of a DataRow using the specified DataRelation, and DataRowVersion.

GetParentRow(String)

Získá nadřazený řádek s DataRow použitím zadaného RelationName objektu DataRelation.Gets the parent row of a DataRow using the specified RelationName of a DataRelation.

GetParentRow(String, DataRowVersion)

Získá DataRow nadřazený řádek s použitím zadaného RelationName DataRelationtypu a a DataRowVersion.Gets the parent row of a DataRow using the specified RelationName of a DataRelation, and DataRowVersion.

GetParentRows(DataRelation)

Načte nadřazené řádky pomocí zadaného DataRow DataRelationtypu.Gets the parent rows of a DataRow using the specified DataRelation.

GetParentRows(DataRelation, DataRowVersion)

Načte nadřazené řádky DataRow pomocí zadaného DataRelationa DataRowVersion.Gets the parent rows of a DataRow using the specified DataRelation, and DataRowVersion.

GetParentRows(String)

Získá nadřazené řádky s DataRow použitím zadaného RelationName objektu DataRelation.Gets the parent rows of a DataRow using the specified RelationName of a DataRelation.

GetParentRows(String, DataRowVersion)

Získá DataRow nadřazené řádky s použitím zadaného RelationName DataRelationtypu a a DataRowVersion.Gets the parent rows of a DataRow using the specified RelationName of a DataRelation, and DataRowVersion.

GetType()

Type Získá aktuální instanci.Gets the Type of the current instance.

(Zděděno od Object)
HasVersion(DataRowVersion)

Načte hodnotu, která označuje, jestli zadaná verze existuje.Gets a value that indicates whether a specified version exists.

IsNull(DataColumn)

Načte hodnotu, která označuje, zda zadaná DataColumn hodnota obsahuje hodnotu null.Gets a value that indicates whether the specified DataColumn contains a null value.

IsNull(DataColumn, DataRowVersion)

Získá hodnotu, která označuje, zda zadaná DataColumn a DataRowVersion obsahuje hodnotu null.Gets a value that indicates whether the specified DataColumn and DataRowVersion contains a null value.

IsNull(Int32)

Získá hodnotu, která označuje, zda sloupec v zadaném indexu obsahuje hodnotu null.Gets a value that indicates whether the column at the specified index contains a null value.

IsNull(String)

Načte hodnotu, která označuje, jestli pojmenovaný sloupec obsahuje hodnotu null.Gets a value that indicates whether the named column contains a null value.

MemberwiseClone()

Vytvoří kopii aktuálního Objectseznamu.Creates a shallow copy of the current Object.

(Zděděno od Object)
RejectChanges()

Odmítne všechny změny provedené na řádku od AcceptChanges() posledního volání.Rejects all changes made to the row since AcceptChanges() was last called.

SetAdded()

Změní na RowState. DataRow AddedChanges the RowState of a DataRow to Added.

SetColumnError(DataColumn, String)

Nastaví popis chyby pro sloupec zadaný jako DataColumn.Sets the error description for a column specified as a DataColumn.

SetColumnError(Int32, String)

Nastaví popis chyby pro sloupec určený indexem.Sets the error description for a column specified by index.

SetColumnError(String, String)

Nastaví popis chyby pro sloupec určený podle názvu.Sets the error description for a column specified by name.

SetModified()

Změní na RowState. DataRow ModifiedChanges the RowState of a DataRow to Modified.

SetNull(DataColumn)

Nastaví hodnotu zadaného DataColumn na hodnotu null.Sets the value of the specified DataColumn to a null value.

SetParentRow(DataRow)

Nastaví nadřazený řádek a DataRow se zadaným novým nadřazeným objektem. DataRowSets the parent row of a DataRow with specified new parent DataRow.

SetParentRow(DataRow, DataRelation)

Nastaví nadřazený řádek DataRow se zadaným novým nadřazeným DataRow objektem a DataRelation.Sets the parent row of a DataRow with specified new parent DataRow and DataRelation.

ToString()

Vrací řetězec, který představuje aktuální objekt.Returns a string that represents the current object.

(Zděděno od Object)

Metody rozšíření

Field<T>(DataRow, DataColumn)

Poskytuje přístup ke všem hodnotám sloupců v zadaném řádku se silným typem.Provides strongly-typed access to each of the column values in the specified row. Field<T>(DataRow, DataColumn) Metoda také podporuje typy s možnou hodnotou null.The Field<T>(DataRow, DataColumn) method also supports nullable types.

Field<T>(DataRow, DataColumn, DataRowVersion)

Poskytuje přístup ke všem hodnotám sloupců v zadaném řádku se silným typem.Provides strongly-typed access to each of the column values in the specified row. Field<T>(DataRow, DataColumn, DataRowVersion) Metoda také podporuje typy s možnou hodnotou null.The Field<T>(DataRow, DataColumn, DataRowVersion) method also supports nullable types.

Field<T>(DataRow, Int32)

Poskytuje přístup ke všem hodnotám sloupců v zadaném řádku se silným typem.Provides strongly-typed access to each of the column values in the specified row. Field<T>(DataRow, Int32) Metoda také podporuje typy s možnou hodnotou null.The Field<T>(DataRow, Int32) method also supports nullable types.

Field<T>(DataRow, Int32, DataRowVersion)

Poskytuje přístup ke všem hodnotám sloupců v zadaném řádku se silným typem.Provides strongly-typed access to each of the column values in the specified row. Field<T>(DataRow, Int32, DataRowVersion) Metoda také podporuje typy s možnou hodnotou null.The Field<T>(DataRow, Int32, DataRowVersion) method also supports nullable types.

Field<T>(DataRow, String)

Poskytuje přístup ke všem hodnotám sloupců v zadaném řádku se silným typem.Provides strongly-typed access to each of the column values in the specified row. Field<T>(DataRow, String) Metoda také podporuje typy s možnou hodnotou null.The Field<T>(DataRow, String) method also supports nullable types.

Field<T>(DataRow, String, DataRowVersion)

Poskytuje přístup ke všem hodnotám sloupců v zadaném řádku se silným typem.Provides strongly-typed access to each of the column values in the specified row. Field<T>(DataRow, String, DataRowVersion) Metoda také podporuje typy s možnou hodnotou null.The Field<T>(DataRow, String, DataRowVersion) method also supports nullable types.

SetField<T>(DataRow, DataColumn, T)

Nastaví novou hodnotu pro zadaný sloupec v DataRow.Sets a new value for the specified column in the DataRow. SetField<T>(DataRow, DataColumn, T) Metoda také podporuje typy s možnou hodnotou null.The SetField<T>(DataRow, DataColumn, T) method also supports nullable types.

SetField<T>(DataRow, Int32, T)

Nastaví novou hodnotu pro zadaný sloupec v DataRow metodě, která je volána.Sets a new value for the specified column in the DataRow the method is called on. SetField<T>(DataRow, Int32, T) Metoda také podporuje typy s možnou hodnotou null.The SetField<T>(DataRow, Int32, T) method also supports nullable types.

SetField<T>(DataRow, String, T)

Nastaví novou hodnotu pro zadaný sloupec v DataRow.Sets a new value for the specified column in the DataRow. SetField<T>(DataRow, String, T) Metoda také podporuje typy s možnou hodnotou null.The SetField<T>(DataRow, String, T) method also supports nullable types.

Platí pro

Bezpečný přístup z více vláken

Tento typ je bezpečný pro operace čtení ve více vláknech.This type is safe for multithreaded read operations. Je nutné synchronizovat všechny operace zápisu.You must synchronize any write operations.

Viz také