DataRow.GetChildRows Methode
Definition
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)
- 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
- ChildRelations
- DataRelation
- DataRowVersion
- GetParentRow(String)
- GetParentRows(String)
- Relations
- Verwenden von DataSets in ADO.NET
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.
