DataRow.GetChildRows DataRow.GetChildRows DataRow.GetChildRows DataRow.GetChildRows Method

Definição

Obtém as linhas filho de um DataRow.Gets the child rows of a DataRow.

Sobrecargas

GetChildRows(DataRelation) GetChildRows(DataRelation) GetChildRows(DataRelation) GetChildRows(DataRelation)

Obtém as linhas filho deste DataRow usando o DataRelation especificado.Gets the child rows of this DataRow using the specified DataRelation.

GetChildRows(String) GetChildRows(String) GetChildRows(String) GetChildRows(String)

Obtém as linhas filhas de uma DataRow usando o RelationName especificado de uma DataRelation.Gets the child rows of a DataRow using the specified RelationName of a DataRelation.

GetChildRows(DataRelation, DataRowVersion) GetChildRows(DataRelation, DataRowVersion) GetChildRows(DataRelation, DataRowVersion) GetChildRows(DataRelation, DataRowVersion)

Obtém as linhas filho de um DataRow usando o DataRelation especificado e DataRowVersion.Gets the child rows of a DataRow using the specified DataRelation, and DataRowVersion.

GetChildRows(String, DataRowVersion) GetChildRows(String, DataRowVersion) GetChildRows(String, DataRowVersion) GetChildRows(String, DataRowVersion)

Obtém as linhas filho de uma DataRow usando o RelationName especificado de uma DataRelation e DataRowVersion.Gets the child rows of a DataRow using the specified RelationName of a DataRelation, and DataRowVersion.

GetChildRows(DataRelation) GetChildRows(DataRelation) GetChildRows(DataRelation) GetChildRows(DataRelation)

Obtém as linhas filho deste DataRow usando o DataRelation especificado.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()

Parâmetros

Retornos

Uma matriz de objetos de DataRow ou uma matriz de comprimento zero.An array of DataRow objects or an array of length zero.

Exceções

A relação e a linha não pertencem à mesma tabela.The relation and row do not belong to the same table.

A linha não pertence à tabela.The row does not belong to the table.

A linha não tem esta versão de dados.The row does not have this version of data.

Exemplos

O exemplo a seguir usa o GetChildRows para retornar o filho DataRow objetos para todos os filhos DataRelation em um DataTable.The following example uses the GetChildRows to return the child DataRow objects for every child DataRelation in a DataTable. Em seguida, o valor de cada coluna na linha é impresso.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

Comentários

O DataTable também contém uma coleção de objetos DataRelation retornada pela propriedade ChildRelations.The DataTable also contains a collection of DataRelation objects that is returned by the ChildRelations property.

Veja também

GetChildRows(String) GetChildRows(String) GetChildRows(String) GetChildRows(String)

Obtém as linhas filhas de uma DataRow usando o RelationName especificado de uma 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()

Parâmetros

relationName
String String String String

O RelationName da DataRelation a ser usado.The RelationName of the DataRelation to use.

Retornos

Uma matriz de objetos de DataRow ou uma matriz de comprimento zero.An array of DataRow objects or an array of length zero.

Exceções

A relação e a linha não pertencem à mesma tabela.The relation and row do not belong to the same table.

A linha não pertence à tabela.The row does not belong to the table.

Comentários

O DataTable também contém uma coleção de objetos DataRelation retornada pela propriedade ChildRelations.The DataTable also contains a collection of DataRelation objects that is returned by the ChildRelations property.

GetChildRows(DataRelation, DataRowVersion) GetChildRows(DataRelation, DataRowVersion) GetChildRows(DataRelation, DataRowVersion) GetChildRows(DataRelation, DataRowVersion)

Obtém as linhas filho de um DataRow usando o DataRelation especificado e DataRowVersion.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()

Parâmetros

version
DataRowVersion DataRowVersion DataRowVersion DataRowVersion

Um dos valores de DataRowVersion especificando a versão dos dados a serem obtidos.One of the DataRowVersion values specifying the version of the data to get. Os valores possíveis são Default, Original, Current e Proposed.Possible values are Default, Original, Current, and Proposed.

Retornos

Uma matriz de objetos de DataRow.An array of DataRow objects.

Exceções

A relação e a linha não pertencem à mesma tabela.The relation and row do not belong to the same table.

A linha não pertence à tabela.The row does not belong to the table.

Exemplos

O exemplo a seguir usa o GetChildRows para retornar o filho DataRow objetos para todos os filhos DataRelation em um DataTable.The following example uses the GetChildRows to return the child DataRow objects for every child DataRelation in a DataTable. O valor de cada coluna com a versão especificada na linha, em seguida, será impresso.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

Comentários

O DataTable também contém uma coleção de objetos DataRelation retornada pela propriedade ChildRelations.The DataTable also contains a collection of DataRelation objects that is returned by the ChildRelations property.

Use a propriedade HasVersion para determinar se o DataRowVersion desejado existe.Use the HasVersion property to determine whether the DataRowVersion that you want exists.

Se Default for especificado, a versão que é usada depende de RowState da linha na qual GetChildRows é invocado.If Default is specified, the version that is used depends on the RowState of the row on which GetChildRows is invoked. Se a linha na qual GetChildRows é invocado tem uma RowState dos Modified, New, ou Unchanged, o Current versão da linha é usado para buscar linhas filho relacionadas com valores correspondentes em suas versões atuais.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. Se a linha na qual GetChildRows é invocado tem uma RowState dos Deleted, o Original versão da linha é usado para buscar linhas filho relacionadas com valores correspondentes em suas versões originais.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.

Veja também

GetChildRows(String, DataRowVersion) GetChildRows(String, DataRowVersion) GetChildRows(String, DataRowVersion) GetChildRows(String, DataRowVersion)

Obtém as linhas filho de uma DataRow usando o RelationName especificado de uma DataRelation e 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()

Parâmetros

relationName
String String String String

O RelationName da DataRelation a ser usado.The RelationName of the DataRelation to use.

version
DataRowVersion DataRowVersion DataRowVersion DataRowVersion

Um dos valores de DataRowVersion especificando a versão dos dados a serem obtidos.One of the DataRowVersion values specifying the version of the data to get. Os valores possíveis são Default, Original, Current e Proposed.Possible values are Default, Original, Current, and Proposed.

Retornos

Uma matriz de objetos de DataRow ou uma matriz de comprimento zero.An array of DataRow objects or an array of length zero.

Exceções

A relação e a linha não pertencem à mesma tabela.The relation and row do not belong to the same table.

A linha não pertence à tabela.The row does not belong to the table.

Comentários

O DataTable também contém uma coleção de objetos DataRelation retornada pela propriedade ChildRelations.The DataTable also contains a collection of DataRelation objects that is returned by the ChildRelations property.

Use a propriedade HasVersion para determinar se o DataRowVersion desejado existe.Use the HasVersion property to determine whether the DataRowVersion that you want exists.

Se Default for especificado, a versão que é usada depende de RowState da linha na qual GetChildRows é invocado.If Default is specified, the version that is used depends on the RowState of the row on which GetChildRows is invoked. Se a linha na qual GetChildRows é invocado tem uma RowState dos Modified, New, ou Unchanged, o Current versão da linha é usado para buscar linhas filho relacionadas com valores correspondentes em suas versões atuais.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. Se a linha na qual GetChildRows é invocado tem uma RowState dos Deleted, o Original versão da linha é usado para buscar linhas filho relacionadas com valores correspondentes em suas versões originais.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.

Aplica-se a