DataRelation Constructeurs

Définition

Espace de noms:: System.Data

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

Nom	Description
DataRelation(String, DataColumn, DataColumn)	Initialise une nouvelle instance de la classe à l’aide DataRelation du nom spécifié DataRelation et des objets parent et enfant DataColumn .
DataRelation(String, DataColumn[], DataColumn[])	Initialise une nouvelle instance de la DataRelation classe à l’aide du nom spécifié DataRelation et des tableaux correspondants d’objets parents et enfants DataColumn .
DataRelation(String, DataColumn, DataColumn, Boolean)	Initialise une nouvelle instance de la DataRelation classe à l’aide du nom, du parent et des objets enfants DataColumn spécifiés et d’une valeur qui indique s’il faut créer des contraintes.
DataRelation(String, DataColumn[], DataColumn[], Boolean)	Initialise une nouvelle instance de la DataRelation classe à l’aide du nom spécifié, des tableaux correspondants d’objets parent et enfant DataColumn et de la valeur qui indique s’il faut créer des contraintes.
DataRelation(String, String, String, String[], String[], Boolean)	Ce constructeur est fourni pour la prise en charge du temps de conception dans l’environnement Visual Studio.
DataRelation(String, String, String, String, String, String[], String[], Boolean)	Ce constructeur est fourni pour la prise en charge du temps de conception dans l’environnement Visual Studio.

DataRelation(String, DataColumn, DataColumn)

Initialise une nouvelle instance de la classe à l’aide DataRelation du nom spécifié DataRelation et des objets parent et enfant DataColumn .

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

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 du DataRelation. Si null ou une chaîne vide (« »), un nom par défaut est donné lorsque l’objet créé est ajouté à l’objet DataRelationCollection.

parentColumn: DataColumn

Parent DataColumn dans la relation.

childColumn: DataColumn

Enfant DataColumn dans la relation.

Exceptions

ArgumentNullException

Un ou les deux DataColumn objets contient null.

InvalidConstraintException

Les colonnes ont différents types de données

- Ou -

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

Exemples

L’exemple suivant crée un nouveau DataRelation et l’ajoute à l’objet DataRelationCollection 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[])

Initialise une nouvelle instance de la DataRelation classe à l’aide du nom spécifié DataRelation et des tableaux correspondants d’objets parents et enfants DataColumn .

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

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 null ou une chaîne vide (« »), un nom par défaut est donné lorsque l’objet créé est ajouté à l’objet DataRelationCollection.

parentColumns: DataColumn[]

Tableau d’objets parents DataColumn .

childColumns: DataColumn[]

Tableau d’objets enfants DataColumn .

Exceptions

ArgumentNullException

Un ou les deux DataColumn objets contient null.

InvalidConstraintException

Les DataColumn objets ont différents types de données

- Ou -

Un ou les deux tableaux ne sont pas composés de colonnes distinctes 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 à l’objet DataRelationCollection 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)

Initialise une nouvelle instance de la DataRelation classe à l’aide du nom, du parent et des objets enfants DataColumn spécifiés et d’une valeur qui indique s’il faut 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);

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 null ou une chaîne vide (« »), un nom par défaut est donné lorsque l’objet créé est ajouté à l’objet DataRelationCollection.

parentColumn: DataColumn

Parent DataColumn dans la relation.

childColumn: DataColumn

Enfant DataColumn 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 ou les deux DataColumn objets contient null.

InvalidConstraintException

Les colonnes ont différents types de données

- Ou -

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

Exemples

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

Initialise une nouvelle instance de la DataRelation classe à l’aide du nom spécifié, des tableaux correspondants d’objets parent et enfant DataColumn et de la valeur qui indique s’il faut 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);

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 null ou une chaîne vide (« »), un nom par défaut est donné lorsque l’objet créé est ajouté à l’objet DataRelationCollection.

parentColumns: DataColumn[]

Tableau d’objets parents DataColumn .

childColumns: DataColumn[]

Tableau d’objets enfants DataColumn .

createConstraints: Boolean

Valeur qui indique s’il faut créer des contraintes. true, si des contraintes sont créées. Sinon, false.

Exceptions

ArgumentNullException

Un ou les deux objets DataColumn est null.

InvalidConstraintException

Les colonnes ont différents types de données

- Ou -

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

Exemples

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

Ce constructeur est fourni pour la prise en charge du temps de conception 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)>]
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 null ou une chaîne vide (« »), un nom par défaut est donné lorsque l’objet créé est ajouté à l’objet DataRelationCollection.

parentTableName: String

Nom de la DataTable table parente de la relation.

childTableName: String

Nom de la DataTable table enfant de la relation.

parentColumnNames: String[]

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

childColumnNames: String[]

Tableau de noms d’objets DataColumn dans l’enfant DataTable 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 bloc et EndInit d’un BeginInit bloc. Si ce constructeur n’est pas appelé entre BeginInit et EndInit qu’un NullReferenceException événement se produit. En outre, les tables et colonnes avec 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)

Ce constructeur est fourni pour la prise en charge du temps de conception 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)>]
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 du DataRelation. Si null ou une chaîne vide (« »), un nom par défaut est donné lorsque l’objet créé est ajouté à l’objet DataRelationCollection.

parentTableName: String

Nom de la DataTable table parente de la relation.

parentTableNamespace: String

Nom de l’espace de noms de table parent.

childTableName: String

Nom de la DataTable table enfant de la relation.

childTableNamespace: String

Nom de l’espace de noms de table enfant.

parentColumnNames: String[]

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

childColumnNames: String[]

Tableau de noms d’objets DataColumn dans l’enfant DataTable 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 colonnes avec 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 colonnes avec les noms spécifiés doivent exister au moment de l’appel EndInit .

S’applique à

Commentaires

Cette page a-t-elle été utile ?