DataRow Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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() | |
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() | |
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.