DataRow.GetChildRows Methode

Definition

Namespace:

System.Data

Assembly:

System.Data.Common.dll

Ruft die untergeordneten Zeilen einer DataRow ab.

Überlädt

GetChildRows(DataRelation)	Ruft unter Verwendung der angegebenen DataRow die untergeordneten Zeilen dieser DataRelation ab.
GetChildRows(String)	Ruft unter Verwendung des angegebenen DataRow einer RelationName die untergeordneten Zeilen einer DataRelation ab.
GetChildRows(DataRelation, DataRowVersion)	Ruft unter Verwendung der angegebenen DataRow und DataRelation die untergeordneten Zeilen einer DataRowVersion ab.
GetChildRows(String, DataRowVersion)	Ruft unter Verwendung des angegebenen DataRow einer RelationName und einer DataRelation die untergeordneten Zeilen einer DataRowVersion ab.

GetChildRows(DataRelation)

Quelle:

DataRow.cs

Ruft unter Verwendung der angegebenen DataRow die untergeordneten Zeilen dieser DataRelation ab.

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()

Parameter

relation

DataRelation

Der zu verwendende DataRelation.

Gibt zurück

DataRow[]

Ein Array von DataRow-Objekten oder ein Array der Länge 0.

Ausnahmen

ArgumentException

Die Beziehung und die Zeile gehören nicht zu derselben Tabelle.

ArgumentNullException

Die Beziehung ist null.

RowNotInTableException

Die Zeile gehört nicht zu der Tabelle.

VersionNotFoundException

In der Zeile ist diese Version der Daten nicht enthalten.

Beispiele

Im folgenden Beispiel wird verwendet, GetChildRows um die untergeordneten DataRow Objekte für jedes untergeordnete DataRelation Objekt in einem DataTablezurückzugeben. Der Wert jeder Spalte in der Zeile wird dann gedruckt.

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

Hinweise

DataTable Enthält auch eine Auflistung von DataRelation -Objekten, die von der ChildRelations -Eigenschaft zurückgegeben werden.

Weitere Informationen

• ChildRelations
• DataRelation
• GetParentRows(String)
• Relations
• Verwenden von DataSets in ADO.NET

GetChildRows(String)

Quelle:

DataRow.cs

Ruft unter Verwendung des angegebenen DataRow einer RelationName die untergeordneten Zeilen einer DataRelation ab.

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()

Parameter

relationName

String

Der RelationName der zu verwendenden DataRelation.

Gibt zurück

DataRow[]

Ein Array von DataRow-Objekten oder ein Array der Länge 0.

Ausnahmen

ArgumentException

Die Beziehung und die Zeile gehören nicht zu derselben Tabelle.

RowNotInTableException

Die Zeile gehört nicht zu der Tabelle.

Hinweise

DataTable Enthält auch eine Auflistung von DataRelation -Objekten, die von der ChildRelations -Eigenschaft zurückgegeben werden.

GetChildRows(DataRelation, DataRowVersion)

Quelle:

DataRow.cs

Ruft unter Verwendung der angegebenen DataRow und DataRelation die untergeordneten Zeilen einer DataRowVersion ab.

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()

Parameter

relation

DataRelation

Der zu verwendende DataRelation.

version

DataRowVersion

Einer der DataRowVersion-Werte, der die Version der abzurufenden Daten angibt. Mögliche Werte sind Default, Original, Current und Proposed.

Gibt zurück

DataRow[]

Ein Array von DataRow-Objekten.

Ausnahmen

ArgumentException

Die Beziehung und die Zeile gehören nicht zu derselben Tabelle.

ArgumentNullException

relation ist null.

RowNotInTableException

Die Zeile gehört nicht zu der Tabelle.

VersionNotFoundException

Die Zeile verfügt nicht über die angeforderte DataRowVersion.

Beispiele

Im folgenden Beispiel wird verwendet, GetChildRows um die untergeordneten DataRow Objekte für jedes untergeordnete DataRelation Objekt in einem DataTablezurückzugeben. Der Wert jeder Spalte mit der angegebenen Version in der Zeile wird dann gedruckt.

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

Hinweise

DataTable Enthält auch eine Auflistung von DataRelation -Objekten, die von der ChildRelations -Eigenschaft zurückgegeben werden.

Verwenden Sie die HasVersion -Eigenschaft, um zu bestimmen, ob das DataRowVersion gewünschte vorhanden ist.

Wenn Default angegeben ist, hängt die verwendete Version von der RowState der Zeile ab, für die GetChildRows aufgerufen wird. Wenn die Zeile, für die aufgerufen wird, GetChildRows einen RowState von Modified, Newoder Unchangedaufweist, wird die Current Version der Zeile zum Abrufen verwandter untergeordneter Zeilen mit übereinstimmenden Werten in ihren Aktuellen Versionen verwendet. Wenn die Zeile, für die aufgerufen wird, GetChildRows einen RowState von Deletedaufweist, wird die Original Version der Zeile zum Abrufen verwandter untergeordneter Zeilen mit übereinstimmenden Werten in den ursprünglichen Versionen verwendet.

Weitere Informationen

• ChildRelations
• DataRelation
• DataRowVersion
• GetParentRow(String)
• GetParentRows(String)
• Relations
• Verwenden von DataSets in ADO.NET

GetChildRows(String, DataRowVersion)

Quelle:

DataRow.cs

Ruft unter Verwendung des angegebenen DataRow einer RelationName und einer DataRelation die untergeordneten Zeilen einer DataRowVersion ab.

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()

Parameter

relationName

String

Der RelationName der zu verwendenden DataRelation.

version

DataRowVersion

Einer der DataRowVersion-Werte, der die Version der abzurufenden Daten angibt. Mögliche Werte sind Default, Original, Current und Proposed.

Gibt zurück

DataRow[]

Ein Array von DataRow-Objekten oder ein Array der Länge 0.

Ausnahmen

ArgumentException

Die Beziehung und die Zeile gehören nicht zu derselben Tabelle.

ArgumentNullException

relation ist null.

RowNotInTableException

Die Zeile gehört nicht zu der Tabelle.

VersionNotFoundException

Die Zeile verfügt nicht über die angeforderte DataRowVersion.

Hinweise

DataTable Enthält auch eine Auflistung von DataRelation -Objekten, die von der ChildRelations -Eigenschaft zurückgegeben werden.

Verwenden Sie die HasVersion -Eigenschaft, um zu bestimmen, ob das DataRowVersion gewünschte vorhanden ist.

Wenn Default angegeben ist, hängt die verwendete Version von der RowState der Zeile ab, für die GetChildRows aufgerufen wird. Wenn die Zeile, für die aufgerufen wird, GetChildRows einen RowState von Modified, Newoder Unchangedaufweist, wird die Current Version der Zeile zum Abrufen verwandter untergeordneter Zeilen mit übereinstimmenden Werten in ihren Aktuellen Versionen verwendet. Wenn die Zeile, für die aufgerufen wird, GetChildRows einen RowState von Deletedaufweist, wird die Original Version der Zeile zum Abrufen verwandter untergeordneter Zeilen mit übereinstimmenden Werten in den ursprünglichen Versionen verwendet.