DataRow Classe

Définition

Représente une ligne de données dans un DataTable.Represents a row of data in a DataTable.

public ref class DataRow
[System.Serializable]
public class DataRow
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.The following example creates a new DataRow by calling the NewRow method of the DataTable object.

   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 objets DataColumn et sont des composants principaux d' DataTableun.The DataRow and DataColumn objects are primary components of a 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 DataTablele.Use the DataRow object and its properties and methods to retrieve and evaluate; and insert, delete, and update the values in the DataTable. DataRow ReprésentelesobjetsDataTableréels DataTabledans le, et DataColumn contient les objets qui décrivent le schéma de. DataColumnCollection DataRowCollectionThe DataRowCollection represents the actual DataRow objects in the DataTable, and the DataColumnCollection contains the DataColumn objects that describe the schema of the DataTable. Utilisez la Item[String, DataRowVersion] propriété surchargée pour retourner ou définir la valeur d’un DataColumn.Use the overloaded Item[String, DataRowVersion] property to return or set the value of a DataColumn.

Utilisez les HasVersion propriétés IsNull et pour déterminer l’état d’une valeur de ligne particulière, et RowState la propriété pour déterminer l’état de la ligne par rapport à DataTableson parent.Use the HasVersion and IsNull properties to determine the status of a particular row value, and the RowState property to determine the state of the row relative to its parent DataTable.

Pour créer un nouveau DataRow, utilisez la NewRow méthode de l' DataTable objet.To create a new DataRow, use the NewRow method of the DataTable object. Après avoir créé un DataRownouveau, utilisez Add la méthode pour DataRowCollectionajouter le DataRow nouveau à.After creating a new DataRow, use the Add method to add the new DataRow to the DataRowCollection. Enfin, appelez la AcceptChanges méthode de l' DataTable objet pour confirmer l’ajout.Finally, call the AcceptChanges method of the DataTable object to confirm the addition. Pour plus d’informations sur l’ajout de DataTabledonnées à un, consultez Ajout de données à un DataTable.For more information about adding data to a DataTable, see Adding Data to a DataTable.

Vous pouvez supprimer un DataRow DataRowCollection du en Remove Delete appelant la méthode de DataRow , ou en appelant la méthode de l’objet. DataRowCollectionYou can delete a DataRow from the DataRowCollection by calling the Remove method of the DataRowCollection, or by calling the Delete method of the DataRow object. La Remove méthode supprime la ligne de la collection.The Remove method removes the row from the collection. En revanche, Delete marque le DataRow pour la suppression.In contrast, Delete marks the DataRow for removal. La suppression réelle se produit lorsque vous AcceptChanges appelez la méthode.The actual removal occurs when you call AcceptChanges method. En appelant Delete, vous pouvez vérifier par programme les lignes marquées pour suppression avant de les supprimer réellement.By calling Delete, you can programmatically check which rows are marked for removal before actually deleting them. Pour plus d’informations, consultez Suppression d’un DataRow.For more information, see DataRow Deletion.

Constructeurs

DataRow(DataRowBuilder)

Initialise une nouvelle instance de DataRow.Initializes a new instance of the DataRow. Construit une ligne à partir du générateur.Constructs a row from the builder. Uniquement pour un usage interne.Only for internal usage.

Propriétés

HasErrors

Obtient une valeur qui indique s'il existe des erreurs dans une ligne.Gets a value that indicates whether there are errors in a row.

Item[DataColumn, DataRowVersion]

Obtient la version spécifiée des données stockées dans le DataColumn spécifié.Gets the specified version of data stored in the specified DataColumn.

Item[DataColumn]

Obtient ou définit les données stockées dans le DataColumn spécifié.Gets or sets the data stored in the specified 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.Gets the data stored in the column, specified by index and version of the data to retrieve.

Item[Int32]

Obtient ou définit les données stockées dans la colonne spécifiée par l'index.Gets or sets the data stored in the column specified by index.

Item[String, DataRowVersion]

Obtient la version spécifiée des données stockées dans la colonne nommée.Gets the specified version of data stored in the named column.

Item[String]

Obtient ou définit les données stockées dans la colonne spécifiée par son nom.Gets or sets the data stored in the column specified by name.

ItemArray

Obtient ou définit toutes les valeurs de cette ligne à l'aide d'un tableau.Gets or sets all the values for this row through an array.

RowError

Obtient ou définit la description d'erreur personnalisée pour une ligne.Gets or sets the custom error description for a row.

RowState

Obtient l'état actuel de la ligne par rapport à sa relation avec DataRowCollection.Gets the current state of the row with regard to its relationship to the DataRowCollection.

Table

Obtient le DataTable pour lequel cette ligne possède un schéma.Gets the DataTable for which this row has a schema.

Méthodes

AcceptChanges()

Valide toutes les modifications apportées à cette ligne depuis le dernier appel à AcceptChanges().Commits all the changes made to this row since the last time AcceptChanges() was called.

BeginEdit()

Commence une opération de modification d'un objet DataRow.Starts an edit operation on a DataRow object.

CancelEdit()

Annule la modification de la ligne en cours.Cancels the current edit on the row.

ClearErrors()

Efface les erreurs pour la ligne.Clears the errors for the row. Cela inclut RowError et les erreurs définies avec SetColumnError(Int32, String).This includes the RowError and errors set with SetColumnError(Int32, String).

Delete()

Supprime DataRow.Deletes the DataRow.

EndEdit()

Termine la modification de la ligne en cours.Ends the edit occurring on the row.

Equals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.Determines whether the specified object is equal to the current object.

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

Obtient les lignes enfants de ce DataRow à l'aide du DataRelation spécifié.Gets the child rows of this DataRow using the specified DataRelation.

GetChildRows(DataRelation, DataRowVersion)

Obtient les lignes enfants de DataRow à l'aide du DataRelation et du DataRowVersion spécifiés.Gets the child rows of a DataRow using the specified DataRelation, and DataRowVersion.

GetChildRows(String)

Obtient les lignes enfants de DataRow à l'aide du RelationName spécifié de DataRelation.Gets the child rows of a DataRow using the specified RelationName of a DataRelation.

GetChildRows(String, DataRowVersion)

Obtient les lignes enfants de DataRow à l'aide du RelationName spécifié de DataRelation et de DataRowVersion.Gets the child rows of a DataRow using the specified RelationName of a DataRelation, and DataRowVersion.

GetColumnError(DataColumn)

Obtient la description d'erreur du DataColumn spécifié.Gets the error description of the specified DataColumn.

GetColumnError(Int32)

Obtient la description d'erreur de la colonne spécifiée par l'index.Gets the error description for the column specified by index.

GetColumnError(String)

Obtient la description d'erreur d'une colonne, spécifiée par son nom.Gets the error description for a column, specified by name.

GetColumnsInError()

Obtient un tableau de colonnes contenant des erreurs.Gets an array of columns that have errors.

GetHashCode()

Fait office de fonction de hachage par défaut.Serves as the default hash function.

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

Obtient la ligne parente de DataRow à l'aide du DataRelation spécifié.Gets the parent row of a DataRow using the specified DataRelation.

GetParentRow(DataRelation, DataRowVersion)

Obtient la ligne parente de DataRow à l'aide du DataRelation et du DataRowVersion spécifiés.Gets the parent row of a DataRow using the specified DataRelation, and DataRowVersion.

GetParentRow(String)

Obtient la ligne parente de DataRow à l'aide du RelationName spécifié de DataRelation.Gets the parent row of a DataRow using the specified RelationName of a DataRelation.

GetParentRow(String, DataRowVersion)

Obtient la ligne parente de DataRow à l'aide du RelationName spécifié de DataRelation et de DataRowVersion.Gets the parent row of a DataRow using the specified RelationName of a DataRelation, and DataRowVersion.

GetParentRows(DataRelation)

Obtient les lignes parentes de DataRow à l'aide du DataRelation spécifié.Gets the parent rows of a DataRow using the specified DataRelation.

GetParentRows(DataRelation, DataRowVersion)

Obtient les lignes parentes de DataRow à l'aide du DataRelation et du DataRowVersion spécifiés.Gets the parent rows of a DataRow using the specified DataRelation, and DataRowVersion.

GetParentRows(String)

Obtient les lignes parentes de DataRow à l'aide du RelationName spécifié de DataRelation.Gets the parent rows of a DataRow using the specified RelationName of a DataRelation.

GetParentRows(String, DataRowVersion)

Obtient les lignes parentes de DataRow à l'aide du RelationName spécifié de DataRelation et de DataRowVersion.Gets the parent rows of a DataRow using the specified RelationName of a DataRelation, and DataRowVersion.

GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

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

Obtient une valeur qui indique si une version spécifiée existe.Gets a value that indicates whether a specified version exists.

IsNull(DataColumn)

Obtient une valeur qui indique si le DataColumn spécifié contient une valeur null.Gets a value that indicates whether the specified DataColumn contains a null value.

IsNull(DataColumn, DataRowVersion)

Obtient une valeur qui indique si le DataColumn et le DataRowVersion spécifiés contiennent une valeur null.Gets a value that indicates whether the specified DataColumn and DataRowVersion contains a null value.

IsNull(Int32)

Obtient une valeur qui indique si la colonne à l'index spécifié contient une valeur null.Gets a value that indicates whether the column at the specified index contains a null value.

IsNull(String)

Obtient une valeur qui indique si la colonne nommée contient une valeur null.Gets a value that indicates whether the named column contains a null value.

MemberwiseClone()

Crée une copie superficielle de l'objet Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
RejectChanges()

Refuse toutes les modifications apportées à la ligne depuis le dernier appel à AcceptChanges().Rejects all changes made to the row since AcceptChanges() was last called.

SetAdded()

Modifie le RowState d'un DataRow en Added.Changes the RowState of a DataRow to Added.

SetColumnError(DataColumn, String)

Définit la description d'erreur d'une colonne, spécifiée en tant que DataColumn.Sets the error description for a column specified as a DataColumn.

SetColumnError(Int32, String)

Définit la description d'erreur d'une colonne spécifiée par l'index.Sets the error description for a column specified by index.

SetColumnError(String, String)

Définit la description d'erreur d'une colonne spécifiée par son nom.Sets the error description for a column specified by name.

SetModified()

Modifie le RowState d'un DataRow en Modified.Changes the RowState of a DataRow to Modified.

SetNull(DataColumn)

Affecte une valeur null au DataColumn spécifié.Sets the value of the specified DataColumn to a null value.

SetParentRow(DataRow)

Définit la ligne parente de DataRow avec le nouveau DataRow parent spécifié.Sets the parent row of a DataRow with specified new parent DataRow.

SetParentRow(DataRow, DataRelation)

Définit la ligne parente de DataRow avec les nouveaux DataRow et DataRelation parents spécifiés.Sets the parent row of a DataRow with specified new parent DataRow and DataRelation.

ToString()

Retourne une chaîne qui représente l'objet actuel.Returns a string that represents the current object.

(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.Provides strongly-typed access to each of the column values in the specified row. La méthode Field<T>(DataRow, DataColumn) prend également en charge les types Nullable.The Field<T>(DataRow, DataColumn) method also supports nullable types.

Field<T>(DataRow, DataColumn, DataRowVersion)

Fournit l'accès fortement typé à chacune des valeurs de colonne dans la ligne spécifiée.Provides strongly-typed access to each of the column values in the specified row. La méthode Field<T>(DataRow, DataColumn, DataRowVersion) prend également en charge les types Nullable.The Field<T>(DataRow, DataColumn, DataRowVersion) method also supports nullable types.

Field<T>(DataRow, Int32)

Fournit l'accès fortement typé à chacune des valeurs de colonne dans la ligne spécifiée.Provides strongly-typed access to each of the column values in the specified row. La méthode Field<T>(DataRow, Int32) prend également en charge les types Nullable.The Field<T>(DataRow, Int32) method also supports nullable types.

Field<T>(DataRow, Int32, DataRowVersion)

Fournit l'accès fortement typé à chacune des valeurs de colonne dans la ligne spécifiée.Provides strongly-typed access to each of the column values in the specified row. La méthode Field<T>(DataRow, Int32, DataRowVersion) prend également en charge les types Nullable.The Field<T>(DataRow, Int32, DataRowVersion) method also supports nullable types.

Field<T>(DataRow, String)

Fournit l'accès fortement typé à chacune des valeurs de colonne dans la ligne spécifiée.Provides strongly-typed access to each of the column values in the specified row. La méthode Field<T>(DataRow, String) prend également en charge les types Nullable.The Field<T>(DataRow, String) method also supports nullable types.

Field<T>(DataRow, String, DataRowVersion)

Fournit l'accès fortement typé à chacune des valeurs de colonne dans la ligne spécifiée.Provides strongly-typed access to each of the column values in the specified row. La méthode Field<T>(DataRow, String, DataRowVersion) prend également en charge les types Nullable.The Field<T>(DataRow, String, DataRowVersion) method also supports nullable types.

SetField<T>(DataRow, DataColumn, T)

Définit une nouvelle valeur pour la colonne spécifiée dans la DataRow.Sets a new value for the specified column in the DataRow. La méthode SetField<T>(DataRow, DataColumn, T) prend également en charge les types Nullable.The SetField<T>(DataRow, DataColumn, T) method also supports nullable types.

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.Sets a new value for the specified column in the DataRow the method is called on. La méthode SetField<T>(DataRow, Int32, T) prend également en charge les types Nullable.The SetField<T>(DataRow, Int32, T) method also supports nullable types.

SetField<T>(DataRow, String, T)

Définit une nouvelle valeur pour la colonne spécifiée dans la DataRow.Sets a new value for the specified column in the DataRow. La méthode SetField<T>(DataRow, String, T) prend également en charge les types Nullable.The SetField<T>(DataRow, String, T) method also supports nullable types.

S’applique à

Cohérence de thread

Ce type est sécurisé pour les opérations de lecture multithread.This type is safe for multithreaded read operations. Vous devez synchroniser toutes les opérations d’écriture.You must synchronize any write operations.

Voir aussi