DataRow.GetParentRows Método

Definição

Namespace:

System.Data

Assembly:

System.Data.Common.dll

Obtém as linhas pai de um DataRow.

Sobrecargas

GetParentRows(DataRelation, DataRowVersion)	Obtém as linhas pai de um DataRow usando a DataRelation especificada e a DataRowVersion.
GetParentRows(DataRelation)	Obtém as linhas pai de um DataRow usando o DataRelation especificado.
GetParentRows(String)	Obtém as linhas pai de um DataRow usando o RelationName especificado de uma DataRelation.
GetParentRows(String, DataRowVersion)	Obtém as linhas pai de um DataRow usando o RelationName especificado de um DataRelation e a DataRowVersion.

GetParentRows(DataRelation, DataRowVersion)

Origem:

DataRow.cs

Obtém as linhas pai de um DataRow usando a DataRelation especificada e a DataRowVersion.

public:
 cli::array <System::Data::DataRow ^> ^ GetParentRows(System::Data::DataRelation ^ relation, System::Data::DataRowVersion version);

public System.Data.DataRow[] GetParentRows (System.Data.DataRelation? relation, System.Data.DataRowVersion version);

member this.GetParentRows : System.Data.DataRelation * System.Data.DataRowVersion -> System.Data.DataRow[]

Public Function GetParentRows (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.

Retornos

DataRow[]

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

Exceções

ArgumentException

O DataRelation não pertence ao DataSet dessa linha.

ArgumentNullException

A linha é null.

InvalidConstraintException

A tabela filho da relação não é a tabela à qual a linha pertence.

RowNotInTableException

A linha não pertence a uma DataTable.

VersionNotFoundException

A linha não tem o DataRowVersion solicitado.

Exemplos

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

Private Sub GetChildRowsFromDataRelation(table As DataTable, ver As DataRowVersion)
    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.ParentRelations
      For Each row In table.Rows
          arrRows = row.GetParentRows(relation, ver)
          ' Print values of rows.
          For i = 0 To arrRows.GetUpperBound(0)
             For Each column in table.Columns
                Console.WriteLine(arrRows(i)(column.ColumnName))
             Next column
          Next i
       Next row
    Next relation
End Sub

Comentários

Em um DataSet, a coleção de todos os objetos pai de DataRelation para o conjunto de dados é retornada pelo método GetParentRows.

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

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

Confira também

• ChildRelations
• DataRelation
• GetChildRows(String)
• GetParentRow(String)
• Relations

GetParentRows(DataRelation)

Origem:

DataRow.cs

Obtém as linhas pai de um DataRow usando o DataRelation especificado.

public:
 cli::array <System::Data::DataRow ^> ^ GetParentRows(System::Data::DataRelation ^ relation);

public System.Data.DataRow[] GetParentRows (System.Data.DataRelation? relation);

member this.GetParentRows : System.Data.DataRelation -> System.Data.DataRow[]

Public Function GetParentRows (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

O DataRelation não pertence ao DataSet dessa linha.

ArgumentNullException

A linha é null.

InvalidConstraintException

A tabela filho da relação não é a tabela à qual a linha pertence.

RowNotInTableException

A linha não pertence a uma DataTable.

Exemplos

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

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.ParentRelations
      For Each row In table.Rows
          arrRows = row.GetParentRows(relation)
          ' Print values of rows.
          For i = 0 To arrRows.GetUpperBound(0)
             For Each column in table.Columns
                Console.WriteLine(arrRows(i)(column.ColumnName))
             Next column
          Next i
       Next row
    Next relation
 End Sub

Comentários

Em um DataSet, a coleção de todos os objetos pai de DataRelation para o conjunto de dados é retornada pelo método GetParentRows.

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

Confira também

• ChildRelations
• DataRelation
• GetChildRows(String)
• GetParentRow(String)
• Relations

GetParentRows(String)

Origem:

DataRow.cs

Obtém as linhas pai de um DataRow usando o RelationName especificado de uma DataRelation.

public:
 cli::array <System::Data::DataRow ^> ^ GetParentRows(System::String ^ relationName);

public System.Data.DataRow[] GetParentRows (string? relationName);

member this.GetParentRows : string -> System.Data.DataRow[]

Public Function GetParentRows (relationName As String) As DataRow()

Parâmetros

relationName

String

O RelationName de um DataRelation.

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

Em um DataSet, a coleção de todos os objetos pai de DataRelation para o conjunto de dados é retornada pelo método GetParentRows.

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

GetParentRows(String, DataRowVersion)

Origem:

DataRow.cs

Obtém as linhas pai de um DataRow usando o RelationName especificado de um DataRelation e a DataRowVersion.

public:
 cli::array <System::Data::DataRow ^> ^ GetParentRows(System::String ^ relationName, System::Data::DataRowVersion version);

public System.Data.DataRow[] GetParentRows (string? relationName, System.Data.DataRowVersion version);

member this.GetParentRows : string * System.Data.DataRowVersion -> System.Data.DataRow[]

Public Function GetParentRows (relationName As String, version As DataRowVersion) As DataRow()

Parâmetros

relationName

String

O RelationName de um DataRelation.

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

Em um DataSet, a coleção de todos os objetos pai de DataRelation para o conjunto de dados é retornada pelo método GetParentRows.

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

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