DataRow.GetChildRows 方法

參考

定義

命名空間:: System.Data

組件:: System.Data.Common.dll

組件:: System.Data.dll

組件:: netstandard.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

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

DataRow 物件的陣列，或是長度為零的陣列。

例外狀況

ArgumentException

關聯和資料列不屬於相同資料表。

ArgumentNullException

relation 為 null。

RowNotInTableException

資料列不屬於資料表。

VersionNotFoundException

資料列沒有這個版本的資料。

範例

下列範例會使用傳GetChildRows回中每個子系的DataTable子DataRow 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)

來源:: 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[]

DataRow 物件的陣列，或是長度為零的陣列。

例外狀況

ArgumentException

關聯和資料列不屬於相同資料表。

RowNotInTableException

資料列不屬於資料表。

備註

DataTable也包含屬性所ChildRelations傳回之 DataRelation 物件的集合。

適用於

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

DataRow 物件的陣列。

例外狀況

ArgumentException

關聯和資料列不屬於相同資料表。

ArgumentNullException

relation 為 null。

RowNotInTableException

資料列不屬於資料表。

VersionNotFoundException

資料列沒有要求的 DataRowVersion。

範例

下列範例會使用傳GetChildRows回中每個子系的DataTable子DataRow 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列具有 ModifiedRowState 、或 Unchanged的，New則Current數據列的版本會用於擷取其目前版本中具有相符值的相關子數據列。如果叫用的數據列具有 RowState 的 Deleted，則Original數據列GetChildRows的版本會用於擷取原始版本中具有相符值的相關子數據列。

另請參閱

適用於

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

DataRow 物件的陣列，或是長度為零的陣列。

例外狀況

ArgumentException

關聯和資料列不屬於相同資料表。

ArgumentNullException

relation 為 null。

RowNotInTableException

資料列不屬於資料表。

VersionNotFoundException

資料列沒有要求的 DataRowVersion。

備註

DataTable也包含屬性所ChildRelations傳回之 DataRelation 物件的集合。

HasVersion使用屬性來判斷您想要的是否存在DataRowVersion。

適用於

共用方式為

DataRow.GetChildRows 方法

定義

多載

GetChildRows(DataRelation)

參數

傳回

例外狀況

範例

備註

另請參閱

適用於

GetChildRows(String)

參數

傳回

例外狀況

備註

適用於

GetChildRows(DataRelation, DataRowVersion)

參數

傳回

例外狀況

範例

備註

另請參閱

適用於

GetChildRows(String, DataRowVersion)

參數

傳回

例外狀況

備註

適用於

其他資源