DataTable.LoadDataRow Méthode
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.
Recherche et met à jour une ligne spécifique. Si aucune ligne correspondante n'est détectée, une nouvelle ligne est créée à l'aide des valeurs données.
LoadDataRow(Object[], Boolean) |
Recherche et met à jour une ligne spécifique. Si aucune ligne correspondante n'est détectée, une nouvelle ligne est créée à l'aide des valeurs données. |
LoadDataRow(Object[], LoadOption) |
Recherche et met à jour une ligne spécifique. Si aucune ligne correspondante n'est détectée, une nouvelle ligne est créée à l'aide des valeurs données. |
- Source:
- DataTable.cs
- Source:
- DataTable.cs
- Source:
- DataTable.cs
Recherche et met à jour une ligne spécifique. Si aucune ligne correspondante n'est détectée, une nouvelle ligne est créée à l'aide des valeurs données.
public:
System::Data::DataRow ^ LoadDataRow(cli::array <System::Object ^> ^ values, bool fAcceptChanges);
public System.Data.DataRow LoadDataRow (object?[] values, bool fAcceptChanges);
public System.Data.DataRow LoadDataRow (object[] values, bool fAcceptChanges);
member this.LoadDataRow : obj[] * bool -> System.Data.DataRow
Public Function LoadDataRow (values As Object(), fAcceptChanges As Boolean) As DataRow
Paramètres
- values
- Object[]
Tableau des valeurs utilisées pour créer la nouvelle ligne.
- fAcceptChanges
- Boolean
true
pour accepter les modifications ; sinon, false
.
Retours
Nouvelle DataRow.
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 LoadDataRow méthode pour tenter de trouver une ligne. Si aucune ligne de ce type n’est trouvée, les valeurs sont utilisées pour créer une ligne.
using System;
using System.Data;
class MyDataSet {
public static void Main() {
DataTable dt = new DataTable();
DataColumn dc1 = new DataColumn("col1");
DataColumn dc2 = new DataColumn("col2");
DataColumn dc3 = new DataColumn("col3");
dt.Columns.Add(dc1);
dt.Columns.Add(dc2);
dt.Columns.Add(dc3);
// Create an array for the values.
object[] newRow = new object[3];
// Set the values of the array.
newRow[0] = "Hello";
newRow[1] = "World";
newRow[2] = "two";
DataRow row;
dt.BeginLoadData();
// Add the new row to the rows collection.
row = dt.LoadDataRow(newRow, true);
foreach (DataRow dr in dt.Rows) {
Console.WriteLine(String.Format("Row: {0}, {1}, {2}", dr["col1"], dr["col2"], dr["col3"]));
}
dt.EndLoadData();
}
}
Imports System.Data
Class MyDataSet
Public Shared Sub Main()
Dim dt As New DataTable()
Dim dc1 As New DataColumn("col1")
Dim dc2 As New DataColumn("col2")
Dim dc3 As New DataColumn("col3")
dt.Columns.Add(dc1)
dt.Columns.Add(dc2)
dt.Columns.Add(dc3)
' Create an array for the values.
Dim newRow As Object() = New Object(2) {}
' Set the values of the array.
newRow(0) = "Hello"
newRow(1) = "World"
newRow(2) = "two"
Dim row As DataRow
dt.BeginLoadData()
' Add the new row to the rows collection.
row = dt.LoadDataRow(newRow, True)
For Each dr As DataRow In dt.Rows
Console.WriteLine([String].Format("Row: {0}, {1}, {2}", dr("col1"), dr("col2"), dr("col3")))
Next
dt.EndLoadData()
End Sub
End Class
Remarques
La LoadDataRow méthode prend un tableau de valeurs et recherche la ou les valeurs correspondantes dans la ou les colonnes de clé primaire.
Si une colonne a une valeur par défaut, passez une valeur null dans le tableau pour définir la valeur par défaut pour cette colonne. De même, si une colonne a sa AutoIncrement propriété définie sur true, passez une valeur null dans le tableau pour définir la valeur générée automatiquement pour la ligne.
Si le fAcceptChanges
paramètre est ou n’est true
pas spécifié, les nouvelles données sont ajoutées, puis AcceptChanges sont appelées pour accepter toutes les modifications dans ; DataTablesi l’argument est false
, les lignes nouvellement ajoutées sont marquées comme insertions et les modifications apportées aux lignes existantes sont marquées comme des modifications.
Des exceptions peuvent également se produire pendant un ColumnChanging événement ou .RowChanging Si une exception se produit, la ligne n’est pas ajoutée à la table.
Utilisez LoadDataRow conjointement avec BeginLoadData et EndLoadData.
Voir aussi
S’applique à
.NET 9 et autres versions
Produit | Versions |
---|---|
.NET | Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
.NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 2.0, 2.1 |
- Source:
- DataTable.cs
- Source:
- DataTable.cs
- Source:
- DataTable.cs
Recherche et met à jour une ligne spécifique. Si aucune ligne correspondante n'est détectée, une nouvelle ligne est créée à l'aide des valeurs données.
public:
System::Data::DataRow ^ LoadDataRow(cli::array <System::Object ^> ^ values, System::Data::LoadOption loadOption);
public System.Data.DataRow LoadDataRow (object?[] values, System.Data.LoadOption loadOption);
public System.Data.DataRow LoadDataRow (object[] values, System.Data.LoadOption loadOption);
member this.LoadDataRow : obj[] * System.Data.LoadOption -> System.Data.DataRow
Public Function LoadDataRow (values As Object(), loadOption As LoadOption) As DataRow
Paramètres
- values
- Object[]
Tableau des valeurs utilisées pour créer la nouvelle ligne.
- loadOption
- LoadOption
Utilisé pour déterminer comment les valeurs de tableau sont appliquées aux valeurs correspondantes dans une ligne existante.
Retours
Nouvelle DataRow.
Remarques
La LoadDataRow méthode prend un tableau de valeurs et recherche la ou les valeurs correspondantes dans la ou les colonnes de clé primaire.
Si une colonne a une valeur par défaut, passez une valeur null dans le tableau pour définir la valeur par défaut pour cette colonne. De même, si une colonne a sa AutoIncrement propriété définie sur true, passez une valeur null dans le tableau pour définir la valeur générée automatiquement pour la ligne.
La valeur du loadOption
paramètre est utilisée pour déterminer comment les valeurs du tableau sont appliquées à une ligne existante. Par exemple, si loadOption
a la valeur OverwriteChanges
, les Original
valeurs et Current
de chaque colonne sont remplacées par les valeurs de la ligne entrante et la propriété a la RowState
Unchanged
valeur .
Des exceptions peuvent également se produire pendant un ColumnChanging événement ou .RowChanging Si une exception se produit, la ligne n’est pas ajoutée à la table.
Utilisez LoadDataRow conjointement avec BeginLoadData et EndLoadData.
Voir aussi
S’applique à
.NET 9 et autres versions
Produit | Versions |
---|---|
.NET | Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
.NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 2.0, 2.1 |
Commentaires sur .NET
.NET est un projet open source. Sélectionnez un lien pour fournir des commentaires :