DataRow.GetChildRows Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает дочерние строки объекта DataRow.
Перегрузки
| Имя | Описание |
|---|---|
| GetChildRows(DataRelation) |
Возвращает дочерние строки этого DataRow с помощью указанного DataRelation. |
| GetChildRows(String) |
Возвращает дочерние строки DataRow из указанного DataRelationзначенияRelationName. |
| GetChildRows(DataRelation, DataRowVersion) |
Возвращает дочерние строки указанного DataRow значения DataRelationи DataRowVersion. |
| GetChildRows(String, DataRowVersion) |
Получает дочерние строки с использованием указанного DataRowDataRelationзначения RelationName , а также DataRowVersion. |
GetChildRows(DataRelation)
- Исходный код:
- DataRow.cs
- Исходный код:
- DataRow.cs
- Исходный код:
- DataRow.cs
- Исходный код:
- DataRow.cs
- Исходный код:
- DataRow.cs
Возвращает дочерние строки этого DataRow с помощью указанного DataRelation.
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()
Параметры
- relation
- DataRelation
Используется DataRelation .
Возвращаемое значение
Массив объектов или массив DataRow нулевой длины.
Исключения
Отношение и строка не принадлежат той же таблице.
Отношение равно null.
Строка не принадлежит таблице.
Строка не имеет этой версии данных.
Примеры
В следующем примере используется GetChildRows для возврата дочерних DataRow объектов для каждого дочернего DataRelation объекта в объекте DataTable. Затем выводится значение каждого столбца в строке.
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
Комментарии
Также DataTable содержит коллекцию DataRelation объектов, возвращаемых свойством ChildRelations .
См. также раздел
Применяется к
GetChildRows(String)
- Исходный код:
- DataRow.cs
- Исходный код:
- DataRow.cs
- Исходный код:
- DataRow.cs
- Исходный код:
- DataRow.cs
- Исходный код:
- DataRow.cs
Возвращает дочерние строки DataRow из указанного DataRelationзначенияRelationName.
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()
Параметры
- relationName
- String
Используемое RelationNameDataRelation значение.
Возвращаемое значение
Массив объектов или массив DataRow нулевой длины.
Исключения
Отношение и строка не принадлежат той же таблице.
Строка не принадлежит таблице.
Комментарии
Также DataTable содержит коллекцию DataRelation объектов, возвращаемых свойством ChildRelations .
Применяется к
GetChildRows(DataRelation, DataRowVersion)
- Исходный код:
- DataRow.cs
- Исходный код:
- DataRow.cs
- Исходный код:
- DataRow.cs
- Исходный код:
- DataRow.cs
- Исходный код:
- DataRow.cs
Возвращает дочерние строки указанного DataRow значения DataRelationи 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);
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()
Параметры
- relation
- DataRelation
Используется DataRelation .
- version
- DataRowVersion
Одно из DataRowVersion значений, указывающее версию данных для получения. Возможные значения: Default, Original, Current и Proposed.
Возвращаемое значение
Массив объектов DataRow.
Исключения
Отношение и строка не принадлежат той же таблице.
Значение параметра relation — null.
Строка не принадлежит таблице.
Строка не содержит запрошенную строку DataRowVersion.
Примеры
В следующем примере используется GetChildRows для возврата дочерних DataRow объектов для каждого дочернего DataRelation объекта в объекте DataTable. Затем выводится значение каждого столбца с указанной версией в строке.
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
Комментарии
Также DataTable содержит коллекцию DataRelation объектов, возвращаемых свойством ChildRelations .
HasVersion Используйте свойство, чтобы определить, существует ли DataRowVersion нужное свойство.
Если Default задано, используемая версия зависит от RowState строки, в которой GetChildRows вызывается. Если строка, в которой GetChildRows вызывается, имеет значение RowStateModified, Newили UnchangedCurrent версия строки используется для получения связанных дочерних строк с соответствующими значениями в их текущих версиях. Если строка, в которой GetChildRows вызывается, используется RowStateDeletedOriginal версия строки для получения связанных дочерних строк с соответствующими значениями в исходных версиях.
См. также раздел
- ChildRelations
- DataRelation
- DataRowVersion
- GetParentRow(String)
- GetParentRows(String)
- Relations
- Использование наборов данных в ADO.NET
Применяется к
GetChildRows(String, DataRowVersion)
- Исходный код:
- DataRow.cs
- Исходный код:
- DataRow.cs
- Исходный код:
- DataRow.cs
- Исходный код:
- DataRow.cs
- Исходный код:
- DataRow.cs
Получает дочерние строки с использованием указанного DataRowDataRelationзначения RelationName , а также 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);
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()
Параметры
- relationName
- String
Используемое RelationNameDataRelation значение.
- version
- DataRowVersion
Одно из DataRowVersion значений, указывающее версию данных для получения. Возможные значения: Default, Original, Current и Proposed.
Возвращаемое значение
Массив объектов или массив DataRow нулевой длины.
Исключения
Отношение и строка не принадлежат той же таблице.
Строка не принадлежит таблице.
Строка не содержит запрошенную строку DataRowVersion.
Комментарии
Также DataTable содержит коллекцию DataRelation объектов, возвращаемых свойством ChildRelations .
HasVersion Используйте свойство, чтобы определить, существует ли DataRowVersion нужное свойство.
Если Default задано, используемая версия зависит от RowState строки, в которой GetChildRows вызывается. Если строка, в которой GetChildRows вызывается, имеет значение RowStateModified, Newили UnchangedCurrent версия строки используется для получения связанных дочерних строк с соответствующими значениями в их текущих версиях. Если строка, в которой GetChildRows вызывается, используется RowStateDeletedOriginal версия строки для получения связанных дочерних строк с соответствующими значениями в исходных версиях.