DataRelation Constructeurs

Référence

Définition

Espace de noms:: System.Data

Assembly:: System.Data.Common.dll

Assembly:: System.Data.dll

Assembly:: netstandard.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Initialise une nouvelle instance de la classe DataRelation.

Surcharges

DataRelation(String, DataColumn, DataColumn)	Initialise une nouvelle instance de la classe DataRelation avec le nom DataRelation spécifié, ainsi que les objets DataColumn parent et enfant.
DataRelation(String, DataColumn[], DataColumn[])	Initialise une nouvelle instance de la classe DataRelation avec le nom DataRelation spécifié, ainsi que les tableaux d'objets DataColumn parent et enfant correspondants.
DataRelation(String, DataColumn, DataColumn, Boolean)	Initialise une nouvelle instance de la classe DataRelation avec le nom spécifié, les objets DataColumn parent et enfant, ainsi qu'une valeur qui indique s'il convient de créer des contraintes.
DataRelation(String, DataColumn[], DataColumn[], Boolean)	Initialise une nouvelle instance de la classe DataRelation avec le nom spécifié, les tableaux d'objets DataColumn parent et enfant correspondants, ainsi qu'une valeur qui indique s'il convient de créer des contraintes.
DataRelation(String, String, String, String[], String[], Boolean)	Ce constructeur est fourni pour assurer la prise en charge au moment du design dans l'environnement Visual Studio.
DataRelation(String, String, String, String, String, String[], String[], Boolean)	Ce constructeur est fourni pour assurer la prise en charge au moment du design dans l'environnement Visual Studio.

DataRelation(String, DataColumn, DataColumn)

Source:: DataRelation.cs

Source:: DataRelation.cs

Source:: DataRelation.cs

Initialise une nouvelle instance de la classe DataRelation avec le nom DataRelation spécifié, ainsi que les objets DataColumn parent et enfant.

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)

Paramètres

relationName: String

Nom de l'objet DataRelation. Si sa valeur est null ou une chaîne vide (""), un nom par défaut est attribué lorsque l'objet créé est ajouté à DataRelationCollection.

parentColumn: DataColumn

DataColumn parent dans la relation.

childColumn: DataColumn

DataColumn enfant dans la relation.

Exceptions

ArgumentNullException

Un des objets DataColumn ou les deux contiennent null.

InvalidConstraintException

Les colonnes possèdent des types de données différents.

-Ou-

Les tables n'appartiennent pas au même DataSet.

Exemples

L’exemple suivant crée un nouveau DataRelation et l’ajoute DataRelationCollection au d’un 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

Voir aussi

S’applique à

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

Source:: DataRelation.cs

Source:: DataRelation.cs

Source:: DataRelation.cs

Initialise une nouvelle instance de la classe DataRelation avec le nom DataRelation spécifié, ainsi que les tableaux d'objets DataColumn parent et enfant correspondants.

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())

Paramètres

relationName: String

Nom de la relation. Si sa valeur est null ou une chaîne vide (""), un nom par défaut est attribué lorsque l'objet créé est ajouté à DataRelationCollection.

parentColumns: DataColumn[]

Tableau d'objets DataColumn parents.

childColumns: DataColumn[]

Tableau d'objets DataColumn enfants.

Exceptions

ArgumentNullException

Un des objets DataColumn ou les deux contiennent null.

InvalidConstraintException

Les objets DataColumn possèdent des types de données différents.

-Ou-

Un des tableaux ou aucun des deux tableaux n'est composé de colonnes distinctes provenant de la même table.

-Ou-

Les tables n'appartiennent pas au même DataSet.

Exemples

L’exemple suivant crée un nouveau DataRelation et l’ajoute DataRelationCollection au d’un 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

Voir aussi

S’applique à

DataRelation(String, DataColumn, DataColumn, Boolean)

Source:: DataRelation.cs

Source:: DataRelation.cs

Source:: DataRelation.cs

Initialise une nouvelle instance de la classe DataRelation avec le nom spécifié, les objets DataColumn parent et enfant, ainsi qu'une valeur qui indique s'il convient de créer des contraintes.

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)

Paramètres

relationName: String

Nom de la relation. Si sa valeur est null ou une chaîne vide (""), un nom par défaut est attribué lorsque l'objet créé est ajouté à DataRelationCollection.

parentColumn: DataColumn

DataColumn parent dans la relation.

childColumn: DataColumn

DataColumn enfant dans la relation.

createConstraints: Boolean

Valeur qui indique si des contraintes sont créées. true, si des contraintes sont créées. Sinon, false.

Exceptions

ArgumentNullException

Un des objets DataColumn ou les deux contiennent null.

InvalidConstraintException

Les colonnes possèdent des types de données différents.

-Ou-

Les tables n'appartiennent pas au même DataSet.

Exemples

L’exemple suivant crée un nouveau DataRelation et l’ajoute DataRelationCollection au d’un 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

Voir aussi

S’applique à

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

Source:: DataRelation.cs

Source:: DataRelation.cs

Source:: DataRelation.cs

Initialise une nouvelle instance de la classe DataRelation avec le nom spécifié, les tableaux d'objets DataColumn parent et enfant correspondants, ainsi qu'une valeur qui indique s'il convient de créer des contraintes.

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)

Paramètres

relationName: String

Nom de la relation. Si sa valeur est null ou une chaîne vide (""), un nom par défaut est attribué lorsque l'objet créé est ajouté à DataRelationCollection.

parentColumns: DataColumn[]

Tableau d'objets DataColumn parents.

childColumns: DataColumn[]

Tableau d'objets DataColumn enfants.

createConstraints: Boolean

Valeur indiquant si des contraintes doivent être créées. true, si des contraintes sont créées. Sinon, false.

Exceptions

ArgumentNullException

Un des objets DataColumn ou les deux ont la valeur null.

InvalidConstraintException

Les colonnes possèdent des types de données différents.

-Ou-

Les tables n'appartiennent pas au même DataSet.

Exemples

L’exemple suivant crée un nouveau DataRelation et l’ajoute DataRelationCollection au d’un 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

Voir aussi

S’applique à

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

Source:: DataRelation.cs

Source:: DataRelation.cs

Source:: DataRelation.cs

Ce constructeur est fourni pour assurer la prise en charge au moment du design dans l'environnement 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)

Paramètres

relationName: String

Nom de la relation. Si sa valeur est null ou une chaîne vide (""), un nom par défaut est attribué lorsque l'objet créé est ajouté à DataRelationCollection.

parentTableName: String

Nom du DataTable qui est la table parente de la relation.

childTableName: String

Nom du DataTable qui est la table enfant de la relation.

parentColumnNames: String[]

Tableau de noms d'objets DataColumn dans le DataTable parent de la relation.

childColumnNames: String[]

Tableau de noms d'objets DataColumn dans le DataTable enfant de la relation.

nested: Boolean

Valeur qui indique si les relations sont imbriquées.

Attributs: BrowsableAttribute

Remarques

Tout DataRelation objet créé à l’aide de ce constructeur doit être ajouté à la collection avec la AddRange méthode à l’intérieur d’un BeginInit bloc et EndInit . Si ce constructeur n’est pas appelé entre BeginInit et EndInit un NullReferenceException se produira. En outre, les tables et les colonnes portant les noms spécifiés doivent exister au moment où le constructeur est appelé.

S’applique à

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

Source:: DataRelation.cs

Source:: DataRelation.cs

Source:: DataRelation.cs

Ce constructeur est fourni pour assurer la prise en charge au moment du design dans l'environnement 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)

Paramètres

relationName: String

Nom de l'objet DataRelation. Si sa valeur est null ou une chaîne vide (""), un nom par défaut est attribué lorsque l'objet créé est ajouté à DataRelationCollection.

parentTableName: String

Nom du DataTable qui est la table parente de la relation.

parentTableNamespace: String

Nom de l'espace de noms de la table parente.

childTableName: String

Nom du DataTable qui est la table enfant de la relation.

childTableNamespace: String

Nom de l'espace de noms de la table enfant.

parentColumnNames: String[]

Tableau de noms d'objets DataColumn dans le DataTable parent de la relation.

childColumnNames: String[]

Tableau de noms d'objets DataColumn dans le DataTable enfant de la relation.

nested: Boolean

Valeur qui indique si les relations sont imbriquées.

Attributs: BrowsableAttribute

Remarques

Tout DataRelation objet créé à l’aide de ce constructeur doit ensuite être ajouté à la collection avec AddRange. Les tables et les colonnes portant les noms spécifiés doivent exister au moment où la méthode est appelée, ou si BeginInit elle a été appelée avant d’appeler ce constructeur, les tables et les colonnes portant les noms spécifiés doivent exister au moment de l’appel EndInit .

S’applique à

DataRelation Constructeurs

Définition

Surcharges

DataRelation(String, DataColumn, DataColumn)

Paramètres

Exceptions

Exemples

Voir aussi

S’applique à

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

Paramètres

Exceptions

Exemples

Voir aussi

S’applique à

DataRelation(String, DataColumn, DataColumn, Boolean)

Paramètres

Exceptions

Exemples

Voir aussi

S’applique à

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

Paramètres

Exceptions

Exemples

Voir aussi

S’applique à

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

Paramètres

Remarques

S’applique à

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

Paramètres

Remarques

S’applique à

Commentaires

Ressources supplémentaires