DataRow Třída

Definice

Představuje řádek dat v objektu DataTable.

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

Příklady

Následující příklad vytvoří novou 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 objekty jsou primárními součástmi DataTable. Pomocí objektu DataRow a jeho vlastností a metod načtěte a vyhodnoťte a vkládejte, odstraňte a aktualizujte hodnoty v souboru DataTable. Představuje DataRowCollection skutečné DataRow objekty v DataTableobjektu a DataColumnCollection obsahuje DataColumn objekty, které popisují schéma DataTable. Použijte přetíženou Item[] vlastnost k vrácení nebo nastavení hodnoty DataColumn.

HasVersion Pomocí vlastností IsNull určete stav konkrétní hodnoty řádku a RowState vlastnost k určení stavu řádku vzhledem k nadřazené DataTable.

Chcete-li vytvořit novou DataRow, použijte NewRow metodu objektu DataTable . Po vytvoření nového DataRowpoužijte metodu Add k přidání nového DataRow do .DataRowCollection Nakonec zavolejte metodu AcceptChanges objektu DataTable pro potvrzení přidání. Další informace o přidávání dat do datové DataTabletabulky naleznete v tématu Přidání dat do tabulky DataTable.

Z objektu můžete odstranit DataRow voláním Remove metody DataRowCollection, nebo voláním Delete metody objektuDataRow.DataRowCollection Metoda Remove odebere řádek z kolekce. Naproti tomu Delete označí DataRow odebrání. K skutečnému odebrání dochází při volání AcceptChanges metody. DeleteVoláním můžete programově zkontrolovat, které řádky jsou označené k odebrání, než je skutečně odstraníte. Další informace naleznete v tématu Odstranění dataRow.

Konstruktory

DataRow(DataRowBuilder)

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

Vlastnosti

HasErrors

Získá hodnotu, která označuje, zda jsou v řádku chyby.

Item[DataColumn, DataRowVersion]

Získá zadanou verzi dat uloženou v zadané DataColumn.

Item[DataColumn]

Získá nebo nastaví data uložená v zadané DataColumn.

Item[Int32, DataRowVersion]

Získá data uložená ve sloupci, určená indexem a verzí dat, která se mají načíst.

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 řádku.

RowState

Získá aktuální stav řádku s ohledem na jeho vztah k DataRowCollection.

Table

Získá schéma 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 chyby RowError nastavené na SetColumnError(Int32, String).

Delete()

Odstraní DataRow.

EndEdit()

Ukončí úpravy, ke kterým dochází 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 pomocí zadané DataRelation.

GetChildRows(DataRelation, DataRowVersion)

Získá podřízené řádky DataRow pomocí zadaného DataRelationa DataRowVersion.

GetChildRows(String)

Získá podřízené řádky DataRow pomocí zadaného RelationName objektu DataRelation.

GetChildRows(String, DataRowVersion)

Získá podřízené řádky DataRow pomocí zadaného RelationName parametru DataRelationa DataRowVersion.

GetColumnError(DataColumn)

Získá popis chyby zadané DataColumn.

GetColumnError(Int32)

Získá popis chyby pro sloupec určený indexem.

GetColumnError(String)

Získá popis chyby pro sloupec zadaný podle názvu.

GetColumnsInError()

Získá pole sloupců, které mají chyby.

GetHashCode()

Slouží jako výchozí funkce hash.

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

Získá nadřazený řádek DataRow pomocí zadané DataRelation.

GetParentRow(DataRelation, DataRowVersion)

Získá nadřazený řádek DataRow pomocí zadaného DataRelationa DataRowVersion.

GetParentRow(String)

Získá nadřazený řádek DataRow pomocí zadaného RelationName objektu DataRelation.

GetParentRow(String, DataRowVersion)

Získá nadřazený řádek DataRow pomocí zadaného RelationName parametru DataRelationa DataRowVersion.

GetParentRows(DataRelation)

Získá nadřazené řádky DataRow pomocí zadané DataRelation.

GetParentRows(DataRelation, DataRowVersion)

Získá nadřazené řádky DataRow pomocí zadaného DataRelationa DataRowVersion.

GetParentRows(String)

Získá nadřazené řádky DataRow pomocí zadaného RelationName objektu DataRelation.

GetParentRows(String, DataRowVersion)

Získá nadřazené řádky DataRow pomocí zadaného RelationName parametru DataRelationa DataRowVersion.

GetType()

Type Získá aktuální instanci.

(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á urč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ří použádnou kopii aktuálního souboru Object.

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

Odmítne všechny změny provedené v řádku od AcceptChanges() posledního zavolání.

SetAdded()

RowState DataRow Změní na Added.

SetColumnError(DataColumn, String)

Nastaví popis chyby pro sloupec zadaný jako DataColumn.

SetColumnError(Int32, String)

Nastaví popis chyby sloupce určeného indexem.

SetColumnError(String, String)

Nastaví popis chyby sloupce určeného názvem.

SetModified()

RowState DataRow Změní na Modified.

SetNull(DataColumn)

Nastaví hodnotu zadané DataColumn hodnoty na hodnotu null.

SetParentRow(DataRow)

Nastaví nadřazený řádek DataRow s zadaným novým nadřazeným objektem DataRow.

SetParentRow(DataRow, DataRelation)

Nastaví nadřazený řádek s zadaným novým nadřazeným objektem DataRow DataRow 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 silné typy přístupu k jednotlivým hodnotám sloupců v zadaném řádku. Metoda Field<T>(DataRow, DataColumn) také podporuje typy s možnou hodnotou null.

Field<T>(DataRow, DataColumn, DataRowVersion)

Poskytuje silné typy přístupu k jednotlivým hodnotám sloupců v zadaném řádku. Metoda Field<T>(DataRow, DataColumn, DataRowVersion) také podporuje typy s možnou hodnotou null.

Field<T>(DataRow, Int32)

Poskytuje silné typy přístupu k jednotlivým hodnotám sloupců v zadaném řádku. Metoda Field<T>(DataRow, Int32) také podporuje typy s možnou hodnotou null.

Field<T>(DataRow, Int32, DataRowVersion)

Poskytuje silné typy přístupu k jednotlivým hodnotám sloupců v zadaném řádku. Metoda Field<T>(DataRow, Int32, DataRowVersion) také podporuje typy s možnou hodnotou null.

Field<T>(DataRow, String)

Poskytuje silné typy přístupu k jednotlivým hodnotám sloupců 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 k jednotlivým hodnotám sloupců 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 sadě 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 sadě DataRow. Metoda SetField<T>(DataRow, String, T) také podporuje typy s možnou hodnotou null.

Platí pro

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é