DataRow.GetChildRows Metoda

Definice

Obor názvů:

System.Data

Sestavení:

System.Data.Common.dll

Získá podřízené řádky objektu DataRow.

Přetížení

GetChildRows(DataRelation)	Získá podřízené řádky tohoto DataRow objektu pomocí zadaného DataRelation.
GetChildRows(String)	Získá podřízené řádky objektu DataRow pomocí zadaného RelationName objektu DataRelation.
GetChildRows(DataRelation, DataRowVersion)	Získá podřízené řádky objektu DataRow pomocí zadaných DataRelationa DataRowVersion.
GetChildRows(String, DataRowVersion)	Získá podřízené řádky objektu DataRow pomocí zadaného RelationName objektu DataRelationa DataRowVersion.

GetChildRows(DataRelation)

Zdroj:

DataRow.cs

Získá podřízené řádky tohoto DataRow objektu pomocí zadaného 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()

Parametry

relation

DataRelation

Hodnota, DataRelation která se má použít.

Návraty

DataRow[]

Pole DataRow objektů nebo pole nulové délky.

Výjimky

ArgumentException

Relace a řádek nepatří do stejné tabulky.

ArgumentNullException

Relace je null.

RowNotInTableException

Řádek nepatří do tabulky.

VersionNotFoundException

Řádek nemá tuto verzi dat.

Příklady

Následující příklad používá GetChildRows k vrácení podřízených DataRow objektů pro každý podřízený DataRelation objekt v objektu DataTable. Hodnota každého sloupce v řádku je pak vytištěna.

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

Poznámky

Obsahuje DataTable také kolekci DataRelation objektů, které jsou vráceny ChildRelations vlastností .

Viz také

• ChildRelations
• DataRelation
• GetParentRows(String)
• Relations
• Použití datových sad v ADO.NET

GetChildRows(String)

Zdroj:

DataRow.cs

Získá podřízené řádky objektu DataRow pomocí zadaného RelationName objektu 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()

Parametry

relationName

String

Hodnota RelationName , která DataRelation se má použít.

Návraty

DataRow[]

Pole DataRow objektů nebo pole nulové délky.

Výjimky

ArgumentException

Relace a řádek nepatří do stejné tabulky.

RowNotInTableException

Řádek nepatří do tabulky.

Poznámky

Obsahuje DataTable také kolekci DataRelation objektů, které jsou vráceny ChildRelations vlastností .

GetChildRows(DataRelation, DataRowVersion)

Zdroj:

DataRow.cs

Získá podřízené řádky objektu DataRow pomocí zadaných DataRelationa 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()

Parametry

relation

DataRelation

Hodnota, DataRelation která se má použít.

version

DataRowVersion

Jedna z DataRowVersion hodnot určující verzi dat, která se mají získat. Možné hodnoty jsou Default, Original, Currenta Proposed.

Návraty

DataRow[]

Pole DataRow objektů.

Výjimky

ArgumentException

Relace a řádek nepatří do stejné tabulky.

ArgumentNullException

Hodnota relation je null.

RowNotInTableException

Řádek nepatří do tabulky.

VersionNotFoundException

Řádek neobsahuje požadovaný DataRowVersion.

Příklady

Následující příklad používá GetChildRows k vrácení podřízených DataRow objektů pro každý podřízený DataRelation objekt v objektu DataTable. Potom se vytiskne hodnota každého sloupce se zadanou verzí v řádku.

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

Poznámky

Obsahuje DataTable také kolekci DataRelation objektů, které jsou vráceny ChildRelations vlastností .

HasVersion Pomocí vlastnosti určete, zda DataRowVersion požadovaná hodnota existuje.

Pokud Default je zadán, verze, která se používá, závisí na RowState řádku, na kterém GetChildRows je vyvolána. Pokud řádek, na kterém GetChildRows je vyvolána, má RowStateModifiedhodnotu , Newnebo Unchanged, Current použije se verze řádku pro načtení souvisejících podřízených řádků s odpovídajícími hodnotami v jejich aktuálních verzích. Pokud má řádek, na kterém GetChildRows je vyvolána RowStateDeleted, Original verze řádku se použije k načtení souvisejících podřízených řádků s odpovídajícími hodnotami v jejich původních verzích.

Viz také

• ChildRelations
• DataRelation
• DataRowVersion
• GetParentRow(String)
• GetParentRows(String)
• Relations
• Použití datových sad v ADO.NET

GetChildRows(String, DataRowVersion)

Zdroj:

DataRow.cs

Získá podřízené řádky objektu DataRow pomocí zadaného RelationName objektu DataRelationa 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()

Parametry

relationName

String

Hodnota RelationName , která DataRelation se má použít.

version

DataRowVersion

Jedna z DataRowVersion hodnot určující verzi dat, která se mají získat. Možné hodnoty jsou Default, Original, Currenta Proposed.

Návraty

DataRow[]

Pole DataRow objektů nebo pole nulové délky.

Výjimky

ArgumentException

Relace a řádek nepatří do stejné tabulky.

ArgumentNullException

Hodnota relation je null.

RowNotInTableException

Řádek nepatří do tabulky.

VersionNotFoundException

Řádek neobsahuje požadovaný DataRowVersion.

Poznámky

Obsahuje DataTable také kolekci DataRelation objektů, které jsou vráceny ChildRelations vlastností .

HasVersion Pomocí vlastnosti určete, zda DataRowVersion požadovaná hodnota existuje.

Pokud Default je zadán, verze, která se používá, závisí na RowState řádku, na kterém GetChildRows je vyvolána. Pokud řádek, na kterém GetChildRows je vyvolána, má RowStateModifiedhodnotu , Newnebo Unchanged, Current použije se verze řádku pro načtení souvisejících podřízených řádků s odpovídajícími hodnotami v jejich aktuálních verzích. Pokud má řádek, na kterém GetChildRows je vyvolána RowStateDeleted, Original verze řádku se použije k načtení souvisejících podřízených řádků s odpovídajícími hodnotami v jejich původních verzích.