Sdílet prostřednictvím


DataRelation Konstruktory

Definice

Inicializuje novou instanci DataRelation třídy.

Přetížení

DataRelation(String, DataColumn, DataColumn)

Inicializuje novou instanci DataRelation třídy pomocí zadaného DataRelation názvu a nadřazených a podřízených DataColumn objektů.

DataRelation(String, DataColumn[], DataColumn[])

Inicializuje novou instanci DataRelation třídy pomocí zadaného DataRelation názvu a odpovídajících polí nadřazených a podřízených DataColumn objektů.

DataRelation(String, DataColumn, DataColumn, Boolean)

Inicializuje novou instanci DataRelation třídy pomocí zadaného názvu, nadřazených a podřízených DataColumn objektů a hodnoty, která označuje, zda vytvořit omezení.

DataRelation(String, DataColumn[], DataColumn[], Boolean)

Inicializuje novou instanci třídy pomocí zadaného DataRelation názvu, odpovídajících polí nadřazených a podřízených DataColumn objektů a hodnoty, která označuje, zda vytvořit omezení.

DataRelation(String, String, String, String[], String[], Boolean)

Tento konstruktor je k dispozici pro podporu doby návrhu v prostředí sady Visual Studio.

DataRelation(String, String, String, String, String, String[], String[], Boolean)

Tento konstruktor je k dispozici pro podporu doby návrhu v prostředí sady Visual Studio.

DataRelation(String, DataColumn, DataColumn)

Zdroj:
DataRelation.cs
Zdroj:
DataRelation.cs
Zdroj:
DataRelation.cs

Inicializuje novou instanci DataRelation třídy pomocí zadaného DataRelation názvu a nadřazených a podřízených DataColumn objektů.

public:
 DataRelation(System::String ^ relationName, System::Data::DataColumn ^ parentColumn, System::Data::DataColumn ^ childColumn);
public DataRelation (string? relationName, System.Data.DataColumn parentColumn, System.Data.DataColumn childColumn);
public DataRelation (string relationName, System.Data.DataColumn parentColumn, System.Data.DataColumn childColumn);
new System.Data.DataRelation : string * System.Data.DataColumn * System.Data.DataColumn -> System.Data.DataRelation
Public Sub New (relationName As String, parentColumn As DataColumn, childColumn As DataColumn)

Parametry

relationName
String

Název procesu DataRelation. Pokud null nebo prázdný řetězec (""), bude při přidání vytvořeného objektu do objektu DataRelationCollectionuveden výchozí název.

parentColumn
DataColumn

Nadřazený objekt DataColumn v relaci.

childColumn
DataColumn

Dítě DataColumn ve vztahu.

Výjimky

Jeden nebo oba DataColumn objekty obsahují null.

Sloupce mají různé datové typy.

- nebo -

Tabulky nepatří do stejné DataSet.

Příklady

Následující příklad vytvoří nový DataRelation a přidá ho do DataRelationCollection souboru DataSet.

private void CreateRelation()
{
    // Code to get the DataSet not shown here.
    // Get the DataColumn objects from two DataTable
    // objects in a DataSet.
    DataColumn[] parentCols = new DataColumn[]
        {DataSet1.Tables["Customers"].Columns["CustID"],
        DataSet1.Tables["Customers"].Columns["OrdID"]};
    DataColumn[] childCols= new DataColumn[]
        {DataSet1.Tables["Orders"].Columns["CustID"],
        DataSet1.Tables["Orders"].Columns["OrdID"]};

    // Create DataRelation.
    DataRelation CustOrderRel = new DataRelation(
        "CustomersOrders", parentCols, childCols);

    // Add the relation to the DataSet.
    DataSet1.Relations.Add(CustOrderRel);
}

 Private Sub CreateRelation()
    ' Code to get the DataSet not shown here.
    ' Get the DataColumn objects from two DataTable 
    ' objects in a DataSet.
    Dim parentCols As DataColumn() = _
        {DataSet1.Tables("Customers").Columns("CustID"), _
        DataSet1.Tables("Customers").Columns("OrdID")}
    Dim childCols As DataColumn() = _
        {DataSet1.Tables("Orders").Columns("CustID"), _
        DataSet1.Tables("Orders").Columns("OrdID")}

    ' Create DataRelation.
    Dim CustOrderRel As New DataRelation( _
        "CustomersOrders", parentCols, childCols)

    ' Add the relation to the DataSet.
    DataSet1.Relations.Add(CustOrderRel)
End Sub

Viz také

Platí pro

DataRelation(String, DataColumn[], DataColumn[])

Zdroj:
DataRelation.cs
Zdroj:
DataRelation.cs
Zdroj:
DataRelation.cs

Inicializuje novou instanci DataRelation třídy pomocí zadaného DataRelation názvu a odpovídajících polí nadřazených a podřízených DataColumn objektů.

public:
 DataRelation(System::String ^ relationName, cli::array <System::Data::DataColumn ^> ^ parentColumns, cli::array <System::Data::DataColumn ^> ^ childColumns);
public DataRelation (string? relationName, System.Data.DataColumn[] parentColumns, System.Data.DataColumn[] childColumns);
public DataRelation (string relationName, System.Data.DataColumn[] parentColumns, System.Data.DataColumn[] childColumns);
new System.Data.DataRelation : string * System.Data.DataColumn[] * System.Data.DataColumn[] -> System.Data.DataRelation
Public Sub New (relationName As String, parentColumns As DataColumn(), childColumns As DataColumn())

Parametry

relationName
String

Název relace. Pokud null nebo prázdný řetězec (""), bude při přidání vytvořeného objektu do objektu DataRelationCollectionuveden výchozí název.

parentColumns
DataColumn[]

Pole nadřazených DataColumn objektů.

childColumns
DataColumn[]

Pole podřízených DataColumn objektů.

Výjimky

Jeden nebo oba DataColumn objekty obsahují null.

Objekty DataColumn mají různé datové typy.

- nebo -

Jedna nebo obě matice se skládají z odlišných sloupců ze stejné tabulky.

- nebo -

Tabulky nepatří do stejné DataSet.

Příklady

Následující příklad vytvoří nový DataRelation a přidá ho do DataRelationCollection souboru DataSet.

Private Sub CreateRelation()
    ' Code to get the DataSet not shown here.
    ' Get the DataColumn objects from two DataTable 
    ' objects in a DataSet.
    Dim parentColumns() As DataColumn
    Dim childColumns() As DataColumn
    parentColumns(0) = DataSet1.Tables( _
        "Customers").Columns("CustID")
    parentColumns(1) = DataSet1.Tables( _
        "Customers").Columns("OrdID")
 
    childColumns(0) = DataSet1.Tables( _
        "Orders").Columns("CustID")
    childColumns(1) = DataSet1.Tables( _
        "Orders").Columns("OrdID")

    ' Create DataRelation.
    Dim CustOrderRel As New DataRelation( _
        "CustomersOrders", parentColumns, childColumns)

    ' Add the relation to the DataSet.
    DataSet1.Relations.Add(CustOrderRel)
End Sub

Viz také

Platí pro

DataRelation(String, DataColumn, DataColumn, Boolean)

Zdroj:
DataRelation.cs
Zdroj:
DataRelation.cs
Zdroj:
DataRelation.cs

Inicializuje novou instanci DataRelation třídy pomocí zadaného názvu, nadřazených a podřízených DataColumn objektů a hodnoty, která označuje, zda vytvořit omezení.

public:
 DataRelation(System::String ^ relationName, System::Data::DataColumn ^ parentColumn, System::Data::DataColumn ^ childColumn, bool createConstraints);
public DataRelation (string? relationName, System.Data.DataColumn parentColumn, System.Data.DataColumn childColumn, bool createConstraints);
public DataRelation (string relationName, System.Data.DataColumn parentColumn, System.Data.DataColumn childColumn, bool createConstraints);
new System.Data.DataRelation : string * System.Data.DataColumn * System.Data.DataColumn * bool -> System.Data.DataRelation
Public Sub New (relationName As String, parentColumn As DataColumn, childColumn As DataColumn, createConstraints As Boolean)

Parametry

relationName
String

Název relace. Pokud null nebo prázdný řetězec (""), bude při přidání vytvořeného objektu do objektu DataRelationCollectionuveden výchozí název.

parentColumn
DataColumn

Nadřazený DataColumn objekt v relaci.

childColumn
DataColumn

Podřízený DataColumn prvek v relaci.

createConstraints
Boolean

Hodnota, která označuje, zda jsou vytvořena omezení. true, pokud jsou vytvořena omezení. V opačném případě hodnota false.

Výjimky

Jeden nebo oba DataColumn objekty obsahují null.

Sloupce mají různé datové typy.

- nebo -

Tabulky nepatří do stejné DataSet.

Příklady

Následující příklad vytvoří nový DataRelation a přidá ho do DataRelationCollection souboru DataSet.


 Private Sub CreateRelation()
    ' Code to get the DataSet not shown here.
    ' Get the DataColumn objects from two DataTable 
    ' objects in a DataSet.
    Dim parentColumn As DataColumn = DataSet1.Tables( _
        "Customers").Columns("CustID")
    Dim childColumn As DataColumn = _
        DataSet1.Tables("Orders").Columns("CustID")

    ' Create DataRelation.
    Dim bConstraints As Boolean = True
    Dim customerOrdersRelation As DataRelation = _
        New DataRelation("CustomersOrders", _
        parentColumn, childColumn, bConstraints)

    ' Add the relation to the DataSet.
    DataSet1.Relations.Add(customerOrdersRelation)
End Sub

Viz také

Platí pro

DataRelation(String, DataColumn[], DataColumn[], Boolean)

Zdroj:
DataRelation.cs
Zdroj:
DataRelation.cs
Zdroj:
DataRelation.cs

Inicializuje novou instanci třídy pomocí zadaného DataRelation názvu, odpovídajících polí nadřazených a podřízených DataColumn objektů a hodnoty, která označuje, zda vytvořit omezení.

public:
 DataRelation(System::String ^ relationName, cli::array <System::Data::DataColumn ^> ^ parentColumns, cli::array <System::Data::DataColumn ^> ^ childColumns, bool createConstraints);
public DataRelation (string? relationName, System.Data.DataColumn[] parentColumns, System.Data.DataColumn[] childColumns, bool createConstraints);
public DataRelation (string relationName, System.Data.DataColumn[] parentColumns, System.Data.DataColumn[] childColumns, bool createConstraints);
new System.Data.DataRelation : string * System.Data.DataColumn[] * System.Data.DataColumn[] * bool -> System.Data.DataRelation
Public Sub New (relationName As String, parentColumns As DataColumn(), childColumns As DataColumn(), createConstraints As Boolean)

Parametry

relationName
String

Název relace. Pokud null nebo prázdný řetězec (""), bude při přidání vytvořeného objektu do objektu DataRelationCollectionuveden výchozí název.

parentColumns
DataColumn[]

Pole nadřazených DataColumn objektů.

childColumns
DataColumn[]

Pole podřízených DataColumn objektů.

createConstraints
Boolean

Hodnota, která označuje, zda se mají vytvořit omezení. true, pokud jsou vytvořena omezení. V opačném případě hodnota false.

Výjimky

Jeden nebo oba DataColumn objekty jsou null.

Sloupce mají různé datové typy.

- nebo -

Tabulky nepatří do stejné DataSet.

Příklady

Následující příklad vytvoří nový DataRelation a přidá ho do DataRelationCollection souboru DataSet.

Private Sub CreateRelation()
    ' Code to get the DataSet not shown here.
    ' Get the DataColumn objects from two DataTable 
    ' objects in a DataSet.
    Dim parentColumns() As DataColumn
    Dim childColumns() As DataColumn
    parentColumns(0) = DataSet1.Tables( _
        "Customers").Columns("CustID")
    parentColumns(1) = DataSet1.Tables( _
        "Customers").Columns("OrdID")
 
    childColumns(0) = DataSet1.Tables( _
        "Orders").Columns("CustID")
    childColumns(1) = DataSet1.Tables( _
        "Orders").Columns("OrdID")
 
    Dim bConstraints As Boolean = True
    ' Create DataRelation.
    Dim CustOrderRel As New DataRelation( _
        "CustomersOrders", parentColumns, childColumns,  _
        bConstraints)

    ' Add the relation to the DataSet.
    DataSet1.Relations.Add(CustOrderRel)
End Sub

Viz také

Platí pro

DataRelation(String, String, String, String[], String[], Boolean)

Zdroj:
DataRelation.cs
Zdroj:
DataRelation.cs
Zdroj:
DataRelation.cs

Tento konstruktor je k dispozici pro podporu doby návrhu v prostředí sady Visual Studio.

public:
 DataRelation(System::String ^ relationName, System::String ^ parentTableName, System::String ^ childTableName, cli::array <System::String ^> ^ parentColumnNames, cli::array <System::String ^> ^ childColumnNames, bool nested);
[System.ComponentModel.Browsable(false)]
public DataRelation (string relationName, string? parentTableName, string? childTableName, string[]? parentColumnNames, string[]? childColumnNames, bool nested);
[System.ComponentModel.Browsable(false)]
public DataRelation (string relationName, string parentTableName, string childTableName, string[] parentColumnNames, string[] childColumnNames, bool nested);
[<System.ComponentModel.Browsable(false)>]
new System.Data.DataRelation : string * string * string * string[] * string[] * bool -> System.Data.DataRelation
Public Sub New (relationName As String, parentTableName As String, childTableName As String, parentColumnNames As String(), childColumnNames As String(), nested As Boolean)

Parametry

relationName
String

Název relace. Pokud null nebo prázdný řetězec (""), bude při přidání vytvořeného objektu do objektu DataRelationCollectionuveden výchozí název.

parentTableName
String

Název DataTable nadřazené tabulky relace.

childTableName
String

Název DataTable podřízené tabulky relace.

parentColumnNames
String[]

Pole DataColumn názvů objektů v nadřazené DataTable relaci.

childColumnNames
String[]

Pole DataColumn názvů objektů v podřízené DataTable relaci.

nested
Boolean

Hodnota, která označuje, zda jsou relace vnořené.

Atributy

Poznámky

Jakýkoli DataRelation objekt vytvořený pomocí tohoto konstruktoru musí být přidán do kolekce pomocí AddRange metody uvnitř BeginInit bloku a EndInit . Pokud tento konstruktor není volána mezi BeginInit a EndInit dojde k výskytu NullReferenceException . Kromě toho tabulky a sloupce se zadanými názvy musí existovat v době, kdy je konstruktor volána.

Platí pro

DataRelation(String, String, String, String, String, String[], String[], Boolean)

Zdroj:
DataRelation.cs
Zdroj:
DataRelation.cs
Zdroj:
DataRelation.cs

Tento konstruktor je k dispozici pro podporu doby návrhu v prostředí sady Visual Studio.

public:
 DataRelation(System::String ^ relationName, System::String ^ parentTableName, System::String ^ parentTableNamespace, System::String ^ childTableName, System::String ^ childTableNamespace, cli::array <System::String ^> ^ parentColumnNames, cli::array <System::String ^> ^ childColumnNames, bool nested);
[System.ComponentModel.Browsable(false)]
public DataRelation (string relationName, string? parentTableName, string? parentTableNamespace, string? childTableName, string? childTableNamespace, string[]? parentColumnNames, string[]? childColumnNames, bool nested);
[System.ComponentModel.Browsable(false)]
public DataRelation (string relationName, string parentTableName, string parentTableNamespace, string childTableName, string childTableNamespace, string[] parentColumnNames, string[] childColumnNames, bool nested);
[<System.ComponentModel.Browsable(false)>]
new System.Data.DataRelation : string * string * string * string * string * string[] * string[] * bool -> System.Data.DataRelation
Public Sub New (relationName As String, parentTableName As String, parentTableNamespace As String, childTableName As String, childTableNamespace As String, parentColumnNames As String(), childColumnNames As String(), nested As Boolean)

Parametry

relationName
String

Název procesu DataRelation. Pokud null nebo prázdný řetězec (""), bude při přidání vytvořeného objektu do objektu DataRelationCollectionuveden výchozí název.

parentTableName
String

Název DataTable nadřazené tabulky relace.

parentTableNamespace
String

Název oboru názvů nadřazené tabulky.

childTableName
String

Název DataTable podřízené tabulky relace.

childTableNamespace
String

Název oboru názvů podřízené tabulky.

parentColumnNames
String[]

Pole DataColumn názvů objektů v nadřazené DataTable relaci.

childColumnNames
String[]

Pole DataColumn názvů objektů v podřízené DataTable relaci.

nested
Boolean

Hodnota, která označuje, zda jsou relace vnořené.

Atributy

Poznámky

Všechny DataRelation objekty vytvořené pomocí tohoto konstruktoru pak musí být přidány do kolekce pomocí AddRange. Tabulky a sloupce se zadanými názvy musí existovat v době volání metody, nebo pokud BeginInit byl volána před voláním tohoto konstruktoru, tabulky a sloupce se zadanými názvy musí existovat v době volání EndInit .

Platí pro