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)
- Source:
- DataRow.cs
- Source:
- DataRow.cs
- Source:
- DataRow.cs
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
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 pour GetChildRows renvoyer les objets enfants DataRow de chaque enfant DataRelation dans 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
contient DataTable également une collection d’objets DataRelation qui est retournée par la ChildRelations propriété .
Voir aussi
S’applique à
GetChildRows(String)
- Source:
- DataRow.cs
- Source:
- DataRow.cs
- Source:
- DataRow.cs
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
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
contient DataTable également une collection d’objets DataRelation qui est retournée par la ChildRelations propriété .
S’applique à
GetChildRows(DataRelation, DataRowVersion)
- Source:
- DataRow.cs
- Source:
- DataRow.cs
- Source:
- DataRow.cs
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
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 pour GetChildRows renvoyer les objets enfants DataRow de chaque enfant DataRelation dans 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
contient DataTable également une collection d’objets DataRelation qui est retournée par la ChildRelations propriété .
Utilisez la HasVersion propriété pour déterminer si le DataRowVersion que vous souhaitez existe.
Si Default est spécifié, 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 la RowState
Modified
valeur , 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 de 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)
- Source:
- DataRow.cs
- Source:
- DataRow.cs
- Source:
- DataRow.cs
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
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
contient DataTable également une collection d’objets DataRelation qui est retournée par la ChildRelations propriété .
Utilisez la HasVersion propriété pour déterminer si le DataRowVersion que vous souhaitez existe.
Si Default est spécifié, 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 la RowState
Modified
valeur , 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 de 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.