DataRowCollection.Add Méthode
Définition
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.
Ajoute un objet DataRow à DataRowCollection.
Surcharges
Add(DataRow) |
Ajoute le DataRow spécifié à l'objet DataRowCollection. |
Add(Object[]) |
Crée une ligne à l'aide des valeurs spécifiées et l'ajoute à DataRowCollection. |
Add(DataRow)
- Source:
- DataRowCollection.cs
- Source:
- DataRowCollection.cs
- Source:
- DataRowCollection.cs
Ajoute le DataRow spécifié à l'objet DataRowCollection.
public:
void Add(System::Data::DataRow ^ row);
public void Add (System.Data.DataRow row);
member this.Add : System.Data.DataRow -> unit
Public Sub Add (row As DataRow)
Paramètres
Exceptions
La ligne a la valeur null.
La ligne appartient à une autre table ou appartient déjà à cette table.
L'ajout rend une contrainte non valide.
L'ajout tente d'insérer une valeur null dans un DataColumn dont AllowDBNull a la valeur false.
Exemples
L’exemple suivant utilise la Add méthode pour ajouter un nouveau DataRow à un DataRowCollection objet .
private void ShowRows(DataTable table)
{
// Print the number of rows in the collection.
Console.WriteLine(table.Rows.Count);
// Print the value of columns 1 in each row
foreach(DataRow row in table.Rows)
{
Console.WriteLine(row[1]);
}
}
private void AddRow(DataTable table)
{
DataRowCollection rowCollection = table.Rows;
// Instantiate a new row using the NewRow method.
DataRow newRow = table.NewRow();
// Insert code to fill the row with values.
// Add the row to the DataRowCollection.
table.Rows.Add(newRow);
}
Private Sub ShowRows(Byval table As DataTable)
' Print the number of rows in the collection.
Console.WriteLine(table.Rows.Count)
Dim row As DataRow
' Print the value of columns 1 in each row
For Each row In table.Rows
Console.WriteLine(row(1))
Next
End Sub
Private Sub AddRow(ByVal table As DataTable)
' Instantiate a new row using the NewRow method.
Dim newRow As DataRow = table.NewRow()
' Insert code to fill the row with values.
' Add the row to the DataRowCollection.
table.Rows.Add(newRow)
End Sub
Remarques
Pour créer un DataRow, vous devez utiliser la NewRow méthode de la DataTable classe . Lorsque vous utilisez la NewRow méthode , un nouvel DataRow objet est retourné à l’aide du schéma du parent DataTable. Après avoir créé l’objet DataRow et défini les valeurs de chacune de ses colonnes, utilisez la Add méthode pour ajouter l’objet à la collection.
Génère une exception si l’utilisateur génère une exception dans l’événement RowChanging . Si une exception se produit, la ligne n’est pas ajoutée à la table.
Voir aussi
S’applique à
Add(Object[])
- Source:
- DataRowCollection.cs
- Source:
- DataRowCollection.cs
- Source:
- DataRowCollection.cs
Crée une ligne à l'aide des valeurs spécifiées et l'ajoute à DataRowCollection.
public:
System::Data::DataRow ^ Add(... cli::array <System::Object ^> ^ values);
public:
virtual System::Data::DataRow ^ Add(cli::array <System::Object ^> ^ values);
public System.Data.DataRow Add (params object?[] values);
public System.Data.DataRow Add (params object[] values);
public virtual System.Data.DataRow Add (object[] values);
member this.Add : obj[] -> System.Data.DataRow
abstract member Add : obj[] -> System.Data.DataRow
override this.Add : obj[] -> System.Data.DataRow
Public Function Add (ParamArray values As Object()) As DataRow
Public Overridable Function Add (values As Object()) As DataRow
Paramètres
- values
- Object[]
Tableau des valeurs utilisées pour créer la nouvelle ligne.
Retours
Nouvelle ligne.
Exceptions
Le tableau contient un nombre de colonnes supérieur à celui de la table.
Une valeur ne correspond pas à son type de colonne respectif.
L'ajout de la ligne rend une contrainte non valide.
Tentative d'insertion d'une valeur null dans une colonne dont AllowDBNull a la valeur false.
Exemples
L’exemple suivant utilise la Add méthode pour créer et ajouter un objet DataRow à un DataRowCollection.
private void AddRow(DataTable table)
{
// Create an array with three elements.
object[] rowVals = new object[3];
DataRowCollection rowCollection = table.Rows;
rowVals[0] = "hello";
rowVals[1] = "world";
rowVals[2] = "two";
// Add and return the new row.
DataRow row = rowCollection.Add(rowVals);
}
Private Sub AddRow(ByVal table As DataTable)
' Create an array with three elements.
Dim rowVals(2) As Object
Dim rowCollection As DataRowCollection = table.Rows
rowVals(0) = "hello"
rowVals(1) = "world"
rowVals(2) = "two"
' Add and return the new row.
Dim row As DataRow = rowCollection.Add(rowVals)
End Sub
Remarques
Si un DataColumn objet a la AutoIncrement valeur True, null doit être passé pour obtenir la valeur par défaut de cette colonne.
Des exceptions peuvent également se produire si vous générez une exception pendant un ColumnChanging événement ou RowChanging . Si une exception se produit, la ligne n’est pas ajoutée à la table.