DataRow.GetChildRows Méthode

Définition

Obtient les lignes enfants de DataRow.Gets the child rows of a DataRow.

Surcharges

GetChildRows(DataRelation)

Obtient les lignes enfants de ce DataRow à l'aide du DataRelation spécifié.Gets the child rows of this DataRow using the specified DataRelation.

GetChildRows(String)

Obtient les lignes enfants de DataRow à l'aide du RelationName spécifié de DataRelation.Gets the child rows of a DataRow using the specified RelationName of a DataRelation.

GetChildRows(DataRelation, DataRowVersion)

Obtient les lignes enfants de DataRow à l'aide du DataRelation et du DataRowVersion spécifiés.Gets the child rows of a DataRow using the specified DataRelation, and DataRowVersion.

GetChildRows(String, DataRowVersion)

Obtient les lignes enfants de DataRow à l'aide du RelationName spécifié de DataRelation et de DataRowVersion.Gets the child rows of a DataRow using the specified RelationName of a DataRelation, and DataRowVersion.

GetChildRows(DataRelation)

Obtient les lignes enfants de ce DataRow à l'aide du DataRelation spécifié.Gets the child rows of this DataRow using the specified DataRelation.

public:
 cli::array <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.The DataRelation to use.

Retours

Tableau d'objets DataRow ou tableau de longueur zéro.An array of DataRow objects or an array of length zero.

Exceptions

La relation et la ligne n'appartiennent pas à la même table.The relation and row do not belong to the same table.

La relation est null.The relation is null.

La ligne n'appartient pas à la table.The row does not belong to the table.

La ligne ne possède pas cette version des données.The row does not have this version of data.

Exemples

L' GetChildRows exemple suivant utilise pour retourner les objets enfants DataRow pour chaque enfant DataRelation dans un DataTable.The following example uses the GetChildRows to return the child DataRow objects for every child DataRelation in a DataTable. La valeur de chaque colonne de la ligne est ensuite imprimée.The value of each column in the row is then printed.

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 également une collection d' DataRelation objets retournés par la ChildRelations propriété. DataTableThe DataTable also contains a collection of DataRelation objects that is returned by the ChildRelations property.

Voir aussi

GetChildRows(String)

Obtient les lignes enfants de DataRow à l'aide du RelationName spécifié de DataRelation.Gets the child rows of a DataRow using the specified RelationName of a DataRelation.

public:
 cli::array <System::Data::DataRow ^> ^ GetChildRows(System::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.The RelationName of the DataRelation to use.

Retours

Tableau d'objets DataRow ou tableau de longueur zéro.An array of DataRow objects or an array of length zero.

Exceptions

La relation et la ligne n'appartiennent pas à la même table.The relation and row do not belong to the same table.

La ligne n'appartient pas à la table.The row does not belong to the table.

Remarques

Contient également une collection d' DataRelation objets retournés par la ChildRelations propriété. DataTableThe DataTable also contains a collection of DataRelation objects that is returned by the ChildRelations property.

GetChildRows(DataRelation, DataRowVersion)

Obtient les lignes enfants de DataRow à l'aide du DataRelation et du DataRowVersion spécifiés.Gets the child rows of a DataRow using the specified DataRelation, and DataRowVersion.

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);
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.The DataRelation to use.

version
DataRowVersion

Une des valeurs DataRowVersion spécifiant la version des données à obtenir.One of the DataRowVersion values specifying the version of the data to get. Les valeurs possibles sont Default, Original, Current et Proposed.Possible values are Default, Original, Current, and Proposed.

Retours

Tableau d'objets DataRow.An array of DataRow objects.

Exceptions

La relation et la ligne n'appartiennent pas à la même table.The relation and row do not belong to the same table.

relation a la valeur null.The relation is null.

La ligne n'appartient pas à la table.The row does not belong to the table.

La ligne ne contient pas le DataRowVersion demandé.The row does not have the requested DataRowVersion.

Exemples

L' GetChildRows exemple suivant utilise pour retourner les objets enfants DataRow pour chaque enfant DataRelation dans un DataTable.The following example uses the GetChildRows to return the child DataRow objects for every child DataRelation in a DataTable. La valeur de chaque colonne avec la version spécifiée dans la ligne est ensuite imprimée.The value of each column with the specified version in the row is then printed.

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 également une collection d' DataRelation objets retournés par la ChildRelations propriété. DataTableThe DataTable also contains a collection of DataRelation objects that is returned by the ChildRelations property.

Utilisez la HasVersion propriété pour déterminer si le DataRowVersion souhaité existe.Use the HasVersion property to determine whether the DataRowVersion that you want exists.

Si Default est spécifié, la version qui est utilisée dépend de la RowState de la ligne sur laquelle GetChildRows est appelé.If Default is specified, the version that is used depends on the RowState of the row on which GetChildRows is invoked. Si la ligne sur laquelle GetChildRows est appelée RowState a Modified Newla valeur, ou Unchanged, la version de Current la ligne est utilisée pour récupérer les lignes enfants associées avec des valeurs correspondantes dans leurs versions actuelles.If the row on which GetChildRows is invoked has a RowState of Modified, New, or Unchanged, the Current version of the row is used for fetching related child rows with matching values in their Current versions. Si la ligne sur laquelle GetChildRows est appelée a une RowState valeur de Deleted, la Original version de la ligne est utilisée pour récupérer les lignes enfants associées avec des valeurs correspondantes dans leurs versions d’origine.If the row on which GetChildRows is invoked has a RowState of Deleted, the Original version of the row is used for fetching related child rows with matching values in their original versions.

Voir aussi

GetChildRows(String, DataRowVersion)

Obtient les lignes enfants de DataRow à l'aide du RelationName spécifié de DataRelation et de DataRowVersion.Gets the child rows of a DataRow using the specified RelationName of a DataRelation, and 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);
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.The RelationName of the DataRelation to use.

version
DataRowVersion

Une des valeurs DataRowVersion spécifiant la version des données à obtenir.One of the DataRowVersion values specifying the version of the data to get. Les valeurs possibles sont Default, Original, Current et Proposed.Possible values are Default, Original, Current, and Proposed.

Retours

Tableau d'objets DataRow ou tableau de longueur zéro.An array of DataRow objects or an array of length zero.

Exceptions

La relation et la ligne n'appartiennent pas à la même table.The relation and row do not belong to the same table.

relation a la valeur null.The relation is null.

La ligne n'appartient pas à la table.The row does not belong to the table.

La ligne ne contient pas le DataRowVersion demandé.The row does not have the requested DataRowVersion.

Remarques

Contient également une collection d' DataRelation objets retournés par la ChildRelations propriété. DataTableThe DataTable also contains a collection of DataRelation objects that is returned by the ChildRelations property.

Utilisez la HasVersion propriété pour déterminer si le DataRowVersion souhaité existe.Use the HasVersion property to determine whether the DataRowVersion that you want exists.

Si Default est spécifié, la version qui est utilisée dépend de la RowState de la ligne sur laquelle GetChildRows est appelé.If Default is specified, the version that is used depends on the RowState of the row on which GetChildRows is invoked. Si la ligne sur laquelle GetChildRows est appelée RowState a Modified Newla valeur, ou Unchanged, la version de Current la ligne est utilisée pour récupérer les lignes enfants associées avec des valeurs correspondantes dans leurs versions actuelles.If the row on which GetChildRows is invoked has a RowState of Modified, New, or Unchanged, the Current version of the row is used for fetching related child rows with matching values in their Current versions. Si la ligne sur laquelle GetChildRows est appelée a une RowState valeur de Deleted, la Original version de la ligne est utilisée pour récupérer les lignes enfants associées avec des valeurs correspondantes dans leurs versions d’origine.If the row on which GetChildRows is invoked has a RowState of Deleted, the Original version of the row is used for fetching related child rows with matching values in their original versions.

S’applique à