DataRow Classe

Définition

Espace de noms:: System.Data

Assembly:: System.Data.dll

Assembly:: netstandard.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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

public ref class DataRow

[System.Serializable]
public class DataRow

public class DataRow

[<System.Serializable>]
type DataRow = class

type DataRow = class

Public Class DataRow

Héritage: Object
DataRow

Attributs: SerializableAttribute

Exemples

L’exemple suivant crée un nouveau DataRow en appelant la NewRow méthode de l’objet 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

Remarques

Les objets et DataColumn les DataRow objets sont des composants principaux d’un DataTable. Utilisez l’objet DataRow 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. Représente DataRowCollection les objets réels DataRow dans le DataTable, et contient DataColumnCollection les DataColumn objets qui décrivent le schéma du DataTable. Utilisez la propriété surchargée Item[] pour renvoyer ou définir la valeur d’un DataColumn.

Utilisez les propriétés et les HasVersion propriétés 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 parentDataTable.IsNull

Pour créer un DataRowobjet, utilisez la NewRow méthode de l’objet DataTable . Après avoir créé un DataRownouveau, utilisez la Add méthode pour ajouter le nouveau DataRow au DataRowCollection. Enfin, appelez la AcceptChanges méthode de l’objet DataTable 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 de l’objet DataRowCollection en appelant la Remove méthode du DataRowCollection, ou en appelant la Delete méthode de l’objet DataRow . La Remove méthode supprime la ligne de la collection. En revanche, Delete marque la DataRow suppression. La suppression réelle se produit lorsque vous appelez AcceptChanges la méthode. En appelant Delete, vous pouvez vérifier par programmation quelles lignes sont marquées pour suppression avant de les supprimer. Pour plus d’informations, consultez Suppression de DataRow.

Constructeurs

Nom	Description
DataRow(DataRowBuilder)	Initialise une nouvelle instance de la classe DataRow à l’aide du générateur spécifié. Uniquement pour l’utilisation interne.

Propriétés

Nom	Description
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 fichier spécifié DataColumn.
Item[DataColumn]	Obtient ou définit les données stockées dans le fichier spécifié DataColumn.
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 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 nom.
ItemArray	Obtient ou définit toutes les valeurs de cette ligne via un tableau.
RowError	Obtient ou définit la description d’erreur personnalisée d’une ligne.
RowState	Obtient l’état actuel de la ligne en ce qui concerne sa relation avec le DataRowCollection.
Table	Obtient la DataTable valeur pour laquelle cette ligne a un schéma.

Méthodes

Nom	Description
AcceptChanges()	Valide toutes les modifications apportées à cette ligne depuis l’appel de la dernière fois AcceptChanges() .
BeginEdit()	Démarre une opération de modification sur un DataRow objet.
CancelEdit()	Annule la modification actuelle sur la ligne.
ClearErrors()	Efface les erreurs de la ligne. Cela inclut les RowError erreurs définies avec SetColumnError(Int32, String).
Delete()	Supprime le DataRow.
EndEdit()	Termine la modification sur la ligne.
Equals(Object)	Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object)
GetChildRows(DataRelation, DataRowVersion)	Obtient les lignes enfants d’un DataRow utilisateur à l’aide des éléments spécifiés DataRelationet DataRowVersion.
GetChildRows(DataRelation)	Obtient les lignes enfants de ceci DataRow à l’aide de l’objet spécifié DataRelation.
GetChildRows(String, DataRowVersion)	Obtient les lignes enfants d’un DataRow à l’aide de l’élément spécifié RelationName d’un DataRelation, et DataRowVersion.
GetChildRows(String)	Obtient les lignes enfants d’un DataRow à l’aide de l’élément spécifié RelationName d’un DataRelation.
GetColumnError(DataColumn)	Obtient la description de l’erreur spécifiée DataColumn.
GetColumnError(Int32)	Obtient la description d’erreur de la colonne spécifiée par index.
GetColumnError(String)	Obtient la description d’erreur d’une colonne, spécifiée par nom.
GetColumnsInError()	Obtient un tableau de colonnes qui ont des erreurs.
GetHashCode()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetParentRow(DataRelation, DataRowVersion)	Obtient la ligne parente d’un DataRow à l’aide de l’élément spécifié DataRelationet DataRowVersion.
GetParentRow(DataRelation)	Obtient la ligne parente d’un DataRow à l’aide de l’objet spécifié DataRelation.
GetParentRow(String, DataRowVersion)	Obtient la ligne parente d’un DataRow à l’aide de l’élément spécifié RelationName d’un DataRelation, et DataRowVersion.
GetParentRow(String)	Obtient la ligne parente d’un DataRow à l’aide de la valeur spécifiée RelationName d’un DataRelation.
GetParentRows(DataRelation, DataRowVersion)	Obtient les lignes parentes d’un DataRow à l’aide des éléments spécifiés DataRelationet DataRowVersion.
GetParentRows(DataRelation)	Obtient les lignes parentes d’une DataRow utilisation de l’objet spécifié DataRelation.
GetParentRows(String, DataRowVersion)	Obtient les lignes parentes d’un DataRow à l’aide du paramètre spécifié RelationName d’un DataRelation, et DataRowVersion.
GetParentRows(String)	Obtient les lignes parentes d’un DataRow à l’aide de la valeur spécifiée RelationName d’un DataRelation.
GetType()	Obtient la 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, DataRowVersion)	Obtient une valeur qui indique si la valeur spécifiée DataColumn et DataRowVersion contient une valeur Null.
IsNull(DataColumn)	Obtient une valeur qui indique si le spécifié DataColumn contient 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 Objectactuel. (Hérité de Object)
RejectChanges()	Rejette toutes les modifications apportées à la ligne depuis AcceptChanges() son dernier appel.
SetAdded()	Modifie la RowState valeur d’un DataRow .`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 index.
SetColumnError(String, String)	Définit la description d’erreur d’une colonne spécifiée par nom.
SetModified()	Modifie la RowState valeur d’un DataRow .`Modified`
SetNull(DataColumn)	Définit la valeur du paramètre spécifié DataColumn sur une valeur Null.
SetParentRow(DataRow, DataRelation)	Définit la ligne parente d’un DataRow nouveau parent DataRow spécifié et DataRelation.
SetParentRow(DataRow)	Définit la ligne parente d’un DataRow nouveau parent DataRowspécifié.
ToString()	Retourne une chaîne qui représente l’objet actuel. (Hérité de Object)

Méthodes d’extension

Nom	Description
Field<T>(DataRow, DataColumn, DataRowVersion)	Fournit un accès fortement typé à chacune des valeurs de colonne de la ligne spécifiée. La Field<T>(DataRow, DataColumn, DataRowVersion) méthode prend également en charge les types nullables.
Field<T>(DataRow, DataColumn)	Fournit un accès fortement typé à chacune des valeurs de colonne de la ligne spécifiée. La Field<T>(DataRow, DataColumn) méthode prend également en charge les types nullables.
Field<T>(DataRow, Int32, DataRowVersion)	Fournit un accès fortement typé à chacune des valeurs de colonne de la ligne spécifiée. La Field<T>(DataRow, Int32, DataRowVersion) méthode prend également en charge les types nullables.
Field<T>(DataRow, Int32)	Fournit un accès fortement typé à chacune des valeurs de colonne dans la ligne spécifiée. La Field<T>(DataRow, Int32) méthode prend également en charge les types nullables.
Field<T>(DataRow, String, DataRowVersion)	Fournit un accès fortement typé à chacune des valeurs de colonne de la ligne spécifiée. La Field<T>(DataRow, String, DataRowVersion) méthode prend également en charge les types nullables.
Field<T>(DataRow, String)	Fournit un accès fortement typé à chacune des valeurs de colonne de la ligne spécifiée. La Field<T>(DataRow, String) méthode prend également en charge les types nullables.
SetField<T>(DataRow, DataColumn, T)	Définit une nouvelle valeur pour la colonne spécifiée dans le DataRow. La SetField<T>(DataRow, DataColumn, T) méthode prend également en charge les types nullables.
SetField<T>(DataRow, Int32, T)	Définit une nouvelle valeur pour la colonne spécifiée dans la DataRow méthode est appelée. La SetField<T>(DataRow, Int32, T) méthode prend également en charge les types nullables.
SetField<T>(DataRow, String, T)	Définit une nouvelle valeur pour la colonne spécifiée dans le DataRow. La SetField<T>(DataRow, String, T) méthode prend également en charge les types nullables.

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

Commentaires

Cette page a-t-elle été utile ?