DataRow Třída

Definice

Obor názvů:

System.Data

Sestavení:

System.Data.Common.dll

Zdroj:

DataRow.cs

Představuje řádek dat v objektu DataTable.

public ref class DataRow

public class DataRow

type DataRow = class

Public Class DataRow

Dědičnost

Object

DataRow

Příklady

Následující příklad vytvoří nový DataRow voláním NewRow metody objektu DataTable .

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 jsou primárními komponentami objektu DataTable. DataRow K načtení a vyhodnocení použijte objekt a jeho vlastnosti a metody a vložte, odstraňte a aktualizujte hodnoty v objektu DataTable. Objekt DataRowCollection představuje skutečné DataRow objekty v objektu DataTablea DataColumnCollection obsahuje DataColumn objekty, které popisují schéma objektu DataTable. K vrácení nebo nastavení hodnoty DataColumnpoužijte přetíženou Item[] vlastnost .

HasVersion Vlastnosti a IsNull slouží k určení stavu konkrétní hodnoty řádku a RowState vlastnost k určení stavu řádku vzhledem k nadřazené hodnotě DataTable.

K vytvoření nového DataRowobjektu NewRow použijte metodu objektu DataTable . Po vytvoření nového DataRowpoužijte metodu Add k přidání nového DataRow do DataRowCollection. Nakonec voláním AcceptChanges metody objektu DataTable potvrďte přidání. Další informace o přidávání dat do DataTable, najdete v tématu Přidání dat do tabulky DataTable.

Můžete odstranit z objektu DataRowCollection voláním Remove metody DataRowCollectionnebo voláním Delete metody objektu DataRow .DataRow Metoda Remove odebere řádek z kolekce. Naproti tomu Delete nástroj označí pro DataRow odebrání. Ke skutečnému odebrání dojde při volání AcceptChanges metody . Voláním Deletepříkazu můžete programově zkontrolovat, které řádky jsou označené k odebrání, než je skutečně odstraníte. Další informace najdete v tématu Odstranění dataRow.

Konstruktory

DataRow(DataRowBuilder)

Inicializuje novou instanci DataRow třídy pomocí zadaného tvůrce. Pouze pro interní použití.

Vlastnosti

HasErrors	Získá hodnotu, která označuje, zda jsou chyby v řádku.
Item[DataColumn, DataRowVersion]	Získá zadanou verzi dat uloženou v zadaném DataColumn.
Item[DataColumn]	Získá nebo nastaví data uložená v zadaném DataColumnobjektu .
Item[Int32, DataRowVersion]	Získá data uložená ve sloupci určené indexem a verzí dat k načtení.
Item[Int32]	Získá nebo nastaví data uložená ve sloupci určeném indexem.
Item[String, DataRowVersion]	Získá zadanou verzi dat uloženou v pojmenovaném sloupci.
Item[String]	Získá nebo nastaví data uložená ve sloupci určeném názvem.
ItemArray	Získá nebo nastaví všechny hodnoty pro tento řádek prostřednictvím pole.
RowError	Získá nebo nastaví vlastní popis chyby pro řádek.
RowState	Získá aktuální stav řádku s ohledem na jeho vztah k DataRowCollection.
Table	Získá, DataTable pro který má tento řádek schéma.

Metody

AcceptChanges()	Potvrdí všechny změny provedené v tomto řádku od posledního AcceptChanges() zavolání.
BeginEdit()	Spustí operaci úprav objektu DataRow .
CancelEdit()	Zruší aktuální úpravy na řádku.
ClearErrors()	Vymaže chyby řádku. To zahrnuje RowError chyby a nastavené na SetColumnError(Int32, String).
Delete()	Odstraní .DataRow
EndEdit()	Ukončí úpravy na řádku.
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetChildRows(DataRelation)	Získá podřízené řádky tohoto DataRow objektu pomocí zadaného DataRelation.
GetChildRows(DataRelation, DataRowVersion)	Získá podřízené řádky objektu DataRow pomocí zadaných DataRelationa DataRowVersion.
GetChildRows(String)	Získá podřízené řádky objektu DataRow pomocí zadaného RelationName objektu DataRelation.
GetChildRows(String, DataRowVersion)	Získá podřízené řádky objektu DataRow pomocí zadaného RelationName objektu DataRelationa DataRowVersion.
GetColumnError(DataColumn)	Získá popis chyby zadaného DataColumn.
GetColumnError(Int32)	Získá popis chyby pro sloupec určený indexem.
GetColumnError(String)	Získá popis chyby pro sloupec určený názvem.
GetColumnsInError()	Získá pole sloupců, které obsahují chyby.
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetParentRow(DataRelation)	Získá nadřazený řádek objektu DataRow pomocí zadaného DataRelationobjektu .
GetParentRow(DataRelation, DataRowVersion)	Získá nadřazený řádek objektu DataRow pomocí zadaného DataRelationa DataRowVersion.
GetParentRow(String)	Získá nadřazený řádek objektu DataRow pomocí zadaného RelationName objektu DataRelation.
GetParentRow(String, DataRowVersion)	Získá nadřazený řádek objektu DataRow pomocí zadaného RelationName objektu DataRelationa DataRowVersion.
GetParentRows(DataRelation)	Získá nadřazené řádky objektu DataRow pomocí zadaného DataRelationobjektu .
GetParentRows(DataRelation, DataRowVersion)	Získá nadřazené řádky objektu DataRow pomocí zadaných DataRelationa DataRowVersion.
GetParentRows(String)	Získá nadřazené řádky objektu DataRow pomocí zadaného RelationName objektu DataRelation.
GetParentRows(String, DataRowVersion)	Získá nadřazené řádky objektu DataRow pomocí zadaného RelationName objektu DataRelationa DataRowVersion.
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
HasVersion(DataRowVersion)	Získá hodnotu, která označuje, zda zadaná verze existuje.
IsNull(DataColumn)	Získá hodnotu, která označuje, zda zadaný DataColumn obsahuje hodnotu null.
IsNull(DataColumn, DataRowVersion)	Získá hodnotu, která označuje, zda zadaný DataColumn a DataRowVersion obsahuje hodnotu null.
IsNull(Int32)	Získá hodnotu, která označuje, zda sloupec v zadaném indexu obsahuje hodnotu null.
IsNull(String)	Získá hodnotu, která označuje, zda pojmenovaný sloupec obsahuje hodnotu null.
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
RejectChanges()	Odmítne všechny změny provedené v řádku od AcceptChanges() posledního zavolání.
SetAdded()	Změní z RowState na DataRowAdded.
SetColumnError(DataColumn, String)	Nastaví popis chyby pro sloupec zadaný jako DataColumn.
SetColumnError(Int32, String)	Nastaví popis chyby pro sloupec určený indexem.
SetColumnError(String, String)	Nastaví popis chyby pro sloupec určený názvem.
SetModified()	Změní z RowState na DataRowModified.
SetNull(DataColumn)	Nastaví hodnotu zadané DataColumn na hodnotu null.
SetParentRow(DataRow)	Nastaví nadřazený řádek objektu DataRow se zadaným novým nadřazeným objektem DataRow.
SetParentRow(DataRow, DataRelation)	Nastaví nadřazený řádek objektu DataRow se zadaným novým nadřazeným DataRow objektem a DataRelation.
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Metody rozšíření

Field<T>(DataRow, DataColumn)	Poskytuje přístup silného typu ke každé hodnotě sloupce v zadaném řádku. Metoda Field<T>(DataRow, DataColumn) také podporuje typy s možnou hodnotou null.
Field<T>(DataRow, DataColumn, DataRowVersion)	Poskytuje přístup silného typu ke každé hodnotě sloupce v zadaném řádku. Metoda Field<T>(DataRow, DataColumn, DataRowVersion) také podporuje typy s možnou hodnotou null.
Field<T>(DataRow, Int32)	Poskytuje přístup silného typu ke každé hodnotě sloupce v zadaném řádku. Metoda Field<T>(DataRow, Int32) také podporuje typy s možnou hodnotou null.
Field<T>(DataRow, Int32, DataRowVersion)	Poskytuje přístup silného typu ke každé hodnotě sloupce v zadaném řádku. Metoda Field<T>(DataRow, Int32, DataRowVersion) také podporuje typy s možnou hodnotou null.
Field<T>(DataRow, String)	Poskytuje přístup silného typu ke každé hodnotě sloupce v zadaném řádku. Metoda Field<T>(DataRow, String) také podporuje typy s možnou hodnotou null.
Field<T>(DataRow, String, DataRowVersion)	Poskytuje přístup silného typu ke každé hodnotě sloupce v zadaném řádku. Metoda Field<T>(DataRow, String, DataRowVersion) také podporuje typy s možnou hodnotou null.
SetField<T>(DataRow, DataColumn, T)	Nastaví novou hodnotu pro zadaný sloupec v .DataRow Metoda SetField<T>(DataRow, DataColumn, T) také podporuje typy s možnou hodnotou null.
SetField<T>(DataRow, Int32, T)	Nastaví novou hodnotu pro zadaný sloupec v DataRow metodě je volána. Metoda SetField<T>(DataRow, Int32, T) také podporuje typy s možnou hodnotou null.
SetField<T>(DataRow, String, T)	Nastaví novou hodnotu pro zadaný sloupec v .DataRow Metoda SetField<T>(DataRow, String, T) také podporuje typy s možnou hodnotou null.

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

Tento typ je bezpečný pro operace čtení ve více vláknech. Je nutné synchronizovat všechny operace zápisu.

Viz také

• AcceptChanges()
• Add(DataRow)
• DataColumnCollection
• DataColumn
• DataRowView
• DataTable
• HasVersion(DataRowVersion)
• IsNull(Int32)
• Item[Int32]
• NewRow()
• DataRowCollection
• Použití datových sad v ADO.NET