DataRow.GetChildRows Método
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.
| 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. |
- 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
Uma matriz de objetos de DataRow ou uma matriz de comprimento zero.
Exceções
A relação e a linha não pertencem à mesma tabela.
A relação é null.
A linha não pertence à tabela.
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
.NET 9 e outras versões
| Produto | Versões |
|---|---|
| .NET | Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
| .NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 2.0, 2.1 |
- 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
Uma matriz de objetos de DataRow ou uma matriz de comprimento zero.
Exceções
A relação e a linha não pertencem à mesma tabela.
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
.NET 9 e outras versões
| Produto | Versões |
|---|---|
| .NET | Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
| .NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 2.0, 2.1 |
- 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
Uma matriz de objetos de DataRow.
Exceções
A relação e a linha não pertencem à mesma tabela.
O relation é null.
A linha não pertence à tabela.
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
- ChildRelations
- DataRelation
- DataRowVersion
- GetParentRow(String)
- GetParentRows(String)
- Relations
- Usando Conjuntos de Dados no ADO.NET
Aplica-se a
.NET 9 e outras versões
| Produto | Versões |
|---|---|
| .NET | Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
| .NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 2.0, 2.1 |
- 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
Uma matriz de objetos de DataRow ou uma matriz de comprimento zero.
Exceções
A relação e a linha não pertencem à mesma tabela.
O relation é null.
A linha não pertence à tabela.
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
.NET 9 e outras versões
| Produto | Versões |
|---|---|
| .NET | Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
| .NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 2.0, 2.1 |
Comentários do .NET
O .NET é um projeto código aberto. Selecione um link para fornecer comentários: