DataRow.GetChildRows Método

Definición

Espacio de nombres:

System.Data

Ensamblado:

System.Data.Common.dll

Obtiene las filas secundarias de DataRow.

Sobrecargas

GetChildRows(DataRelation)	Obtiene las filas secundarias de este DataRow mediante el DataRelation especificado.
GetChildRows(String)	Obtiene las filas secundarias de un DataRow mediante el RelationName especificado de un DataRelation.
GetChildRows(DataRelation, DataRowVersion)	Obtiene las filas secundarias de un DataRow mediante el DataRelation especificado y DataRowVersion.
GetChildRows(String, DataRowVersion)	Obtiene las filas secundarias de un DataRow mediante el RelationName especificado de un DataRelation y DataRowVersion.

GetChildRows(DataRelation)

Source:

DataRow.cs

Obtiene las filas secundarias de este DataRow mediante el DataRelation especificado.

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

Objeto DataRelation que se va a usar.

Devoluciones

DataRow[]

Matriz de objetos DataRow o una matriz de longitud cero.

Excepciones

ArgumentException

La relación y la fila no pertenecen a la misma tabla.

ArgumentNullException

La relación es null.

RowNotInTableException

La fila no pertenece a la tabla.

VersionNotFoundException

La fila no tiene esta versión de datos.

Ejemplos

En el ejemplo siguiente se usa GetChildRows para devolver los objetos secundarios DataRow de cada elemento secundario DataRelation de .DataTable A continuación, se imprime el valor de cada columna de la fila.

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

Comentarios

DataTable También contiene una colección de DataRelation objetos devueltos por la ChildRelations propiedad .

Consulte también

• ChildRelations
• DataRelation
• GetParentRows(String)
• Relations
• Uso de conjuntos de datos en ADO.NET

GetChildRows(String)

Source:

DataRow.cs

Obtiene las filas secundarias de un DataRow mediante el RelationName especificado de un 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

RelationName de DataRelation que se va a utilizar.

Devoluciones

DataRow[]

Matriz de objetos DataRow o una matriz de longitud cero.

Excepciones

ArgumentException

La relación y la fila no pertenecen a la misma tabla.

RowNotInTableException

La fila no pertenece a la tabla.

Comentarios

DataTable También contiene una colección de DataRelation objetos devueltos por la ChildRelations propiedad .

GetChildRows(DataRelation, DataRowVersion)

Source:

DataRow.cs

Obtiene las filas secundarias de un DataRow mediante el DataRelation especificado y 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

Objeto DataRelation que se va a usar.

version

DataRowVersion

Uno de los valores de DataRowVersion que especifica la versión de los datos que se va a obtener. Los valores posibles son Default, Original, Current y Proposed.

Devoluciones

DataRow[]

Matriz de objetos DataRow.

Excepciones

ArgumentException

La relación y la fila no pertenecen a la misma tabla.

ArgumentNullException

El valor de relation es null.

RowNotInTableException

La fila no pertenece a la tabla.

VersionNotFoundException

La fila no tiene el DataRowVersion solicitado.

Ejemplos

En el ejemplo siguiente se usa GetChildRows para devolver los objetos secundarios DataRow de cada elemento secundario DataRelation de .DataTable A continuación, se imprime el valor de cada columna con la versión especificada de la fila.

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

Comentarios

DataTable También contiene una colección de DataRelation objetos devueltos por la ChildRelations propiedad .

Utilice la HasVersion propiedad para determinar si existe el DataRowVersion que desea.

Si Default se especifica , la versión que se usa depende RowState de la de la fila en la que GetChildRows se invoca. Si la fila en la que GetChildRows se invoca tiene un RowState de Modified, Newo Unchanged, la Current versión de la fila se usa para capturar filas secundarias relacionadas con valores coincidentes en sus versiones actuales. Si la fila en la que GetChildRows se invoca tiene un RowState de Deleted, la Original versión de la fila se usa para capturar filas secundarias relacionadas con valores coincidentes en sus versiones originales.

Consulte también

• ChildRelations
• DataRelation
• DataRowVersion
• GetParentRow(String)
• GetParentRows(String)
• Relations
• Uso de conjuntos de datos en ADO.NET

GetChildRows(String, DataRowVersion)

Source:

DataRow.cs

Obtiene las filas secundarias de un DataRow mediante el RelationName especificado de un DataRelation y 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

RelationName de DataRelation que se va a utilizar.

version

DataRowVersion

Uno de los valores de DataRowVersion que especifica la versión de los datos que se va a obtener. Los valores posibles son Default, Original, Current y Proposed.

Devoluciones

DataRow[]

Matriz de objetos DataRow o una matriz de longitud cero.

Excepciones

ArgumentException

La relación y la fila no pertenecen a la misma tabla.

ArgumentNullException

El valor de relation es null.

RowNotInTableException

La fila no pertenece a la tabla.

VersionNotFoundException

La fila no tiene el DataRowVersion solicitado.

Comentarios

DataTable También contiene una colección de DataRelation objetos devueltos por la ChildRelations propiedad .

Utilice la HasVersion propiedad para determinar si existe el DataRowVersion que desea.

Si Default se especifica , la versión que se usa depende RowState de la de la fila en la que GetChildRows se invoca. Si la fila en la que GetChildRows se invoca tiene un RowState de Modified, Newo Unchanged, la Current versión de la fila se usa para capturar filas secundarias relacionadas con valores coincidentes en sus versiones actuales. Si la fila en la que GetChildRows se invoca tiene un RowState de Deleted, la Original versión de la fila se usa para capturar filas secundarias relacionadas con valores coincidentes en sus versiones originales.