Représente une ligne de données dans un DataTable.
System.Data.DataRow
Espace de noms : System.Data
Assembly : System.Data (dans System.Data.dll)
Public Class DataRow
public class DataRow
public ref class DataRow
type DataRow = class end
Le type DataRow expose les membres suivants.
| Nom | Description | |
|---|---|---|
|
DataRow | Infrastructure. Initialise une nouvelle instance de DataRow. Construit une ligne à partir du générateur. Uniquement pour un usage interne. |
| Nom | Description | |
|---|---|---|
|
HasErrors | Obtient une valeur qui indique s'il existe des erreurs dans une ligne. |
|
Item[DataColumn] | Obtient ou définit les données stockées dans le DataColumn spécifié. |
|
Item[Int32] | Obtient ou définit les données stockées dans la colonne spécifiée par l'index. |
|
Item[String] | Obtient ou définit les données stockées dans la colonne spécifiée par son nom. |
|
Item[DataColumn, DataRowVersion] | Obtient la version spécifiée des 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[String, DataRowVersion] | Obtient la version spécifiée des données stockées dans la colonne nommée. |
|
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. |
| Nom | Description | |
|---|---|---|
|
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. |
|
Delete | Supprime DataRow. |
|
EndEdit | Termine la modification de la ligne en cours. |
|
Equals(Object) | Détermine si l'Object spécifié est égal à l'Object en cours. (Hérité de Object.) |
|
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.) |
|
GetChildRows(DataRelation) | Obtient les lignes enfants de ce DataRow à l'aide du DataRelation spécifié. |
|
GetChildRows(String) | Obtient les lignes enfants de DataRow à l'aide du RelationName spécifié de DataRelation. |
|
GetChildRows(DataRelation, DataRowVersion) | Obtient les lignes enfants de DataRow à l'aide du DataRelation et du DataRowVersion spécifiés. |
|
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 | Sert de fonction de hachage pour un type particulier. (Hérité de Object.) |
|
GetParentRow(DataRelation) | Obtient la ligne parente de DataRow à l'aide du DataRelation spécifié. |
|
GetParentRow(String) | Obtient la ligne parente de DataRow à l'aide du RelationName spécifié de DataRelation. |
|
GetParentRow(DataRelation, DataRowVersion) | Obtient la ligne parente de DataRow à l'aide du DataRelation et du DataRowVersion spécifiés. |
|
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(String) | Obtient les lignes parentes de DataRow à l'aide du RelationName spécifié de DataRelation. |
|
GetParentRows(DataRelation, DataRowVersion) | Obtient les lignes parentes de DataRow à l'aide du DataRelation et du DataRowVersion spécifiés. |
|
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 | 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(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. |
|
IsNull(DataColumn, DataRowVersion) | Obtient une valeur qui indique si le DataColumn et le DataRowVersion spécifiés contiennent une valeur null. |
|
MemberwiseClone | Crée une copie superficielle de l'objet Object actif. (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 | 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.) |
| Nom | Description | |
|---|---|---|
|
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.) |
|
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.) |
|
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.) |
|
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.) |
|
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.) |
|
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.) |
|
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.) |
|
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.) |
|
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.) |
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.
L'exemple suivant crée un nouveau DataRow en appelant la méthode NewRow de l'objet DataTable.
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
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; }
.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 SP1Windows 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.
Ce type est sécurisé pour les opérations de lecture multithread. Vous devez synchroniser les opérations d'écriture.