DataRow Classe

Définition

Représente une ligne de données dans un DataTable.

public ref class DataRow
public class DataRow
[System.Serializable]
public class DataRow
type DataRow = class
[<System.Serializable>]
type DataRow = class
Public Class DataRow
Héritage
DataRow
Attributs

Exemples

L’exemple suivant crée un nouveau DataRow en appelant la NewRow méthode de l' DataTable objet.

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

Remarques

Les DataRow DataColumn objets et sont des composants principaux d’un DataTable . Utilisez l' DataRow objet et ses propriétés et méthodes pour récupérer et évaluer ; et insérer, supprimer et mettre à jour les valeurs dans le DataTable . DataRowCollectionReprésente les objets réels DataRow dans le DataTable , et DataColumnCollection contient les DataColumn objets qui décrivent le schéma de DataTable . Utilisez la propriété surchargée Item[] pour retourner ou définir la valeur d’un DataColumn .

Utilisez les HasVersion IsNull Propriétés et pour déterminer l’état d’une valeur de ligne particulière, et la RowState propriété pour déterminer l’état de la ligne par rapport à son parent DataTable .

Pour créer un nouveau DataRow , utilisez la NewRow méthode de l' DataTable objet. Après avoir créé un nouveau DataRow , utilisez la Add méthode pour ajouter le nouveau DataRow à DataRowCollection . Enfin, appelez la AcceptChanges méthode de l' DataTable objet pour confirmer l’ajout. Pour plus d’informations sur l’ajout de données à un DataTable , consultez Ajout de données à un DataTable.

Vous pouvez supprimer un DataRow du DataRowCollection en appelant la Remove méthode de DataRowCollection , ou en appelant la Delete méthode de l' DataRow objet. La Remove méthode supprime la ligne de la collection. En revanche, Delete marque le DataRow pour la suppression. La suppression réelle se produit lorsque vous appelez la AcceptChanges méthode. En appelant Delete , vous pouvez vérifier par programme les lignes marquées pour suppression avant de les supprimer réellement. Pour plus d’informations, consultez Suppression d’un DataRow.

Constructeurs

DataRow(DataRowBuilder)

Initialise une nouvelle instance de la classe DataRow à l’aide du générateur spécifié. Uniquement pour un usage interne.

Propriétés

HasErrors

Obtient une valeur qui indique s'il existe des erreurs dans une ligne.

Item[DataColumn, DataRowVersion]

Obtient la version spécifiée des données stockées dans le DataColumn spécifié.

Item[DataColumn]

Obtient ou définit les données stockées dans le DataColumn spécifié.

Item[Int32, DataRowVersion]

Obtient les données stockées dans la colonne, spécifiées par l'index et la version des données à récupérer.

Item[Int32]

Obtient ou définit les données stockées dans la colonne spécifiée par l'index.

Item[String, DataRowVersion]

Obtient la version spécifiée des données stockées dans la colonne nommée.

Item[String]

Obtient ou définit les données stockées dans la colonne spécifiée par son nom.

ItemArray

Obtient ou définit toutes les valeurs de cette ligne à l'aide d'un tableau.

RowError

Obtient ou définit la description d'erreur personnalisée pour une ligne.

RowState

Obtient l'état actuel de la ligne par rapport à sa relation avec DataRowCollection.

Table

Obtient le DataTable pour lequel cette ligne possède un schéma.

Méthodes

AcceptChanges()

Valide toutes les modifications apportées à cette ligne depuis le dernier appel à AcceptChanges().

BeginEdit()

Commence une opération de modification d'un objet DataRow.

CancelEdit()

Annule la modification de la ligne en cours.

ClearErrors()

Efface les erreurs pour la ligne. Cela inclut RowError et les erreurs définies avec SetColumnError(Int32, String).

Delete()

Supprime DataRow.

EndEdit()

Termine la modification de la ligne en cours.

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.

(Hérité de Object)
GetChildRows(DataRelation)

Obtient les lignes enfants de ce DataRow à l'aide du DataRelation spécifié.

GetChildRows(DataRelation, DataRowVersion)

Obtient les lignes enfants de DataRow à l'aide du DataRelation et du DataRowVersion spécifiés.

GetChildRows(String)

Obtient les lignes enfants de DataRow à l'aide du RelationName spécifié de DataRelation.

GetChildRows(String, DataRowVersion)

Obtient les lignes enfants de DataRow à l'aide du RelationName spécifié de DataRelation et de DataRowVersion.

GetColumnError(DataColumn)

Obtient la description d'erreur du DataColumn spécifié.

GetColumnError(Int32)

Obtient la description d'erreur de la colonne spécifiée par l'index.

GetColumnError(String)

Obtient la description d'erreur d'une colonne, spécifiée par son nom.

GetColumnsInError()

Obtient un tableau de colonnes contenant des erreurs.

GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetParentRow(DataRelation)

Obtient la ligne parente de DataRow à l'aide du DataRelation spécifié.

GetParentRow(DataRelation, DataRowVersion)

Obtient la ligne parente de DataRow à l'aide du DataRelation et du DataRowVersion spécifiés.

GetParentRow(String)

Obtient la ligne parente de DataRow à l'aide du RelationName spécifié de DataRelation.

GetParentRow(String, DataRowVersion)

Obtient la ligne parente de DataRow à l'aide du RelationName spécifié de DataRelation et de DataRowVersion.

GetParentRows(DataRelation)

Obtient les lignes parentes de DataRow à l'aide du DataRelation spécifié.

GetParentRows(DataRelation, DataRowVersion)

Obtient les lignes parentes de DataRow à l'aide du DataRelation et du DataRowVersion spécifiés.

GetParentRows(String)

Obtient les lignes parentes de DataRow à l'aide du RelationName spécifié de DataRelation.

GetParentRows(String, DataRowVersion)

Obtient les lignes parentes de DataRow à l'aide du RelationName spécifié de DataRelation et de DataRowVersion.

GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
HasVersion(DataRowVersion)

Obtient une valeur qui indique si une version spécifiée existe.

IsNull(DataColumn)

Obtient une valeur qui indique si le DataColumn spécifié contient une valeur null.

IsNull(DataColumn, DataRowVersion)

Obtient une valeur qui indique si le DataColumn et le DataRowVersion spécifiés contiennent une valeur null.

IsNull(Int32)

Obtient une valeur qui indique si la colonne à l'index spécifié contient une valeur null.

IsNull(String)

Obtient une valeur qui indique si la colonne nommée contient une valeur null.

MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
RejectChanges()

Refuse toutes les modifications apportées à la ligne depuis le dernier appel à AcceptChanges().

SetAdded()

Modifie le RowState d'un DataRow en Added.

SetColumnError(DataColumn, String)

Définit la description d'erreur d'une colonne, spécifiée en tant que DataColumn.

SetColumnError(Int32, String)

Définit la description d'erreur d'une colonne spécifiée par l'index.

SetColumnError(String, String)

Définit la description d'erreur d'une colonne spécifiée par son nom.

SetModified()

Modifie le RowState d'un DataRow en Modified.

SetNull(DataColumn)

Affecte une valeur null au DataColumn spécifié.

SetParentRow(DataRow)

Définit la ligne parente de DataRow avec le nouveau DataRow parent spécifié.

SetParentRow(DataRow, DataRelation)

Définit la ligne parente de DataRow avec les nouveaux DataRow et DataRelation parents spécifiés.

ToString()

Retourne une chaîne qui représente l'objet actuel.

(Hérité de Object)

Méthodes d’extension

Field<T>(DataRow, DataColumn)

Fournit l'accès fortement typé à chacune des valeurs de colonne dans la ligne spécifiée. La méthode Field<T>(DataRow, DataColumn) prend également en charge les types Nullable.

Field<T>(DataRow, DataColumn, DataRowVersion)

Fournit l'accès fortement typé à chacune des valeurs de colonne dans la ligne spécifiée. La méthode Field<T>(DataRow, DataColumn, DataRowVersion) prend également en charge les types Nullable.

Field<T>(DataRow, Int32)

Fournit l'accès fortement typé à chacune des valeurs de colonne dans la ligne spécifiée. La méthode Field<T>(DataRow, Int32) prend également en charge les types Nullable.

Field<T>(DataRow, Int32, DataRowVersion)

Fournit l'accès fortement typé à chacune des valeurs de colonne dans la ligne spécifiée. La méthode Field<T>(DataRow, Int32, DataRowVersion) prend également en charge les types Nullable.

Field<T>(DataRow, String)

Fournit l'accès fortement typé à chacune des valeurs de colonne dans la ligne spécifiée. La méthode Field<T>(DataRow, String) prend également en charge les types Nullable.

Field<T>(DataRow, String, DataRowVersion)

Fournit l'accès fortement typé à chacune des valeurs de colonne dans la ligne spécifiée. La méthode Field<T>(DataRow, String, DataRowVersion) prend également en charge les types Nullable.

SetField<T>(DataRow, DataColumn, T)

Définit une nouvelle valeur pour la colonne spécifiée dans la DataRow. La méthode SetField<T>(DataRow, DataColumn, T) prend également en charge les types Nullable.

SetField<T>(DataRow, Int32, T)

Définit une nouvelle valeur pour la colonne spécifiée dans la DataRow sur laquelle la méthode est appelée. La méthode SetField<T>(DataRow, Int32, T) prend également en charge les types Nullable.

SetField<T>(DataRow, String, T)

Définit une nouvelle valeur pour la colonne spécifiée dans la DataRow. La méthode SetField<T>(DataRow, String, T) prend également en charge les types Nullable.

S’applique à

Cohérence de thread

Ce type est sécurisé pour les opérations de lecture multithread. Vous devez synchroniser toutes les opérations d’écriture.

Voir aussi