DataRow.GetChildRows Método

Referência

Definição

Namespace:: System.Data

Assembly:: System.Data.Common.dll

Assembly:: System.Data.dll

Assembly:: netstandard.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Obtém as linhas filho de um DataRow.

Sobrecargas

GetChildRows(DataRelation)	Obtém as linhas filho deste DataRow usando o DataRelation especificado.
GetChildRows(String)	Obtém as linhas filhas de uma DataRow usando o RelationName especificado de uma DataRelation.
GetChildRows(DataRelation, DataRowVersion)	Obtém as linhas filho de um DataRow usando o DataRelation especificado e DataRowVersion.
GetChildRows(String, DataRowVersion)	Obtém as linhas filho de uma DataRow usando o RelationName especificado de uma DataRelation e DataRowVersion.

GetChildRows(DataRelation)

Obtém as linhas filho deste DataRow usando o DataRelation especificado.

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()

Parâmetros

relation: DataRelation

O DataRelation a ser usado.

Retornos

DataRow[]

Uma matriz de objetos de DataRow ou uma matriz de comprimento zero.

Exceções

ArgumentException

A relação e a linha não pertencem à mesma tabela.

ArgumentNullException

A relação é null.

RowNotInTableException

A linha não pertence à tabela.

VersionNotFoundException

A linha não tem esta versão de dados.

Exemplos

O exemplo a seguir usa o GetChildRows para retornar os objetos filho DataRow para cada filho DataRelation em um DataTable. Em seguida, o valor de cada coluna na linha é impresso.

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.

Confira também

Aplica-se a

GetChildRows(String)

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

Parâmetros

relationName: String

O RelationName da DataRelation a ser usado.

Retornos

DataRow[]

Uma matriz de objetos de DataRow ou uma matriz de comprimento zero.

Exceções

ArgumentException

A relação e a linha não pertencem à mesma tabela.

RowNotInTableException

A linha não pertence à tabela.

Comentários

O DataTable também contém uma coleção de objetos DataRelation retornada pela propriedade ChildRelations.

Aplica-se a

GetChildRows(DataRelation, DataRowVersion)

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

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

relation: DataRelation

O DataRelation a ser usado.

version: DataRowVersion

Um dos valores de DataRowVersion especificando a versão dos dados a serem obtidos. Os valores possíveis são Default, Original, Current e Proposed.

Retornos

DataRow[]

Uma matriz de objetos de DataRow.

Exceções

ArgumentException

A relação e a linha não pertencem à mesma tabela.

ArgumentNullException

O relation é null.

RowNotInTableException

A linha não pertence à tabela.

VersionNotFoundException

A linha não tem o DataRowVersion solicitado.

Exemplos

O exemplo a seguir usa o GetChildRows para retornar os objetos filho DataRow para cada filho DataRelation em um DataTable. O valor de cada coluna com a versão especificada na linha é impresso em seguida.

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.

Use a propriedade HasVersion para determinar se o DataRowVersion desejado existe.

Se Default for especificada, a versão usada depende da RowState linha na qual GetChildRows é invocada. Se a linha na qual GetChildRows é invocada tiver uma RowState versão de Modified, Newou Unchanged, a Current versão da linha será usada para buscar linhas filho relacionadas com valores correspondentes em suas versões atuais. Se a linha na qual GetChildRows é invocada tiver uma RowState , Deleteda Original versão da linha será usada para buscar linhas filho relacionadas com valores correspondentes em suas versões originais.

Confira também

Aplica-se a

GetChildRows(String, DataRowVersion)

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

Parâmetros

relationName: String

O RelationName da DataRelation a ser usado.

version: DataRowVersion

Um dos valores de DataRowVersion especificando a versão dos dados a serem obtidos. Os valores possíveis são Default, Original, Current e Proposed.

Retornos

DataRow[]

Uma matriz de objetos de DataRow ou uma matriz de comprimento zero.

Exceções

ArgumentException

A relação e a linha não pertencem à mesma tabela.

ArgumentNullException

O relation é null.

RowNotInTableException

A linha não pertence à tabela.

VersionNotFoundException

A linha não tem o DataRowVersion solicitado.

Comentários

O DataTable também contém uma coleção de objetos DataRelation retornada pela propriedade ChildRelations.

Use a propriedade HasVersion para determinar se o DataRowVersion desejado existe.

Aplica-se a

DataRow.GetChildRows Método

Definição

Sobrecargas

GetChildRows(DataRelation)

Parâmetros

Retornos

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

GetChildRows(String)

Parâmetros

Retornos

Exceções

Comentários

Aplica-se a

GetChildRows(DataRelation, DataRowVersion)

Parâmetros

Retornos

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

GetChildRows(String, DataRowVersion)

Parâmetros

Retornos

Exceções

Comentários

Aplica-se a

Recursos adicionais