DataRow DataRow DataRow DataRow Class

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
DataRowDataRowDataRowDataRow
Attributs

Exemples

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

Remarques

Le DataRow et DataColumn objets sont les principaux composants d’un DataTable.The DataRow and DataColumn objects are primary components of a DataTable. Utilisez le DataRow objet et de ses propriétés et méthodes pour récupérer et évaluer ; insérer, supprimer et mettre à jour les valeurs dans le DataTable.Use the DataRow object and its properties and methods to retrieve and evaluate; and insert, delete, and update the values in the DataTable. Le DataRowCollection représente le texte réel DataRow des objets dans le DataTableet le DataColumnCollection contient le DataColumn objets qui décrivent le schéma de la DataTable.The DataRowCollection represents the actual DataRow objects in the DataTable, and the DataColumnCollection contains the DataColumn objects that describe the schema of the DataTable. Utilisez surchargées Item[String, DataRowVersion] à renvoyer ou définir la valeur de propriété un DataColumn.Use the overloaded Item[String, DataRowVersion] property to return or set the value of a DataColumn.

Utilisez le HasVersion et IsNull propriétés pour déterminer l’état d’une valeur de ligne particulière et le RowState propriété afin de déterminer l’état de la ligne par rapport à son parent DataTable.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 le NewRow méthode de la DataTable objet.To create a new DataRow, use the NewRow method of the DataTable object. Après avoir créé un nouveau DataRow, utilisez le Add méthode pour ajouter la nouvelle DataRow à la DataRowCollection.After creating a new DataRow, use the Add method to add the new DataRow to the DataRowCollection. Enfin, appelez le AcceptChanges méthode de la 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 données à un DataTable, 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 à partir de la DataRowCollection en appelant le Remove méthode de la DataRowCollection, ou en appelant le Delete méthode de la DataRow objet.You 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. Le Remove méthode supprime la ligne de la collection.The Remove method removes the row from the collection. En revanche, Delete marques le DataRow pour la suppression.In contrast, Delete marks the DataRow for removal. La suppression réelle se produit lorsque vous appelez AcceptChanges (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 de DataRow.For more information, see DataRow Deletion.

Constructeurs

DataRow(DataRowBuilder) DataRow(DataRowBuilder) DataRow(DataRowBuilder) 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 HasErrors HasErrors 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.

ItemArray ItemArray ItemArray 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.

Item[DataColumn, DataRowVersion] Item[DataColumn, DataRowVersion] Item[DataColumn, DataRowVersion] 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] Item[DataColumn] Item[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] Item[Int32, DataRowVersion] Item[Int32, DataRowVersion] 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] Item[Int32] Item[Int32] 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] Item[String, DataRowVersion] Item[String, DataRowVersion] 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] Item[String] Item[String] 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.

RowError RowError RowError 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 RowState RowState 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 Table Table 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() AcceptChanges() AcceptChanges() 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() BeginEdit() BeginEdit() BeginEdit()

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

CancelEdit() CancelEdit() CancelEdit() CancelEdit()

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

ClearErrors() ClearErrors() ClearErrors() 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() Delete() Delete() Delete()

Supprime DataRow.Deletes the DataRow.

EndEdit() EndEdit() EndEdit() EndEdit()

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

Equals(Object) Equals(Object) Equals(Object) 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.

(Inherited from Object)
GetChildRows(DataRelation) GetChildRows(DataRelation) GetChildRows(DataRelation) 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) GetChildRows(DataRelation, DataRowVersion) GetChildRows(DataRelation, DataRowVersion) 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) GetChildRows(String) GetChildRows(String) 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) GetChildRows(String, DataRowVersion) GetChildRows(String, DataRowVersion) 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) GetColumnError(DataColumn) GetColumnError(DataColumn) GetColumnError(DataColumn)

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

GetColumnError(Int32) GetColumnError(Int32) GetColumnError(Int32) 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) GetColumnError(String) GetColumnError(String) 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() GetColumnsInError() GetColumnsInError() GetColumnsInError()

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

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

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

(Inherited from Object)
GetParentRow(DataRelation) GetParentRow(DataRelation) GetParentRow(DataRelation) 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) GetParentRow(DataRelation, DataRowVersion) GetParentRow(DataRelation, DataRowVersion) 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) GetParentRow(String) GetParentRow(String) 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) GetParentRow(String, DataRowVersion) GetParentRow(String, DataRowVersion) 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) GetParentRows(DataRelation) GetParentRows(DataRelation) 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) GetParentRows(DataRelation, DataRowVersion) GetParentRows(DataRelation, DataRowVersion) 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) GetParentRows(String) GetParentRows(String) 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) GetParentRows(String, DataRowVersion) GetParentRows(String, DataRowVersion) 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() GetType() GetType() GetType()

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

(Inherited from Object)
HasVersion(DataRowVersion) HasVersion(DataRowVersion) HasVersion(DataRowVersion) 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) IsNull(DataColumn) IsNull(DataColumn) 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) IsNull(DataColumn, DataRowVersion) IsNull(DataColumn, DataRowVersion) 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) IsNull(Int32) IsNull(Int32) 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) IsNull(String) IsNull(String) 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() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
RejectChanges() RejectChanges() RejectChanges() 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() SetAdded() SetAdded() SetAdded()

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

SetColumnError(DataColumn, String) SetColumnError(DataColumn, String) SetColumnError(DataColumn, String) 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) SetColumnError(Int32, String) SetColumnError(Int32, String) 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) SetColumnError(String, String) SetColumnError(String, String) 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() SetModified() SetModified() SetModified()

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

SetNull(DataColumn) SetNull(DataColumn) SetNull(DataColumn) SetNull(DataColumn)

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

SetParentRow(DataRow) SetParentRow(DataRow) SetParentRow(DataRow) 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) SetParentRow(DataRow, DataRelation) SetParentRow(DataRow, DataRelation) 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() ToString() ToString() ToString()

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

(Inherited from Object)

Extension Methods

Field<T>(DataRow, DataColumn) Field<T>(DataRow, DataColumn) Field<T>(DataRow, DataColumn) Field<T>(DataRow, DataColumn)

Fournit un 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. Le Field<T>(DataRow, DataColumn) méthode prend également en charge les types nullable.The Field<T>(DataRow, DataColumn) method also supports nullable types.

Field<T>(DataRow, DataColumn, DataRowVersion) Field<T>(DataRow, DataColumn, DataRowVersion) Field<T>(DataRow, DataColumn, DataRowVersion) Field<T>(DataRow, DataColumn, DataRowVersion)

Fournit un 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. Le Field<T>(DataRow, DataColumn, DataRowVersion) méthode prend également en charge les types nullable.The Field<T>(DataRow, DataColumn, DataRowVersion) method also supports nullable types.

Field<T>(DataRow, Int32) Field<T>(DataRow, Int32) Field<T>(DataRow, Int32) Field<T>(DataRow, Int32)

Fournit un 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. Le Field<T>(DataRow, Int32) méthode prend également en charge les types nullable.The Field<T>(DataRow, Int32) method also supports nullable types.

Field<T>(DataRow, Int32, DataRowVersion) Field<T>(DataRow, Int32, DataRowVersion) Field<T>(DataRow, Int32, DataRowVersion) Field<T>(DataRow, Int32, DataRowVersion)

Fournit un 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. Le Field<T>(DataRow, Int32, DataRowVersion) méthode prend également en charge les types nullable.The Field<T>(DataRow, Int32, DataRowVersion) method also supports nullable types.

Field<T>(DataRow, String) Field<T>(DataRow, String) Field<T>(DataRow, String) Field<T>(DataRow, String)

Fournit un 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. Le Field<T>(DataRow, String) méthode prend également en charge les types nullable.The Field<T>(DataRow, String) method also supports nullable types.

Field<T>(DataRow, String, DataRowVersion) Field<T>(DataRow, String, DataRowVersion) Field<T>(DataRow, String, DataRowVersion) Field<T>(DataRow, String, DataRowVersion)

Fournit un 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. Le Field<T>(DataRow, String, DataRowVersion) méthode prend également en charge les types nullable.The Field<T>(DataRow, String, DataRowVersion) method also supports nullable types.

SetField<T>(DataRow, DataColumn, T) SetField<T>(DataRow, DataColumn, T) SetField<T>(DataRow, DataColumn, T) SetField<T>(DataRow, DataColumn, T)

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

SetField<T>(DataRow, Int32, T) SetField<T>(DataRow, Int32, T) SetField<T>(DataRow, Int32, T) SetField<T>(DataRow, Int32, T)

Définit une nouvelle valeur pour la colonne spécifiée dans le DataRow la méthode est appelée sur.Sets a new value for the specified column in the DataRow the method is called on. Le SetField<T>(DataRow, Int32, T) méthode prend également en charge les types nullable.The SetField<T>(DataRow, Int32, T) method also supports nullable types.

SetField<T>(DataRow, String, T) SetField<T>(DataRow, String, T) SetField<T>(DataRow, String, T) SetField<T>(DataRow, String, T)

Définit une nouvelle valeur pour la colonne spécifiée dans le DataRow.Sets a new value for the specified column in the DataRow. Le SetField<T>(DataRow, String, T) méthode 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 multithreads.This type is safe for multithreaded read operations. Vous devez synchroniser des opérations d’écriture.You must synchronize any write operations.

Voir aussi