Freigeben über


DataRow.GetChildRows Methode

Definition

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
Quelle:
DataRow.cs
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);
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

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

Ausnahmen

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

Die Beziehung ist null.

Die Zeile gehört nicht zu der Tabelle.

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

Gilt für:

GetChildRows(String)

Quelle:
DataRow.cs
Quelle:
DataRow.cs
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);
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

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

Ausnahmen

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

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.

Gilt für:

GetChildRows(DataRelation, DataRowVersion)

Quelle:
DataRow.cs
Quelle:
DataRow.cs
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);
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

Ein Array von DataRow-Objekten.

Ausnahmen

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

relation ist null.

Die Zeile gehört nicht zu der Tabelle.

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

Gilt für:

GetChildRows(String, DataRowVersion)

Quelle:
DataRow.cs
Quelle:
DataRow.cs
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);
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

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

Ausnahmen

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

relation ist null.

Die Zeile gehört nicht zu der Tabelle.

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.

Gilt für: