DataRow Osztály

Definíció

Névtér:

System.Data

Szerelvények:

netstandard.dll, System.Data.Common.dll

Forrás:

DataRow.cs

Egy adatsort jelöl egy DataTable.

public ref class DataRow

public class DataRow

type DataRow = class

Public Class DataRow

Öröklődés

Object

DataRow

Példák

Az alábbi példa újat DataRow hoz létre az NewRow objektum metódusának meghívásával 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

Megjegyzések

Az DataRow és DataColumn az objektumok a DataTable. DataRow Az objektum és annak tulajdonságai és metódusai segítségével lekérheti és kiértékelheti az objektum értékeit, valamint beszúrhatja, törölheti és frissítheti a DataTablefájlban lévő értékeket. A DataRowCollection rendszer a tényleges DataRow objektumokat jelöli a DataTablenézetben, és azokat DataColumnCollection az DataColumn objektumokat tartalmazza, amelyek a sémát DataTableírják le. A túlterhelt Item[] tulajdonság használatával adja vissza vagy állítsa be a függvény értékét DataColumn.

HasVersion IsNull A tulajdonságok segítségével meghatározhatja egy adott sorérték állapotát, a RowState tulajdonságot pedig a sor szülőhöz DataTableviszonyított állapotának meghatározásához.

Új DataRowlétrehozásához használja az NewRow objektum metódusát DataTable . Új létrehozása DataRowután a Add metódussal adja hozzá az újat DataRow a DataRowCollectionfájlhoz. Végül hívja meg az AcceptChanges objektum metódusát a DataTable hozzáadás megerősítéséhez. További információ az adatok adattáblához való DataTablehozzáadásáról: Adatok hozzáadása a DataTable-hoz.

Törölhet egy DataRow objektumot az DataRowCollectionRemove objektum metódusának DataRowCollectionmeghívásával vagy az DeleteDataRow objektum metódusának meghívásával. A Remove metódus eltávolítja a sort a gyűjteményből. Ezzel szemben Delete jelölje meg az DataRow eltávolítást. A tényleges eltávolítás a metódus hívásakor AcceptChanges történik. DeleteHívással programozott módon ellenőrizheti, hogy mely sorok legyenek kijelölve eltávolításra, mielőtt ténylegesen törölnénk őket. További információ: DataRow-törlés.

Konstruktorok

Name	Description
DataRow(DataRowBuilder)	Inicializálja a DataRow osztály új példányát a megadott szerkesztővel. Csak belső használatra.

Tulajdonságok

Name	Description
HasErrors	Olyan értéket kap, amely jelzi, hogy vannak-e hibák egy sorban.
Item[DataColumn, DataRowVersion]	Lekéri a megadott DataColumnhelyen tárolt adatok megadott verzióját.
Item[DataColumn]	Lekéri vagy beállítja a megadott DataColumnhelyen tárolt adatokat.
Item[Int32, DataRowVersion]	Lekéri az oszlopban tárolt adatokat, amelyeket az index és a lekérni kívánt adatok verziója határoz meg.
Item[Int32]	Lekéri vagy beállítja az index által megadott oszlopban tárolt adatokat.
Item[String, DataRowVersion]	Lekéri az elnevezett oszlopban tárolt adatok megadott verzióját.
Item[String]	Lekéri vagy beállítja a név alapján megadott oszlopban tárolt adatokat.
ItemArray	Lekéri vagy beállítja a sor összes értékét egy tömbön keresztül.
RowError	Lekéri vagy beállítja egy sor egyéni hibaleírását.
RowState	Lekéri a sor aktuális állapotát a .DataRowCollection
Table	Lekérdezi, DataTable hogy melyik sorhoz tartozik séma.

Metódusok

Name	Description
AcceptChanges()	Véglegesíti a sor összes módosítását a legutóbbi AcceptChanges() hívás óta.
BeginEdit()	Szerkesztési műveletet indít el egy DataRow objektumon.
CancelEdit()	Megszakítja a sor aktuális szerkesztését.
ClearErrors()	Törli a sor hibáit. Ebbe beletartoznak a RowError következővel beállított SetColumnError(Int32, String)hibák is: .
Delete()	Törli a DataRow.
EndEdit()	Véget vet a sorban végbemenő szerkesztésnek.
Equals(Object)	Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object)
GetChildRows(DataRelation, DataRowVersion)	Lekéri a gyermeksorokat a DataRow megadott DataRelation, és DataRowVersion.
GetChildRows(DataRelation)	Lekéri ennek DataRow a gyermeksorait a megadott DataRelationparanccsel.
GetChildRows(String, DataRowVersion)	Lekéri a gyermeksorokat a DataRow megadott RelationNameDataRelationés DataRowVersion.
GetChildRows(String)	Lekéri egy adott elem gyermeksorait DataRowRelationNamea megadott DataRelation paranccsel.
GetColumnError(DataColumn)	Lekéri a megadott DataColumnhiba leírását.
GetColumnError(Int32)	Lekéri az index által megadott oszlop hibaleírását.
GetColumnError(String)	Lekéri a név alapján megadott oszlop hibaleírását.
GetColumnsInError()	Olyan oszloptömböt kap, amely hibákat tartalmaz.
GetHashCode()	Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object)
GetParentRow(DataRelation, DataRowVersion)	Lekéri a szülősort DataRow a megadott DataRelation, és DataRowVersion.
GetParentRow(DataRelation)	Lekéri a szülősort DataRow a megadott DataRelationhasználatával.
GetParentRow(String, DataRowVersion)	Lekéri a szülősort a DataRow megadott RelationNameDataRelationés DataRowVersion.
GetParentRow(String)	Lekéri a szülősort a DataRow megadott RelationNameDataRelationparanccsel.
GetParentRows(DataRelation, DataRowVersion)	Lekéri a szülősorokat a DataRow megadott DataRelationés DataRowVersion.
GetParentRows(DataRelation)	Lekéri a szülősorokat a DataRow megadott DataRelation.
GetParentRows(String, DataRowVersion)	Lekéri a szülősorokat a DataRow megadott RelationNameDataRelationés DataRowVersion.
GetParentRows(String)	Lekéri a szülősorokat a DataRow megadott RelationNameDataRelationegy .
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
HasVersion(DataRowVersion)	Beolvas egy értéket, amely jelzi, hogy létezik-e egy megadott verzió.
IsNull(DataColumn, DataRowVersion)	Olyan értéket kap, amely jelzi, hogy a megadott DataColumn érték DataRowVersion null értéket tartalmaz-e.
IsNull(DataColumn)	Olyan értéket kap, amely jelzi, hogy a megadott DataColumn érték null értéket tartalmaz-e.
IsNull(Int32)	Olyan értéket kap, amely jelzi, hogy a megadott index oszlopa null értéket tartalmaz-e.
IsNull(String)	Olyan értéket kap, amely jelzi, hogy az elnevezett oszlop null értéket tartalmaz-e.
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
RejectChanges()	Elutasítja a sor utolsó hívása óta AcceptChanges() végrehajtott összes módosítást.
SetAdded()	Az a RowState változót a DataRow következőre Addedmódosítja: .
SetColumnError(DataColumn, String)	Beállítja a hibaleírást egy oszlophoz, amely a következőként DataColumnvan megadva: .
SetColumnError(Int32, String)	Beállítja az index által megadott oszlop hibaleírását.
SetColumnError(String, String)	Megadja a név alapján megadott oszlop hibaleírását.
SetModified()	Az a RowState változót a DataRow következőre Modifiedmódosítja: .
SetNull(DataColumn)	A megadott DataColumn értéket null értékre állítja.
SetParentRow(DataRow, DataRelation)	Beállítja a szülősort egy DataRow megadott új szülővel DataRow és DataRelation.
SetParentRow(DataRow)	Egy adott új szülő DataRowszülősorát állítja DataRow be.
ToString()	Az aktuális objektumot jelképező sztringet ad vissza. (Öröklődés forrása Object)

Bővítő metódusok

Name	Description
Field<T>(DataRow, DataColumn, DataRowVersion)	Erősen gépelt hozzáférést biztosít a megadott sor egyes oszlopértékeihez. A Field<T>(DataRow, DataColumn, DataRowVersion) metódus a null értékű típusokat is támogatja.
Field<T>(DataRow, DataColumn)	Erősen gépelt hozzáférést biztosít a megadott sor egyes oszlopértékeihez. A Field<T>(DataRow, DataColumn) metódus a null értékű típusokat is támogatja.
Field<T>(DataRow, Int32, DataRowVersion)	Erősen gépelt hozzáférést biztosít a megadott sor egyes oszlopértékeihez. A Field<T>(DataRow, Int32, DataRowVersion) metódus a null értékű típusokat is támogatja.
Field<T>(DataRow, Int32)	Erősen beírt hozzáférést biztosít a megadott sor egyes oszlopértékeihez. A Field<T>(DataRow, Int32) metódus a null értékű típusokat is támogatja.
Field<T>(DataRow, String, DataRowVersion)	Erősen gépelt hozzáférést biztosít a megadott sor egyes oszlopértékeihez. A Field<T>(DataRow, String, DataRowVersion) metódus a null értékű típusokat is támogatja.
Field<T>(DataRow, String)	Erősen gépelt hozzáférést biztosít a megadott sor egyes oszlopértékeihez. A Field<T>(DataRow, String) metódus a null értékű típusokat is támogatja.
SetField<T>(DataRow, DataColumn, T)	Új értéket állít be a megadott oszlophoz a DataRow. A SetField<T>(DataRow, DataColumn, T) metódus a null értékű típusokat is támogatja.
SetField<T>(DataRow, Int32, T)	Beállít egy új értéket a metódus megadott oszlopához DataRow . A SetField<T>(DataRow, Int32, T) metódus a null értékű típusokat is támogatja.
SetField<T>(DataRow, String, T)	Új értéket állít be a megadott oszlophoz a DataRow. A SetField<T>(DataRow, String, T) metódus a null értékű típusokat is támogatja.

Szálbiztonság

Ez a típus biztonságos a többszálas olvasási műveletekhez. Minden írási műveletet szinkronizálnia kell.

Lásd még

• AcceptChanges()
• Add(DataRow)
• DataColumnCollection
• DataColumn
• DataRowView
• DataTable
• HasVersion(DataRowVersion)
• IsNull(Int32)
• Item[Int32]
• NewRow()
• DataRowCollection
• Adatkészletek használata az ADO-ban.NET