DataRow Třída

Definice

Obor názvů:

System.Data

Sestavení:

netstandard.dll, 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ří 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 jsou primárními komponentami objektu DataColumn.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 objektu DataTablea DataColumnCollection obsahuje DataColumn objekty, které popisují schéma DataTable. Použijte přetíženou Item[] vlastnost k vrácení nebo nastavení hodnoty objektu DataColumn.

HasVersion Pomocí a IsNull vlastností 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 pro přidání nové DataRow do souboru DataRowCollection. Nakonec zavolejte AcceptChanges metodu objektu DataTable k 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 DataRowCollection metody Remove, nebo voláním DataRowCollection metody objektuDelete.DataRow Metoda Remove odebere řádek z kolekce. Naproti tomu Delete označí DataRow pro odebrání. Skutečné odebrání nastane při volání AcceptChanges metody. Voláním Deletemůž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

Name	Description
DataRow(DataRowBuilder)	Inicializuje novou instanci Třídy DataRow pomocí zadaného tvůrce. Pouze pro interní použití.

Vlastnosti

Name	Description
HasErrors	Získá hodnotu, která označuje, zda jsou v řádku chyby.
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 DataColumn.
Item[Int32, DataRowVersion]	Získá data uložená ve sloupci určeném 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 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

Name	Description
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 a chyby nastavené na SetColumnError(Int32, String).
Delete()	Odstraní .DataRow
EndEdit()	Ukončí úpravy, ke kterým dochází na řádku.
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
GetChildRows(DataRelation, DataRowVersion)	Získá podřízené řádky DataRow pomocí zadaného DataRelationa DataRowVersion.
GetChildRows(DataRelation)	Získá podřízené řádky tohoto DataRow pomocí zadaného DataRelation.
GetChildRows(String, DataRowVersion)	Získá podřízené řádky DataRow pomocí zadaného RelationName parametru DataRelationa DataRowVersion.
GetChildRows(String)	Získá podřízené řádky DataRow pomocí zadaného RelationName parametru DataRelation.
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 sloupce určeného názvem.
GetColumnsInError()	Získá pole sloupců s chybami.
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetParentRow(DataRelation, DataRowVersion)	Získá nadřazený řádek DataRow pomocí zadané DataRelationa DataRowVersion.
GetParentRow(DataRelation)	Získá nadřazený řádek DataRow pomocí zadané DataRelation.
GetParentRow(String, DataRowVersion)	Získá nadřazený řádek DataRow pomocí zadané RelationNameDataRelationa DataRowVersion.
GetParentRow(String)	Získá nadřazený řádek DataRow pomocí zadané RelationNameDataRelation.
GetParentRows(DataRelation, DataRowVersion)	Získá nadřazené řádky DataRow pomocí zadaného DataRelationa DataRowVersion.
GetParentRows(DataRelation)	Získá nadřazené řádky pomocí DataRow zadaného DataRelation.
GetParentRows(String, DataRowVersion)	Získá nadřazené řádky DataRow pomocí zadaného RelationName parametru DataRelationa DataRowVersion.
GetParentRows(String)	Získá nadřazené řádky DataRow pomocí zadaného RelationName parametru DataRelation.
GetType()	Získá Type aktuální instance. (Zděděno od Object)
HasVersion(DataRowVersion)	Získá hodnotu, která určuje, zda zadaná verze existuje.
IsNull(DataColumn, DataRowVersion)	Získá hodnotu, která určuje, zda zadaný DataColumn a DataRowVersion obsahuje hodnotu null.
IsNull(DataColumn)	Získá hodnotu, která určuje, zda zadaný DataColumn obsahuje hodnotu null.
IsNull(Int32)	Získá hodnotu, která určuje, zda sloupec v zadaném indexu obsahuje hodnotu null.
IsNull(String)	Získá hodnotu, která určuje, zda pojmenovaný sloupec obsahuje hodnotu null.
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
RejectChanges()	Odmítne všechny změny provedené v řádku od AcceptChanges() posledního zavolání.
SetAdded()	RowState Změní 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()	RowState Změní na DataRowModified.
SetNull(DataColumn)	Nastaví hodnotu zadanou DataColumn na hodnotu null.
SetParentRow(DataRow, DataRelation)	Nastaví nadřazený řádek s určeným novým nadřazeným objektem DataRowDataRow a DataRelation.
SetParentRow(DataRow)	Nastaví nadřazený řádek zadaného nového nadřazeného objektu DataRowDataRow.
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Metody rozšíření

Name	Description
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, 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, 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, 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, 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.
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.
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.

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

Tento typ je bezpečný pro operace čtení s více vlákny. 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