DataRow.GetChildRows Methode

Referenz

Definition

Namespace:: System.Data

Assembly:: System.Data.Common.dll

Assembly:: System.Data.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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)

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

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 das GetChildRows Zurückgeben der untergeordneten DataRow Objekte für jedes untergeordnete Element in einem DataTable.DataRelation 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

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

Siehe auch

Gilt für:

GetChildRows(String)

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

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

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

Gilt für:

GetChildRows(DataRelation, DataRowVersion)

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

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 Element DataRelation in einem DataTableElement zurü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

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

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

Wenn Default angegeben, hängt RowState die verwendete Version von der Zeile GetChildRows ab, auf die aufgerufen wird. Wenn die Zeile, auf der aufgerufen wird, eine RowState von Modified, Newoder Unchanged, wird die Current Version der Zeile GetChildRows zum Abrufen verwandter untergeordneter Zeilen mit übereinstimmenden Werten in ihren aktuellen Versionen verwendet. Wenn die Zeile, auf der aufgerufen wird, eine vonDeleted, RowState wird die Original Version der Zeile GetChildRows zum Abrufen verwandter untergeordneter Zeilen mit übereinstimmenden Werten in ihren ursprünglichen Versionen verwendet.

Siehe auch

Gilt für:

GetChildRows(String, DataRowVersion)

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

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

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

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

Gilt für: