DataRow.GetChildRows DataRow.GetChildRows DataRow.GetChildRows DataRow.GetChildRows Method

Определение

Получает дочерние строки объекта DataRow.Gets the child rows of a DataRow.

Перегрузки

GetChildRows(DataRelation) GetChildRows(DataRelation) GetChildRows(DataRelation) GetChildRows(DataRelation)

Получает дочерние строки этого объекта DataRow с помощью указанного объекта DataRelation.Gets the child rows of this DataRow using the specified DataRelation.

GetChildRows(String) GetChildRows(String) GetChildRows(String) GetChildRows(String)

Получает дочерние строки объекта DataRow с помощью указанного свойства RelationName объекта DataRelation.Gets the child rows of a DataRow using the specified RelationName of a DataRelation.

GetChildRows(DataRelation, DataRowVersion) GetChildRows(DataRelation, DataRowVersion) GetChildRows(DataRelation, DataRowVersion) GetChildRows(DataRelation, DataRowVersion)

Получает дочерние строки объекта DataRow с помощью указанных объектов DataRelation и DataRowVersion.Gets the child rows of a DataRow using the specified DataRelation, and DataRowVersion.

GetChildRows(String, DataRowVersion) GetChildRows(String, DataRowVersion) GetChildRows(String, DataRowVersion) GetChildRows(String, DataRowVersion)

Получает дочерние строки объекта DataRow с помощью указанного свойства RelationName объектов DataRelation и DataRowVersion.Gets the child rows of a DataRow using the specified RelationName of a DataRelation, and DataRowVersion.

GetChildRows(DataRelation) GetChildRows(DataRelation) GetChildRows(DataRelation) GetChildRows(DataRelation)

Получает дочерние строки этого объекта DataRow с помощью указанного объекта DataRelation.Gets the child rows of this DataRow using the specified 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 DataRelation DataRelation

Используемый DataRelation.The DataRelation to use.

Возвраты

Массив объектов DataRow или массив нулевой длины.An array of DataRow objects or an array of length zero.

Исключения

Отношение и строка не принадлежат одной и той же таблице.The relation and row do not belong to the same table.

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

Строка не принадлежит таблице.The row does not belong to the table.

Строка не содержит эту версию данных.The row does not have this version of data.

Примеры

В следующем примере используется GetChildRows чтобы вернуть дочерние DataRow объекты для каждого дочернего DataRelation в DataTable.The following example uses the GetChildRows to return the child DataRow objects for every child DataRelation in a DataTable. Затем выводит значение каждого столбца в строке.The value of each column in the row is then printed.

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 свойство.The DataTable also contains a collection of DataRelation objects that is returned by the ChildRelations property.

Дополнительно

GetChildRows(String) GetChildRows(String) GetChildRows(String) GetChildRows(String)

Получает дочерние строки объекта DataRow с помощью указанного свойства RelationName объекта DataRelation.Gets the child rows of a DataRow using the specified RelationName of a 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 String String String

Используемое свойство RelationName объекта DataRelation.The RelationName of the DataRelation to use.

Возвраты

Массив объектов DataRow или массив нулевой длины.An array of DataRow objects or an array of length zero.

Исключения

Отношение и строка не принадлежат одной и той же таблице.The relation and row do not belong to the same table.

Строка не принадлежит таблице.The row does not belong to the table.

Комментарии

DataTable Также содержит коллекцию DataRelation объектов, возвращаемый методом ChildRelations свойство.The DataTable also contains a collection of DataRelation objects that is returned by the ChildRelations property.

GetChildRows(DataRelation, DataRowVersion) GetChildRows(DataRelation, DataRowVersion) GetChildRows(DataRelation, DataRowVersion) GetChildRows(DataRelation, DataRowVersion)

Получает дочерние строки объекта DataRow с помощью указанных объектов DataRelation и DataRowVersion.Gets the child rows of a DataRow using the specified DataRelation, and 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 DataRelation DataRelation

Используемый DataRelation.The DataRelation to use.

version
DataRowVersion DataRowVersion DataRowVersion DataRowVersion

Одно из значений DataRowVersion, указывающих версию получаемых данных.One of the DataRowVersion values specifying the version of the data to get. Допустимые значения: Default, Original, Current и Proposed.Possible values are Default, Original, Current, and Proposed.

Возвраты

Массив объектов DataRow.An array of DataRow objects.

Исключения

Отношение и строка не принадлежат одной и той же таблице.The relation and row do not belong to the same table.

Значение параметра relationnull.The relation is null.

Строка не принадлежит таблице.The row does not belong to the table.

Строка не имеет запрошенного объекта DataRowVersion.The row does not have the requested DataRowVersion.

Примеры

В следующем примере используется GetChildRows чтобы вернуть дочерние DataRow объекты для каждого дочернего DataRelation в DataTable.The following example uses the GetChildRows to return the child DataRow objects for every child DataRelation in a DataTable. Затем выводит значение каждого столбца с указанной версией в строке.The value of each column with the specified version in the row is then printed.

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 свойство.The DataTable also contains a collection of DataRelation objects that is returned by the ChildRelations property.

Используйте HasVersion свойства, чтобы определить ли DataRowVersion возникает необходимость существует.Use the HasVersion property to determine whether the DataRowVersion that you want exists.

Если Default указан, зависит от версии, которая используется RowState строки, на котором GetChildRows вызывается.If Default is specified, the version that is used depends on the RowState of the row on which GetChildRows is invoked. Если строки, на которой GetChildRows вызывается имеет RowState из Modified, New, или Unchanged, Current версии строки используется для получения связанных дочерних строк с совпадающими значениями в своей текущей версии.If the row on which GetChildRows is invoked has a RowState of Modified, New, or Unchanged, the Current version of the row is used for fetching related child rows with matching values in their Current versions. Если строки, на которой GetChildRows вызывается имеет RowState из Deleted, Original версии строки используется для получения связанных дочерних строк с совпадающими значениями исходные версии.If the row on which GetChildRows is invoked has a RowState of Deleted, the Original version of the row is used for fetching related child rows with matching values in their original versions.

Дополнительно

GetChildRows(String, DataRowVersion) GetChildRows(String, DataRowVersion) GetChildRows(String, DataRowVersion) GetChildRows(String, DataRowVersion)

Получает дочерние строки объекта DataRow с помощью указанного свойства RelationName объектов DataRelation и DataRowVersion.Gets the child rows of a DataRow using the specified RelationName of a DataRelation, and 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 String String String

Используемое свойство RelationName объекта DataRelation.The RelationName of the DataRelation to use.

version
DataRowVersion DataRowVersion DataRowVersion DataRowVersion

Одно из значений DataRowVersion, указывающих версию получаемых данных.One of the DataRowVersion values specifying the version of the data to get. Допустимые значения: Default, Original, Current и Proposed.Possible values are Default, Original, Current, and Proposed.

Возвраты

Массив объектов DataRow или массив нулевой длины.An array of DataRow objects or an array of length zero.

Исключения

Отношение и строка не принадлежат одной и той же таблице.The relation and row do not belong to the same table.

Значение параметра relationnull.The relation is null.

Строка не принадлежит таблице.The row does not belong to the table.

Строка не имеет запрошенного объекта DataRowVersion.The row does not have the requested DataRowVersion.

Комментарии

DataTable Также содержит коллекцию DataRelation объектов, возвращаемый методом ChildRelations свойство.The DataTable also contains a collection of DataRelation objects that is returned by the ChildRelations property.

Используйте HasVersion свойства, чтобы определить ли DataRowVersion возникает необходимость существует.Use the HasVersion property to determine whether the DataRowVersion that you want exists.

Если Default указан, зависит от версии, которая используется RowState строки, на котором GetChildRows вызывается.If Default is specified, the version that is used depends on the RowState of the row on which GetChildRows is invoked. Если строки, на которой GetChildRows вызывается имеет RowState из Modified, New, или Unchanged, Current версии строки используется для получения связанных дочерних строк с совпадающими значениями в своей текущей версии.If the row on which GetChildRows is invoked has a RowState of Modified, New, or Unchanged, the Current version of the row is used for fetching related child rows with matching values in their Current versions. Если строки, на которой GetChildRows вызывается имеет RowState из Deleted, Original версии строки используется для получения связанных дочерних строк с совпадающими значениями исходные версии.If the row on which GetChildRows is invoked has a RowState of Deleted, the Original version of the row is used for fetching related child rows with matching values in their original versions.

Применяется к