DataRow.GetChildRows Metoda

Definicja

Pobiera podrzędne wiersze obiektu DataRow .Gets the child rows of a DataRow.

Przeciążenia

GetChildRows(DataRelation)

Pobiera podrzędne wiersze tego DataRow przy użyciu określonego elementu DataRelation .Gets the child rows of this DataRow using the specified DataRelation.

GetChildRows(String)

Pobiera wiersze podrzędne z DataRow przy użyciu określonego elementu RelationName DataRelation .Gets the child rows of a DataRow using the specified RelationName of a DataRelation.

GetChildRows(DataRelation, DataRowVersion)

Pobiera wiersze podrzędne DataRow przy użyciu określonych elementów DataRelation i DataRowVersion .Gets the child rows of a DataRow using the specified DataRelation, and DataRowVersion.

GetChildRows(String, DataRowVersion)

Pobiera wiersze podrzędne z DataRow przy użyciu określonych RelationName elementów DataRelation i DataRowVersion .Gets the child rows of a DataRow using the specified RelationName of a DataRelation, and DataRowVersion.

GetChildRows(DataRelation)

Pobiera podrzędne wiersze tego DataRow przy użyciu określonego elementu 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);
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()

Parametry

relation
DataRelation

DataRelationDo użycia.The DataRelation to use.

Zwraca

DataRow[]

Tablica DataRow obiektów lub tablica o długości zero.An array of DataRow objects or an array of length zero.

Wyjątki

Relacja i wiersz nie należą do tej samej tabeli.The relation and row do not belong to the same table.

Relacja wynosi null .The relation is null.

Wiersz nie należy do tabeli.The row does not belong to the table.

Wiersz nie ma tej wersji danych.The row does not have this version of data.

Przykłady

Poniższy przykład używa GetChildRows do zwracania DataRow obiektów podrzędnych dla każdego elementu podrzędnego DataRelation w DataTable .The following example uses the GetChildRows to return the child DataRow objects for every child DataRelation in a DataTable. Następnie drukowana jest wartość każdej kolumny w wierszu.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

Uwagi

DataTableZawiera również kolekcję DataRelation obiektów, które są zwracane przez ChildRelations Właściwość.The DataTable also contains a collection of DataRelation objects that is returned by the ChildRelations property.

Zobacz też

Dotyczy

GetChildRows(String)

Pobiera wiersze podrzędne z DataRow przy użyciu określonego elementu 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);
public System.Data.DataRow[] GetChildRows (string relationName);
member this.GetChildRows : string -> System.Data.DataRow[]
Public Function GetChildRows (relationName As String) As DataRow()

Parametry

relationName
String

Do RelationName DataRelation użycia.The RelationName of the DataRelation to use.

Zwraca

DataRow[]

Tablica DataRow obiektów lub tablica o długości zero.An array of DataRow objects or an array of length zero.

Wyjątki

Relacja i wiersz nie należą do tej samej tabeli.The relation and row do not belong to the same table.

Wiersz nie należy do tabeli.The row does not belong to the table.

Uwagi

DataTableZawiera również kolekcję DataRelation obiektów, które są zwracane przez ChildRelations Właściwość.The DataTable also contains a collection of DataRelation objects that is returned by the ChildRelations property.

Dotyczy

GetChildRows(DataRelation, DataRowVersion)

Pobiera wiersze podrzędne DataRow przy użyciu określonych elementów DataRelation i 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);
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()

Parametry

relation
DataRelation

DataRelationDo użycia.The DataRelation to use.

version
DataRowVersion

Jedna z DataRowVersion wartości określająca wersję danych do pobrania.One of the DataRowVersion values specifying the version of the data to get. Możliwe wartości to Default , Original , Current , i Proposed .Possible values are Default, Original, Current, and Proposed.

Zwraca

DataRow[]

Tablica DataRow obiektów.An array of DataRow objects.

Wyjątki

Relacja i wiersz nie należą do tej samej tabeli.The relation and row do not belong to the same table.

relationMa wartość null .The relation is null.

Wiersz nie należy do tabeli.The row does not belong to the table.

Wiersz nie ma żądanego żądania DataRowVersion .The row does not have the requested DataRowVersion.

Przykłady

Poniższy przykład używa GetChildRows do zwracania DataRow obiektów podrzędnych dla każdego elementu podrzędnego DataRelation w DataTable .The following example uses the GetChildRows to return the child DataRow objects for every child DataRelation in a DataTable. Zostanie wydrukowany wartość każdej kolumny z określoną wersją w wierszu.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

Uwagi

DataTableZawiera również kolekcję DataRelation obiektów, które są zwracane przez ChildRelations Właściwość.The DataTable also contains a collection of DataRelation objects that is returned by the ChildRelations property.

Użyj HasVersion właściwości, aby określić, czy DataRowVersion ma ona istnieć.Use the HasVersion property to determine whether the DataRowVersion that you want exists.

Jeśli Default jest określona, używana wersja zależy od RowState wiersza, w którym GetChildRows jest wywoływana.If Default is specified, the version that is used depends on the RowState of the row on which GetChildRows is invoked. Jeśli wiersz, w którym GetChildRows jest wywoływana, ma RowState Modified parametr z, New lub Unchanged , Current wersja wiersza jest używana do pobierania powiązanych wierszy podrzędnych o pasujących wartościach w ich bieżących wersjach.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. Jeśli wiersz, w którym GetChildRows jest wywoływana, ma RowState wartość Deleted , Original wersja wiersza jest używana do pobierania powiązanych wierszy podrzędnych o pasujących wartościach w ich oryginalnych wersjach.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.

Zobacz też

Dotyczy

GetChildRows(String, DataRowVersion)

Pobiera wiersze podrzędne z DataRow przy użyciu określonych RelationName elementów DataRelation i 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);
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()

Parametry

relationName
String

Do RelationName DataRelation użycia.The RelationName of the DataRelation to use.

version
DataRowVersion

Jedna z DataRowVersion wartości określająca wersję danych do pobrania.One of the DataRowVersion values specifying the version of the data to get. Możliwe wartości to Default , Original , Current , i Proposed .Possible values are Default, Original, Current, and Proposed.

Zwraca

DataRow[]

Tablica DataRow obiektów lub tablica o długości zero.An array of DataRow objects or an array of length zero.

Wyjątki

Relacja i wiersz nie należą do tej samej tabeli.The relation and row do not belong to the same table.

relationMa wartość null .The relation is null.

Wiersz nie należy do tabeli.The row does not belong to the table.

Wiersz nie ma żądanego żądania DataRowVersion .The row does not have the requested DataRowVersion.

Uwagi

DataTableZawiera również kolekcję DataRelation obiektów, które są zwracane przez ChildRelations Właściwość.The DataTable also contains a collection of DataRelation objects that is returned by the ChildRelations property.

Użyj HasVersion właściwości, aby określić, czy DataRowVersion ma ona istnieć.Use the HasVersion property to determine whether the DataRowVersion that you want exists.

Jeśli Default jest określona, używana wersja zależy od RowState wiersza, w którym GetChildRows jest wywoływana.If Default is specified, the version that is used depends on the RowState of the row on which GetChildRows is invoked. Jeśli wiersz, w którym GetChildRows jest wywoływana, ma RowState Modified parametr z, New lub Unchanged , Current wersja wiersza jest używana do pobierania powiązanych wierszy podrzędnych o pasujących wartościach w ich bieżących wersjach.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. Jeśli wiersz, w którym GetChildRows jest wywoływana, ma RowState wartość Deleted , Original wersja wiersza jest używana do pobierania powiązanych wierszy podrzędnych o pasujących wartościach w ich oryginalnych wersjach.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.

Dotyczy