DataRow.GetChildRows Método

Definição

Espaço de Nomes:: System.Data

Assemblagem:: System.Data.dll

Assemblagem:: netstandard.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Obtém as filas filas de um DataRow.

Sobrecargas

Name	Description
GetChildRows(DataRelation)	Obtém as linhas filhas disto DataRow usando o especificado DataRelation.
GetChildRows(String)	Obtém as linhas filhos de a DataRow usando a especificada RelationName de um DataRelation.
GetChildRows(DataRelation, DataRowVersion)	Obtém as linhas filhas de a DataRow usando o especificado DataRelation, e DataRowVersion.
GetChildRows(String, DataRowVersion)	Obtém as linhas filhas de a DataRow usando o especificado RelationName de um DataRelation, e DataRowVersion.

GetChildRows(DataRelation)

Obtém as linhas filhas disto DataRow usando o especificado 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

relation: DataRelation

O DataRelation para usar.

Devoluções

DataRow[]

Um array de DataRow objetos ou um array de comprimento zero.

Exceções

ArgumentException

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

ArgumentNullException

A relação é null.

RowNotInTableException

A fila não pertence à tabela.

VersionNotFoundException

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

Exemplos

O exemplo seguinte usa o GetChildRows para devolver os objetos filhos DataRow de cada filho DataRelation em um DataTable. O valor de cada coluna na linha é então 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

Observações

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

Ver também

Aplica-se a

GetChildRows(String)

Obtém as linhas filhos de a DataRow usando a especificada RelationName de um 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

O RelationName dos DataRelation a usar.

Devoluções

DataRow[]

Um array de DataRow objetos ou um array de comprimento zero.

Exceções

ArgumentException

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

RowNotInTableException

A fila não pertence à tabela.

Observações

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

Aplica-se a

GetChildRows(DataRelation, DataRowVersion)

Obtém as linhas filhas de a DataRow usando o especificado DataRelation, 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);

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 para usar.

version: DataRowVersion

Um dos DataRowVersion valores que especifica a versão dos dados a obter. Os valores possíveis são Default, Original, Current, e Proposed.

Devoluções

DataRow[]

Uma variedade de DataRow objetos.

Exceções

ArgumentException

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

ArgumentNullException

O relation é null.

RowNotInTableException

A fila não pertence à tabela.

VersionNotFoundException

A linha não tem o pedido DataRowVersion.

Exemplos

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

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

Observações

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

Use a HasVersion propriedade para determinar se o DataRowVersion que deseja existe.

Se Default for especificado, a versão usada depende do RowState da linha em que GetChildRows é invocada. Se a linha em que GetChildRows é invocada tem um RowState de Modified, New, ou Unchanged, a Current versão da linha é usada para obter linhas filhas relacionadas com valores correspondentes nas suas versões Current. Se a linha em que GetChildRows é invocada tiver um RowState de Deleted, a Original versão da linha é usada para obter linhas filhas relacionadas com valores correspondentes nas suas versões originais.

Ver também

Aplica-se a

GetChildRows(String, DataRowVersion)

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

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 dos DataRelation a usar.

version: DataRowVersion

Um dos DataRowVersion valores que especifica a versão dos dados a obter. Os valores possíveis são Default, Original, Current, e Proposed.

Devoluções

DataRow[]

Um array de DataRow objetos ou um array de comprimento zero.

Exceções

ArgumentException

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

RowNotInTableException

A fila não pertence à tabela.

VersionNotFoundException

A linha não tem o pedido DataRowVersion.

Observações

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

Use a HasVersion propriedade para determinar se o DataRowVersion que deseja existe.

Aplica-se a

Comentários

Esta página foi útil?