通过

DataRow.GetChildRows 方法

  • 参考

定义

命名空间:
System.Data
程序集:
System.Data.Common.dll
程序集:
System.Data.dll
程序集:
netstandard.dll

获取 DataRow 的子行。

重载

GetChildRows(DataRelation)

使用指定的 DataRelation 获取此 DataRow 的子行。
GetChildRows(String)

使用 DataRelation 的指定 RelationName 获取 DataRow 的子行。
GetChildRows(DataRelation, DataRowVersion)

使用指定的 DataRelation 和 DataRowVersion 获取 DataRow 的子行。
GetChildRows(String, DataRowVersion)

使用 DataRelation 的指定 RelationName 和 DataRowVersion获取 DataRow 的子行。

GetChildRows(DataRelation)

Source:
DataRow.cs
Source:
DataRow.cs
Source:
DataRow.cs

使用指定的 DataRelation 获取此 DataRow 的子行。

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

一个 DataRow 对象数组，或长度为零的数组。

例外

ArgumentException

关系和行不属于同一个表。

ArgumentNullException

关系为 null。

RowNotInTableException

此行不属于该表。

VersionNotFoundException

该行没有此版本的数据。

示例

以下示例使用 GetChildRows 返回 中每个子DataRow项的DataTable子DataRelation对象。 然后打印行中每列的值。

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还包含 由 ChildRelations 属性返回的 DataRelation 对象的集合。

另请参阅

适用于

GetChildRows(String)

Source:
DataRow.cs
Source:
DataRow.cs
Source:
DataRow.cs

使用 DataRelation 的指定 RelationName 获取 DataRow 的子行。

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

要使用的 DataRelation 的 RelationName。

返回

DataRow[]

一个 DataRow 对象数组，或长度为零的数组。

例外

ArgumentException

关系和行不属于同一个表。

RowNotInTableException

此行不属于该表。

注解

DataTable还包含 由 ChildRelations 属性返回的 DataRelation 对象的集合。

适用于

GetChildRows(DataRelation, DataRowVersion)

Source:
DataRow.cs
Source:
DataRow.cs
Source:
DataRow.cs

使用指定的 DataRelation 和 DataRowVersion 获取 DataRow 的子行。

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

一个 DataRow 对象数组。

例外

ArgumentException

关系和行不属于同一个表。

ArgumentNullException

relation 为 null。

RowNotInTableException

此行不属于该表。

VersionNotFoundException

该行没有请求的 DataRowVersion。

示例

以下示例使用 GetChildRows 返回 中每个子DataRow项的DataTable子DataRelation对象。 然后打印行中具有指定版本的每列的值。

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还包含 由 ChildRelations 属性返回的 DataRelation 对象的集合。

HasVersion使用 属性确定所需的 是否存在DataRowVersion。

如果 Default 指定 ，则使用的版本取决于 RowState 所调用的行 GetChildRows 的 。 如果调用的GetChildRows行具有 、 或 Unchanged的 ， NewRowStateModified则Current该行的版本用于提取具有当前版本中匹配值的相关子行。 如果对其调用的GetChildRows行具有 的 Deleted，RowState则Original该行的版本用于提取具有原始版本中匹配值的相关子行。

另请参阅

适用于

GetChildRows(String, DataRowVersion)

Source:
DataRow.cs
Source:
DataRow.cs
Source:
DataRow.cs

使用 DataRelation 的指定 RelationName 和 DataRowVersion获取 DataRow 的子行。

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

要使用的 DataRelation 的 RelationName。

version
DataRowVersion

DataRowVersion 值之一，指定要获取的数据的版本。 可能值为 Default、Original、Current 和 Proposed。

返回

DataRow[]

一个 DataRow 对象数组，或长度为零的数组。

例外

ArgumentException

关系和行不属于同一个表。

ArgumentNullException

relation 为 null。

RowNotInTableException

此行不属于该表。

VersionNotFoundException

该行没有请求的 DataRowVersion。

注解

DataTable还包含 由 ChildRelations 属性返回的 DataRelation 对象的集合。

HasVersion使用 属性确定所需的 是否存在DataRowVersion。

如果 Default 指定 ，则使用的版本取决于 RowState 所调用的行 GetChildRows 的 。 如果调用的GetChildRows行具有 、 或 Unchanged的 ， NewRowStateModified则Current该行的版本用于提取具有当前版本中匹配值的相关子行。 如果对其调用的GetChildRows行具有 的 Deleted，RowState则Original该行的版本用于提取具有原始版本中匹配值的相关子行。

适用于