DataRow.GetChildRows Método

  • Referência

Definição

Namespace:
System.Data
Assembly:
System.Data.Common.dll
Assembly:
System.Data.dll
Assembly:
netstandard.dll

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)

Origem:
DataRow.cs
Origem:
DataRow.cs
Origem:
DataRow.cs

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)

Origem:
DataRow.cs
Origem:
DataRow.cs
Origem:
DataRow.cs

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)

Origem:
DataRow.cs
Origem:
DataRow.cs
Origem:
DataRow.cs

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.

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 especificado, a versão usada dependerá do RowState da linha na qual GetChildRows é invocado. Se a linha na qual GetChildRows é invocada tiver um RowState 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 um RowState de Deleted, a 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)

Origem:
DataRow.cs
Origem:
DataRow.cs
Origem:
DataRow.cs

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.

Se Default for especificado, a versão usada dependerá do RowState da linha na qual GetChildRows é invocado. Se a linha na qual GetChildRows é invocada tiver um RowState 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 um RowState de Deleted, a Original versão da linha será usada para buscar linhas filho relacionadas com valores correspondentes em suas versões originais.

Aplica-se a