DataRow.GetParentRow 方法

參考

定義

命名空間:: System.Data

組件:: System.Data.Common.dll

組件:: System.Data.dll

組件:: netstandard.dll

重要

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

取得 DataRow 的父資料列。

多載

GetParentRow(DataRelation)	使用指定的 DataRow，取得 DataRelation 的父資料列。
GetParentRow(String)	使用 DataRow 的指定 RelationName，取得 DataRelation 的父資料列。
GetParentRow(DataRelation, DataRowVersion)	使用指定的 DataRow 和 DataRelation，取得 DataRowVersion 的父資料列。
GetParentRow(String, DataRowVersion)	使用 DataRow 的指定 RelationName 和 DataRelation，取得 DataRowVersion 的父資料列。

GetParentRow(DataRelation)

來源:: DataRow.cs

來源:: DataRow.cs

來源:: DataRow.cs

使用指定的 DataRow，取得 DataRelation 的父資料列。

public:
 System::Data::DataRow ^ GetParentRow(System::Data::DataRelation ^ relation);

public System.Data.DataRow? GetParentRow (System.Data.DataRelation? relation);

public System.Data.DataRow GetParentRow (System.Data.DataRelation relation);

member this.GetParentRow : System.Data.DataRelation -> System.Data.DataRow

Public Function GetParentRow (relation As DataRelation) As DataRow

參數

relation: DataRelation

要使用的 DataRelation。

傳回

DataRow

目前資料列的父 DataRow。

例外狀況

ArgumentNullException

relation 不屬於 DataTable。

-或-

資料列為 null。

DataException

子資料行有多個父代。

InvalidConstraintException

這個資料列不屬於 DataRelation 物件的子資料表。

RowNotInTableException

資料列不屬於資料表。

範例

下列範例會使用 GetParentRow 傳回中每個子系的DataTable子DataRow DataRelation物件。接著會列印數據列中每個數據行的值。

private void GetParentRowForTable(DataTable thisTable,
    DataRelation relation)
{
    if(thisTable ==null){return;}
    // For each row in the table, print column 1
    // of the parent DataRow.
    DataRow parentRow;
    foreach(DataRow row in thisTable.Rows)
    {
        parentRow = row.GetParentRow(relation);
        Console.Write("\table child row: " + row[1]);
        Console.Write("\table parent row: " + parentRow[1]+ "\n");
    }
}

private void CallGetParentRowForTable()
{
    // An example of calling the function.
    DataTable thisTable = DataSet1.Tables["Products"];
    DataRelation relation = thisTable.ParentRelations[0];
    GetParentRowForTable(thisTable, relation);
}

Private Sub GetParentRowForTable _
   (thisTable As DataTable, relation As DataRelation)
    If thisTable Is Nothing Then
        Return
    End If
    ' For each row in the table, print column 1 
    ' of the parent DataRow.
    Dim parentRow As DataRow
    Dim row As DataRow
    For Each row In  thisTable.Rows
        parentRow = row.GetParentRow(relation)
        Console.Write(ControlChars.Tab & " child row: " _
           & row(1).ToString())
        Console.Write(ControlChars.Tab & " parent row: " _
           & parentRow(1).ToString() & ControlChars.Cr)
    Next row
End Sub
  
Private Sub CallGetParentRowForTable()
    ' An example of calling the function.
    Dim thisTable As DataTable = DataSet1.Tables("Products")
    Dim relation As DataRelation = thisTable.ParentRelations(0)
    GetParentRowForTable(thisTable, relation)
End Sub

備註

在中DataSet，方法會傳GetParentRows回數據集的所有父DataRelation物件集合。

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

另請參閱

適用於

.NET 9 和其他版本

產品	版本
.NET	Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0, 2.1

GetParentRow(String)

來源:: DataRow.cs

來源:: DataRow.cs

來源:: DataRow.cs

使用 DataRow 的指定 RelationName，取得 DataRelation 的父資料列。

public:
 System::Data::DataRow ^ GetParentRow(System::String ^ relationName);

public System.Data.DataRow? GetParentRow (string? relationName);

public System.Data.DataRow GetParentRow (string relationName);

member this.GetParentRow : string -> System.Data.DataRow

Public Function GetParentRow (relationName As String) As DataRow

參數

relationName: String

RelationName 的 DataRelation。

傳回

DataRow

目前資料列的父 DataRow。

例外狀況

ArgumentException

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

DataException

子資料行有多個父代。

RowNotInTableException

資料列不屬於資料表。

範例

下列範例會使用 GetParentRow ，從中DataTable每個 DataRow 的父數據列列印值。

private void GetParentRowForTable(
    DataTable thisTable, string relation)
{
    if(thisTable ==null){return;}
    // For each row in the table, print column 1
    // of the parent DataRow.
    DataRow parentRow;
    foreach(DataRow row in thisTable.Rows)
    {
        parentRow = row.GetParentRow(relation);
        Console.Write("\table child row: " + row[1]);
        Console.Write("\table parent row: " + parentRow[1]+ "\n");
    }
}

private void CallGetParentRowForTable()
{
    // An example of calling the function.
    DataTable thisTable = DataSet1.Tables["Products"];
    DataRelation relation = thisTable.ParentRelations[0];
    GetParentRowForTable(thisTable, relation.RelationName);
}

Private Sub GetParentRowForTable( _
    thisTable As DataTable, relation As String)
     If thisTable Is Nothing Then
         Return
     End If

     ' For each row in the table, print column 1 
     ' of the parent DataRow.
     Dim parentRow As DataRow
     Dim row As DataRow
     For Each row In  thisTable.Rows
         parentRow = row.GetParentRow(relation)
         Console.Write(ControlChars.Tab + " child row: " _
            + row(1).ToString())
         Console.Write(ControlChars.Tab + " parent row: " _
            + parentRow(1).ToString() + ControlChars.Cr)
     Next row
End Sub    
    
Private Sub CallGetParentRowForTable()
     ' An example of calling the function.
     Dim thisTable As DataTable = DataSet1.Tables("Products")
     Dim relation As DataRelation = thisTable.ParentRelations(0)
     GetParentRowForTable(thisTable, relation.RelationName)
End Sub

備註

在中DataSet，方法會傳GetParentRows回數據集的所有父DataRelation物件集合。

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

適用於

.NET 9 和其他版本

產品	版本
.NET	Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0, 2.1

GetParentRow(DataRelation, DataRowVersion)

來源:: DataRow.cs

來源:: DataRow.cs

來源:: DataRow.cs

使用指定的 DataRow 和 DataRelation，取得 DataRowVersion 的父資料列。

public:
 System::Data::DataRow ^ GetParentRow(System::Data::DataRelation ^ relation, System::Data::DataRowVersion version);

public System.Data.DataRow? GetParentRow (System.Data.DataRelation? relation, System.Data.DataRowVersion version);

public System.Data.DataRow GetParentRow (System.Data.DataRelation relation, System.Data.DataRowVersion version);

member this.GetParentRow : System.Data.DataRelation * System.Data.DataRowVersion -> System.Data.DataRow

Public Function GetParentRow (relation As DataRelation, version As DataRowVersion) As DataRow

參數

relation: DataRelation

要使用的 DataRelation。

version: DataRowVersion

其中一個 DataRowVersion 值，指定要取得的資料版本。

傳回

DataRow

目前資料列的父 DataRow。

例外狀況

ArgumentNullException

資料列為 null。

-或-

relation 不屬於這個資料表的父關聯。

DataException

子資料行有多個父代。

InvalidConstraintException

關聯的子資料表不是資料列所屬的資料表。

RowNotInTableException

資料列不屬於資料表。

VersionNotFoundException

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

範例

下列範例會使用 GetParentRow 傳回中每個子系的DataTable子DataRow DataRelation物件。接著會列印數據列中每個數據行的值。

private void GetParentRowForTable(DataTable thisTable,
    DataRelation relation,
    DataRowVersion version)
{
    if(thisTable ==null){return;}
    // For each row in the table, print column 1 of the
    // parent DataRow.
    DataRow parentRow;
    foreach(DataRow row in thisTable.Rows)
    {
        parentRow = row.GetParentRow(relation, version);
        Console.Write("\table child row: " + row[1]);
        Console.Write("\table parent row: " + parentRow[1]+ "\n");
    }
}

private void CallGetParentRowForTable()
{
    // An example of calling the function.
    DataTable thisTable = DataSet1.Tables["Products"];
    DataRelation relation = thisTable.ParentRelations[0];
    // Print only original versions of parent rows.
    GetParentRowForTable(thisTable, relation,
        DataRowVersion.Original);
}

Private Sub GetParentRowForTable _
    (thisTable As DataTable, relation As DataRelation, _
    version As DataRowVersion)
    If thisTable Is Nothing Then
        Return
    End If

    ' For each row in the table, print column 1 
    ' of the parent DataRow.
    Dim parentRow As DataRow
    Dim row As DataRow
    For Each row In  thisTable.Rows
        parentRow = row.GetParentRow(relation, version)
        Console.Write(ControlChars.Tab & " child row: " & _
            row(1).ToString())
        Console.Write(ControlChars.Tab & " parent row: " _
            & parentRow(1).ToString() & ControlChars.Cr)
    Next row
End Sub

Private Sub CallGetParentRowForTable()
    ' An example of calling the function.
    Dim thisTable As DataTable = DataSet1.Tables("Products")
    Dim relation As DataRelation = thisTable.ParentRelations(0)

    ' Print only original versions of parent rows.
    GetParentRowForTable(thisTable, relation, _
        DataRowVersion.Original)
End Sub

備註

在中DataSet，方法會傳GetParentRows回數據集的所有父DataRelation物件集合。

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

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

另請參閱

適用於

.NET 9 和其他版本

產品	版本
.NET	Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0, 2.1

GetParentRow(String, DataRowVersion)

來源:: DataRow.cs

來源:: DataRow.cs

來源:: DataRow.cs

使用 DataRow 的指定 RelationName 和 DataRelation，取得 DataRowVersion 的父資料列。

public:
 System::Data::DataRow ^ GetParentRow(System::String ^ relationName, System::Data::DataRowVersion version);

public System.Data.DataRow? GetParentRow (string? relationName, System.Data.DataRowVersion version);

public System.Data.DataRow GetParentRow (string relationName, System.Data.DataRowVersion version);

member this.GetParentRow : string * System.Data.DataRowVersion -> System.Data.DataRow

Public Function GetParentRow (relationName As String, version As DataRowVersion) As DataRow

參數

relationName: String

RelationName 的 DataRelation。

version: DataRowVersion

其中一個 DataRowVersion 值。

傳回

DataRow

目前資料列的父 DataRow。

例外狀況

ArgumentException

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

ArgumentNullException

relation 為 null。

DataException

子資料行有多個父代。

RowNotInTableException

資料列不屬於資料表。

VersionNotFoundException

資料列沒有要求的 DataRowVersion。

範例

下列範例會使用 GetParentRow ，從中DataTable每個 DataRow 的父數據列列印值。

private void GetParentRowForTable(DataTable thisTable,
    string relation, DataRowVersion version)
{
    if(thisTable ==null){return;}
    // For each row in the table, print column 1
    // of the parent DataRow.
    DataRow parentRow;
    foreach(DataRow row in thisTable.Rows)
    {
        parentRow = row.GetParentRow(relation, version);
        Console.Write("\t child row: " + row[1]);
        Console.Write("\t parent row: " + parentRow[1]+ "\n");
    }
}

private void CallGetParentRowForTable()
{
    // An example of calling the function.
    DataTable thisTable = DataSet1.Tables["Products"];
    DataRelation relation = thisTable.ParentRelations[0];

    // Print only original versions of parent rows.
    GetParentRowForTable(thisTable, relation.RelationName,
        DataRowVersion.Original);
}

Private Sub GetParentRowForTable _
    (thisTable As DataTable, relation As String, _
    version As DataRowVersion)
     If thisTable Is Nothing Then
         Return
     End If
     ' For each row in the table, print column 1 
     ' of the parent DataRow.
     Dim parentRow As DataRow
     Dim row As DataRow
     For Each row In  thisTable.Rows
         parentRow = row.GetParentRow(relation, version)
         Console.Write(ControlChars.Tab & " child row: " _
            & row(1).ToString())
         Console.Write(ControlChars.Tab & " parent row: " _
            & parentRow(1).ToString() & ControlChars.Cr)
     Next row
End Sub
   
Private Sub CallGetParentRowForTable()
     ' An example of calling the function.
     Dim thisTable As DataTable = DataSet1.Tables("Products")
     Dim relation As DataRelation = thisTable.ParentRelations(0)
     ' Print only original versions of parent rows.
     GetParentRowForTable(thisTable, relation.RelationName, _
        DataRowVersion.Original)
End Sub

備註

在中DataSet，方法會傳GetParentRows回數據集的所有父DataRelation物件集合。

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

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

適用於

.NET 9 和其他版本

產品	版本
.NET	Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0, 2.1

分享方式：

DataRow.GetParentRow 方法

定義

多載

GetParentRow(DataRelation)

參數

傳回

例外狀況

範例

備註

另請參閱

適用於

GetParentRow(String)

參數

傳回

例外狀況

範例

備註

適用於

GetParentRow(DataRelation, DataRowVersion)

參數

傳回

例外狀況

範例

備註

另請參閱

適用於

GetParentRow(String, DataRowVersion)

參數

傳回

例外狀況

範例

備註

適用於

更多資源