DataRow.GetChildRows Метод

Определение

Пространство имен:

System.Data

Сборка:

System.Data.Common.dll

Получает дочерние строки объекта 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 с помощью указанного объекта DataRelation.

public:
 cli::array <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[]

Массив объектов DataRow или массив нулевой длины.

Исключения

ArgumentException

Отношение и строка не принадлежат одной и той же таблице.

ArgumentNullException

Значением отношения является null.

RowNotInTableException

Строка не принадлежит таблице.

VersionNotFoundException

Строка не содержит эту версию данных.

Примеры

В следующем примере используется 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 .

См. также раздел

• ChildRelations
• DataRelation
• GetParentRows(String)
• Relations
• Использование наборов данных в ADO.NET

GetChildRows(String)

Исходный код:

DataRow.cs

Получает дочерние строки объекта DataRow с помощью указанного свойства RelationName объекта DataRelation.

public:
 cli::array <System::Data::DataRow ^> ^ GetChildRows(System::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[]

Массив объектов DataRow или массив нулевой длины.

Исключения

ArgumentException

Отношение и строка не принадлежат одной и той же таблице.

RowNotInTableException

Строка не принадлежит таблице.

Комментарии

Также DataTable содержит коллекцию DataRelation объектов, возвращаемых свойством ChildRelations .

GetChildRows(DataRelation, DataRowVersion)

Исходный код:

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

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[]

Массив объектов DataRow.

Исключения

ArgumentException

Отношение и строка не принадлежат одной и той же таблице.

ArgumentNullException

Значение параметра relation — null.

RowNotInTableException

Строка не принадлежит таблице.

VersionNotFoundException

Строка не имеет запрошенного объекта 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 имеет RowStateModifiedзначение , Newили Unchanged, Current версия строки используется для получения связанных дочерних строк с соответствующими значениями в текущих версиях. Если строка, для которой GetChildRows вызывается, имеет RowStateDeletedзначение , Original версия строки используется для получения связанных дочерних строк с соответствующими значениями в исходных версиях.

См. также раздел

• ChildRelations
• DataRelation
• DataRowVersion
• GetParentRow(String)
• GetParentRows(String)
• Relations
• Использование наборов данных в ADO.NET

GetChildRows(String, DataRowVersion)

Исходный код:

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

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[]

Массив объектов DataRow или массив нулевой длины.

Исключения

ArgumentException

Отношение и строка не принадлежат одной и той же таблице.

ArgumentNullException

Значение параметра relation — null.

RowNotInTableException

Строка не принадлежит таблице.

VersionNotFoundException

Строка не имеет запрошенного объекта DataRowVersion.

Комментарии

Также DataTable содержит коллекцию DataRelation объектов, возвращаемых свойством ChildRelations .

Используйте свойство , HasVersion чтобы определить, существует ли нужный DataRowVersion объект .

Если Default указан параметр , используемая версия зависит RowState от строки, в которой GetChildRows вызывается . Если вызываемая строка GetChildRows имеет RowStateModifiedзначение , Newили Unchanged, Current версия строки используется для получения связанных дочерних строк с соответствующими значениями в текущих версиях. Если строка, для которой GetChildRows вызывается, имеет RowStateDeletedзначение , Original версия строки используется для получения связанных дочерних строк с соответствующими значениями в исходных версиях.