DataRow, classe (System.Data)

Changer de vue:
ScriptFree
Bibliothèque de classes .NET Framework
DataRow, classe
Cet article a fait l'objet d'une traduction manuelle. Pour afficher simultanément cette page et le contenu source en anglais, choisissez le paramètre d'affichage Basse densité.

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

Hiérarchie d'héritage

System.Object
  System.Data.DataRow

Espace de noms :  System.Data
Assembly :  System.Data (dans System.Data.dll)
Syntaxe

Visual Basic
Public Class DataRow
C#
public class DataRow
VisualC++
public ref class DataRow
F#
type DataRow =  class end

Le type DataRow expose les membres suivants.

Constructeurs

  Nom Description
Méthode protégée Pris en charge par XNA Framework DataRow Infrastructure. Initialise une nouvelle instance de DataRow. Construit une ligne à partir du générateur. Uniquement pour un usage interne.
Début
Propriétés

  Nom Description
Propriété publique Pris en charge par XNA Framework HasErrors Obtient une valeur qui indique s'il existe des erreurs dans une ligne.
Propriété publique Pris en charge par XNA Framework Item[DataColumn] Obtient ou définit les données stockées dans le DataColumn spécifié.
Propriété publique Pris en charge par XNA Framework Item[Int32] Obtient ou définit les données stockées dans la colonne spécifiée par l'index.
Propriété publique Pris en charge par XNA Framework Item[String] Obtient ou définit les données stockées dans la colonne spécifiée par son nom.
Propriété publique Pris en charge par XNA Framework Item[DataColumn, DataRowVersion] Obtient la version spécifiée des données stockées dans le DataColumn spécifié.
Propriété publique Pris en charge par XNA Framework 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.
Propriété publique Pris en charge par XNA Framework Item[String, DataRowVersion] Obtient la version spécifiée des données stockées dans la colonne nommée.
Propriété publique Pris en charge par XNA Framework ItemArray Obtient ou définit toutes les valeurs de cette ligne à l'aide d'un tableau.
Propriété publique Pris en charge par XNA Framework RowError Obtient ou définit la description d'erreur personnalisée pour une ligne.
Propriété publique Pris en charge par XNA Framework RowState Obtient l'état actuel de la ligne par rapport à sa relation avec DataRowCollection.
Propriété publique Pris en charge par XNA Framework Table Obtient le DataTable pour lequel cette ligne possède un schéma.
Début
Méthodes

  Nom Description
Méthode publique Pris en charge par XNA Framework AcceptChanges Valide toutes les modifications apportées à cette ligne depuis le dernier appel à AcceptChanges.
Méthode publique Pris en charge par XNA Framework BeginEdit Commence une opération de modification d'un objet DataRow.
Méthode publique Pris en charge par XNA Framework CancelEdit Annule la modification de la ligne en cours.
Méthode publique Pris en charge par XNA Framework ClearErrors Efface les erreurs pour la ligne. Cela inclut RowError et les erreurs définies avec SetColumnError.
Méthode publique Pris en charge par XNA Framework Delete Supprime DataRow.
Méthode publique Pris en charge par XNA Framework EndEdit Termine la modification de la ligne en cours.
Méthode publique Pris en charge par XNA Framework Equals(Object) Détermine si l'Object spécifié est égal à l'Object en cours. (Hérité de Object.)
Méthode protégée Pris en charge par XNA Framework Finalize Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de netto***ge avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)
Méthode publique Pris en charge par XNA Framework GetChildRows(DataRelation) Obtient les lignes enfants de ce DataRow à l'aide du DataRelation spécifié.
Méthode publique Pris en charge par XNA Framework GetChildRows(String) Obtient les lignes enfants de DataRow à l'aide du RelationName spécifié de DataRelation.
Méthode publique Pris en charge par XNA Framework GetChildRows(DataRelation, DataRowVersion) Obtient les lignes enfants de DataRow à l'aide du DataRelation et du DataRowVersion spécifiés.
Méthode publique Pris en charge par XNA Framework GetChildRows(String, DataRowVersion) Obtient les lignes enfants de DataRow à l'aide du RelationName spécifié de DataRelation et de DataRowVersion.
Méthode publique Pris en charge par XNA Framework GetColumnError(DataColumn) Obtient la description d'erreur du DataColumn spécifié.
Méthode publique Pris en charge par XNA Framework GetColumnError(Int32) Obtient la description d'erreur de la colonne spécifiée par l'index.
Méthode publique Pris en charge par XNA Framework GetColumnError(String) Obtient la description d'erreur d'une colonne, spécifiée par son nom.
Méthode publique Pris en charge par XNA Framework GetColumnsInError Obtient un tableau de colonnes contenant des erreurs.
Méthode publique Pris en charge par XNA Framework GetHashCode Sert de fonction de hachage pour un type particulier. (Hérité de Object.)
Méthode publique Pris en charge par XNA Framework GetParentRow(DataRelation) Obtient la ligne parente de DataRow à l'aide du DataRelation spécifié.
Méthode publique Pris en charge par XNA Framework GetParentRow(String) Obtient la ligne parente de DataRow à l'aide du RelationName spécifié de DataRelation.
Méthode publique Pris en charge par XNA Framework GetParentRow(DataRelation, DataRowVersion) Obtient la ligne parente de DataRow à l'aide du DataRelation et du DataRowVersion spécifiés.
Méthode publique Pris en charge par XNA Framework GetParentRow(String, DataRowVersion) Obtient la ligne parente de DataRow à l'aide du RelationName spécifié de DataRelation et de DataRowVersion.
Méthode publique Pris en charge par XNA Framework GetParentRows(DataRelation) Obtient les lignes parentes de DataRow à l'aide du DataRelation spécifié.
Méthode publique Pris en charge par XNA Framework GetParentRows(String) Obtient les lignes parentes de DataRow à l'aide du RelationName spécifié de DataRelation.
Méthode publique Pris en charge par XNA Framework GetParentRows(DataRelation, DataRowVersion) Obtient les lignes parentes de DataRow à l'aide du DataRelation et du DataRowVersion spécifiés.
Méthode publique Pris en charge par XNA Framework GetParentRows(String, DataRowVersion) Obtient les lignes parentes de DataRow à l'aide du RelationName spécifié de DataRelation et de DataRowVersion.
Méthode publique Pris en charge par XNA Framework GetType Obtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode publique Pris en charge par XNA Framework HasVersion Obtient une valeur qui indique si une version spécifiée existe.
Méthode publique Pris en charge par XNA Framework IsNull(DataColumn) Obtient une valeur qui indique si le DataColumn spécifié contient une valeur null.
Méthode publique Pris en charge par XNA Framework IsNull(Int32) Obtient une valeur qui indique si la colonne à l'index spécifié contient une valeur null.
Méthode publique Pris en charge par XNA Framework IsNull(String) Obtient une valeur qui indique si la colonne nommée contient une valeur null.
Méthode publique Pris en charge par XNA Framework IsNull(DataColumn, DataRowVersion) Obtient une valeur qui indique si le DataColumn et le DataRowVersion spécifiés contiennent une valeur null.
Méthode protégée Pris en charge par XNA Framework MemberwiseClone Crée une copie superficielle de l'objet Object actif. (Hérité de Object.)
Méthode publique Pris en charge par XNA Framework RejectChanges Refuse toutes les modifications apportées à la ligne depuis le dernier appel à AcceptChanges.
Méthode publique Pris en charge par XNA Framework SetAdded Modifie le Rowstate() d'un DataRow en Added.
Méthode publique Pris en charge par XNA Framework SetColumnError(DataColumn, String) Définit la description d'erreur d'une colonne, spécifiée en tant que DataColumn.
Méthode publique Pris en charge par XNA Framework SetColumnError(Int32, String) Définit la description d'erreur d'une colonne spécifiée par l'index.
Méthode publique Pris en charge par XNA Framework SetColumnError(String, String) Définit la description d'erreur d'une colonne spécifiée par son nom.
Méthode publique Pris en charge par XNA Framework SetModified Modifie le Rowstate() d'un DataRow en Modified.
Méthode protégée Pris en charge par XNA Framework SetNull Affecte une valeur null au DataColumn spécifié.
Méthode publique Pris en charge par XNA Framework SetParentRow(DataRow) Définit la ligne parente de DataRow avec le nouveau DataRow parent spécifié.
Méthode publique Pris en charge par XNA Framework SetParentRow(DataRow, DataRelation) Définit la ligne parente de DataRow avec les nouveaux DataRow et DataRelation parents spécifiés.
Méthode publique Pris en charge par XNA Framework ToString Retourne une chaîne qui représente l'objet actuel. (Hérité de Object.)
Début
Méthodes d'extension

  Nom Description
Méthode d'extension publique Field<T>(DataColumn) Surchargé. Fournit l'accès fortement typé à chacune des valeurs de colonne dans la ligne spécifiée. La méthode Field prend également en charge les types Nullable. (Défini par DataRowExtensions.)
Méthode d'extension publique Field<T>(Int32) Surchargé. Fournit l'accès fortement typé à chacune des valeurs de colonne dans la ligne spécifiée. La méthode Field prend également en charge les types Nullable. (Défini par DataRowExtensions.)
Méthode d'extension publique Field<T>(String) Surchargé. Fournit l'accès fortement typé à chacune des valeurs de colonne dans la ligne spécifiée. La méthode Field prend également en charge les types Nullable. (Défini par DataRowExtensions.)
Méthode d'extension publique Field<T>(DataColumn, DataRowVersion) Surchargé. Fournit l'accès fortement typé à chacune des valeurs de colonne dans la ligne spécifiée. La méthode Field prend également en charge les types Nullable. (Défini par DataRowExtensions.)
Méthode d'extension publique Field<T>(Int32, DataRowVersion) Surchargé. Fournit l'accès fortement typé à chacune des valeurs de colonne dans la ligne spécifiée. La méthode Field prend également en charge les types Nullable. (Défini par DataRowExtensions.)
Méthode d'extension publique Field<T>(String, DataRowVersion) Surchargé. Fournit l'accès fortement typé à chacune des valeurs de colonne dans la ligne spécifiée. La méthode Field prend également en charge les types Nullable. (Défini par DataRowExtensions.)
Méthode d'extension publique SetField<T>(DataColumn, T) Surchargé. Définit une nouvelle valeur pour la colonne spécifiée dans la DataRow. La méthode SetField prend également en charge les types Nullable. (Défini par DataRowExtensions.)
Méthode d'extension publique SetField<T>(Int32, T) Surchargé. 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 prend également en charge les types Nullable. (Défini par DataRowExtensions.)
Méthode d'extension publique SetField<T>(String, T) Surchargé. Définit une nouvelle valeur pour la colonne spécifiée dans la DataRow. La méthode SetField prend également en charge les types Nullable. (Défini par DataRowExtensions.)
Début
Notes

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

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

Pour créer un nouveau DataRow, utilisez la méthode NewRow de l'objet DataTable. Lorsque vous avez créé un nouveau DataRow, utilisez la méthode Add pour ajouter le nouveau DataRow à DataRowCollection. Pour terminer, appelez la méthode AcceptChanges de l'objet DataTable pour confirmer l'ajout. Pour plus d'informations sur l'ajout de données à DataTable, consultez Ajout de données à un objet DataTable.

Vous pouvez supprimer DataRow de DataRowCollection en appelant la méthode Remove de DataRowCollection ou la méthode Delete de l'objet DataRow. La méthode Remove supprime la ligne de la collection. Par contre, Delete marque DataRow en vue de sa suppression. La suppression se produit effectivement lorsque vous appelez la méthode AcceptChanges. En appelant Delete, vous pouvez vérifier par programme les lignes qui sont marquées en vue de leur suppression avant de les supprimer réellement. Pour plus d'informations, consultez Suppresion d'un objet DataRow.

Exemples

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

Visual Basic

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 DataTable = new DataTable("Names") 

    ' Add three column objects to the table.
    Dim idColumn As DataColumn = new  DataColumn()
    idColumn.DataType = System.Type.GetType("System.Int32")
    idColumn.ColumnName = "id"
    idColumn.AutoIncrement = True
    namesTable.Columns.Add(idColumn)

    Dim fNameColumn As DataColumn = New DataColumn()
    fNameColumn.DataType = System.Type.GetType("System.String")
    fNameColumn.ColumnName = "Fname"
    fNameColumn.DefaultValue = "Fname"
    namesTable.Columns.Add(fNameColumn)

    Dim lNameColumn As DataColumn = 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


C#

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;
}


Informations de version

.NET Framework

Pris en charge dans : 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1
Plateformes

Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows XP SP2 Édition x64, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.
Sécurité des threads

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

Voir aussi

Référence

Add

Autres ressources