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