DataRelation Konstruktory

Reference

Definice

Obor názvů:: System.Data

Sestavení:: System.Data.Common.dll

Sestavení:: System.Data.dll

Sestavení:: netstandard.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

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

ArgumentNullException

Jeden nebo oba DataColumn objekty obsahují null.

InvalidConstraintException

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

ArgumentNullException

Jeden nebo oba DataColumn objekty obsahují null.

InvalidConstraintException

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

ArgumentNullException

Jeden nebo oba DataColumn objekty obsahují null.

InvalidConstraintException

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

ArgumentNullException

Jeden nebo oba DataColumn objekty jsou null.

InvalidConstraintException

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: BrowsableAttribute

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: BrowsableAttribute

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

Sdílet prostřednictvím

DataRelation Konstruktory

Definice

Přetížení

DataRelation(String, DataColumn, DataColumn)

Parametry

Výjimky

Příklady

Viz také

Platí pro

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

Parametry

Výjimky

Příklady

Viz také

Platí pro

DataRelation(String, DataColumn, DataColumn, Boolean)

Parametry

Výjimky

Příklady

Viz také

Platí pro

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

Parametry

Výjimky

Příklady

Viz také

Platí pro

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

Parametry

Poznámky

Platí pro

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

Parametry

Poznámky

Platí pro

Další materiály