DataRow.GetChildRows 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.
Obtient les lignes enfants de DataRow.
Surcharges
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. |
GetChildRows(DataRelation)
Obtient les lignes enfants de ce DataRow à l'aide du DataRelation spécifié.
public:
cli::array <System::Data::DataRow ^> ^ GetChildRows(System::Data::DataRelation ^ relation);
public System.Data.DataRow[] GetChildRows (System.Data.DataRelation? relation);
public System.Data.DataRow[] GetChildRows (System.Data.DataRelation relation);
member this.GetChildRows : System.Data.DataRelation -> System.Data.DataRow[]
Public Function GetChildRows (relation As DataRelation) As DataRow()
Paramètres
- relation
- DataRelation
DataRelation à utiliser.
Retours
- DataRow[]
Tableau d'objets DataRow ou tableau de longueur zéro.
Exceptions
La relation et la ligne n'appartiennent pas à la même table.
La relation est null
.
La ligne n'appartient pas à la table.
La ligne ne possède pas cette version des données.
Exemples
L’exemple suivant utilise l’exemple GetChildRows suivant pour retourner les objets enfants DataRow pour chaque enfant DataRelation d’un DataTable. La valeur de chaque colonne de la ligne est ensuite imprimée.
private void GetChildRowsFromDataRelation(DataTable table)
{
DataRow[] arrRows;
foreach(DataRelation relation in table.ChildRelations)
{
foreach(DataRow row in table.Rows)
{
arrRows = row.GetChildRows(relation);
// Print values of rows.
for(int i = 0; i < arrRows.Length; i++)
{
foreach(DataColumn column in table.Columns)
{
Console.WriteLine(arrRows[i][column]);
}
}
}
}
}
Private Sub GetChildRowsFromDataRelation(table As DataTable)
Dim relation As DataRelation
Dim arrRows() As DataRow
Dim row As DataRow
Dim i As Integer
Dim column As DataColumn
For Each relation In table.ChildRelations
For Each row In table.Rows
arrRows = row.GetChildRows(relation)
' Print values of rows.
For i = 0 To arrRows.GetUpperBound(0)
For Each column in table.Columns
Console.WriteLine(arrRows(i)(column))
Next column
Next i
Next row
Next relation
End Sub
Remarques
Il DataTable contient également une collection d’objets DataRelation retournés par la ChildRelations propriété.
Voir aussi
S’applique à
GetChildRows(String)
Obtient les lignes enfants de DataRow à l'aide du RelationName spécifié de DataRelation.
public:
cli::array <System::Data::DataRow ^> ^ GetChildRows(System::String ^ relationName);
public System.Data.DataRow[] GetChildRows (string? relationName);
public System.Data.DataRow[] GetChildRows (string relationName);
member this.GetChildRows : string -> System.Data.DataRow[]
Public Function GetChildRows (relationName As String) As DataRow()
Paramètres
- relationName
- String
RelationName du DataRelation à utiliser.
Retours
- DataRow[]
Tableau d'objets DataRow ou tableau de longueur zéro.
Exceptions
La relation et la ligne n'appartiennent pas à la même table.
La ligne n'appartient pas à la table.
Remarques
Il DataTable contient également une collection d’objets DataRelation retournés par la ChildRelations propriété.
S’applique à
GetChildRows(DataRelation, DataRowVersion)
Obtient les lignes enfants de DataRow à l'aide du DataRelation et du DataRowVersion spécifiés.
public:
cli::array <System::Data::DataRow ^> ^ GetChildRows(System::Data::DataRelation ^ relation, System::Data::DataRowVersion version);
public System.Data.DataRow[] GetChildRows (System.Data.DataRelation? relation, System.Data.DataRowVersion version);
public System.Data.DataRow[] GetChildRows (System.Data.DataRelation relation, System.Data.DataRowVersion version);
member this.GetChildRows : System.Data.DataRelation * System.Data.DataRowVersion -> System.Data.DataRow[]
Public Function GetChildRows (relation As DataRelation, version As DataRowVersion) As DataRow()
Paramètres
- relation
- DataRelation
DataRelation à utiliser.
- version
- DataRowVersion
Une des valeurs DataRowVersion spécifiant la version des données à obtenir. Les valeurs possibles sont Default
, Original
, Current
et Proposed
.
Retours
- DataRow[]
Tableau d'objets DataRow.
Exceptions
La relation et la ligne n'appartiennent pas à la même table.
relation
a la valeur null
.
La ligne n'appartient pas à la table.
La ligne ne contient pas le DataRowVersion demandé.
Exemples
L’exemple suivant utilise l’exemple GetChildRows suivant pour retourner les objets enfants DataRow pour chaque enfant DataRelation d’un DataTable. La valeur de chaque colonne avec la version spécifiée dans la ligne est ensuite imprimée.
private void GetChildRowsFromDataRelation(DataTable table )
{
DataRow[] arrRows;
foreach(DataRelation relation in table.ChildRelations)
{
foreach(DataRow row in table.Rows)
{
arrRows = row.GetChildRows(relation,
DataRowVersion.Proposed);
// Print values of rows.
for(int i = 0; i < arrRows.Length; i++)
{
foreach(DataColumn column in table.Columns)
{
Console.WriteLine(arrRows[i][column]);
}
}
}
}
}
Private Sub GetChildRowsFromDataRelation(table As DataTable)
Dim relation As DataRelation
Dim arrRows() As DataRow
Dim row As DataRow
Dim i As Integer
Dim column As DataColumn
For Each relation In table.ChildRelations
For Each row In table.Rows
arrRows = row.GetChildRows(relation, _
DataRowVersion.Proposed)
' Print values of rows.
For i = 0 To arrRows.GetUpperBound(0)
For Each column in table.Columns
Console.WriteLine(arrRows(i)(column))
Next column
Next i
Next row
Next relation
End Sub
Remarques
Il DataTable contient également une collection d’objets DataRelation retournés par la ChildRelations propriété.
Utilisez la HasVersion propriété pour déterminer si vous DataRowVersion souhaitez exister.
Si Default elle est spécifiée, la version utilisée dépend de la RowState ligne sur laquelle GetChildRows
est appelée. Si la ligne sur laquelle GetChildRows
est appelée a un RowState
, Modified``New
ou Unchanged
, la Current version de la ligne est utilisée pour extraire les lignes enfants associées avec des valeurs correspondantes dans leurs versions actuelles. Si la ligne sur laquelle GetChildRows
est appelée a un RowState
, Deleted
la Original version de la ligne est utilisée pour extraire les lignes enfants associées avec des valeurs correspondantes dans leurs versions d’origine.
Voir aussi
- ChildRelations
- DataRelation
- DataRowVersion
- GetParentRow(String)
- GetParentRows(String)
- Relations
- Utilisation de DataSets dans ADO.NET
S’applique à
GetChildRows(String, DataRowVersion)
Obtient les lignes enfants de DataRow à l'aide du RelationName spécifié de DataRelation et de DataRowVersion.
public:
cli::array <System::Data::DataRow ^> ^ GetChildRows(System::String ^ relationName, System::Data::DataRowVersion version);
public System.Data.DataRow[] GetChildRows (string? relationName, System.Data.DataRowVersion version);
public System.Data.DataRow[] GetChildRows (string relationName, System.Data.DataRowVersion version);
member this.GetChildRows : string * System.Data.DataRowVersion -> System.Data.DataRow[]
Public Function GetChildRows (relationName As String, version As DataRowVersion) As DataRow()
Paramètres
- relationName
- String
RelationName du DataRelation à utiliser.
- version
- DataRowVersion
Une des valeurs DataRowVersion spécifiant la version des données à obtenir. Les valeurs possibles sont Default
, Original
, Current
et Proposed
.
Retours
- DataRow[]
Tableau d'objets DataRow ou tableau de longueur zéro.
Exceptions
La relation et la ligne n'appartiennent pas à la même table.
relation
a la valeur null
.
La ligne n'appartient pas à la table.
La ligne ne contient pas le DataRowVersion demandé.
Remarques
Il DataTable contient également une collection d’objets DataRelation retournés par la ChildRelations propriété.
Utilisez la HasVersion propriété pour déterminer si vous DataRowVersion souhaitez exister.
Si Default elle est spécifiée, la version utilisée dépend de la RowState ligne sur laquelle GetChildRows
est appelée. Si la ligne sur laquelle GetChildRows
est appelée a un RowState
, Modified``New
ou Unchanged
, la Current version de la ligne est utilisée pour extraire les lignes enfants associées avec des valeurs correspondantes dans leurs versions actuelles. Si la ligne sur laquelle GetChildRows
est appelée a un RowState
, Deleted
la Original version de la ligne est utilisée pour extraire les lignes enfants associées avec des valeurs correspondantes dans leurs versions d’origine.