DataRelation DataRelation DataRelation DataRelation Constructors

Définition

Surcharges

DataRelation(String, DataColumn, DataColumn) DataRelation(String, DataColumn, DataColumn) DataRelation(String, DataColumn, DataColumn) 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.Initializes a new instance of the DataRelation class using the specified DataRelation name, and parent and child DataColumn objects.

DataRelation(String, DataColumn[], DataColumn[]) DataRelation(String, DataColumn[], DataColumn[]) DataRelation(String, DataColumn[], DataColumn[]) 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.Initializes a new instance of the DataRelation class using the specified DataRelation name and matched arrays of parent and child DataColumn objects.

DataRelation(String, DataColumn, DataColumn, Boolean) DataRelation(String, DataColumn, DataColumn, Boolean) DataRelation(String, DataColumn, DataColumn, Boolean) 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.Initializes a new instance of the DataRelation class using the specified name, parent and child DataColumn objects, and a value that indicates whether to create constraints.

DataRelation(String, DataColumn[], DataColumn[], Boolean) DataRelation(String, DataColumn[], DataColumn[], Boolean) DataRelation(String, DataColumn[], DataColumn[], Boolean) 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.Initializes a new instance of the DataRelation class using the specified name, matched arrays of parent and child DataColumn objects, and value that indicates whether to create constraints.

DataRelation(String, String, String, String[], String[], Boolean) DataRelation(String, String, String, String[], String[], Boolean) DataRelation(String, String, String, String[], String[], Boolean) 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.This constructor is provided for design time support in the Visual Studio environment.

DataRelation(String, String, String, String, String, String[], String[], Boolean) DataRelation(String, String, String, String, String, String[], String[], Boolean) DataRelation(String, String, String, String, String, String[], String[], Boolean) 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.This constructor is provided for design time support in the Visual Studio environment.

DataRelation(String, DataColumn, DataColumn) DataRelation(String, DataColumn, DataColumn) DataRelation(String, DataColumn, DataColumn) 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.Initializes a new instance of the DataRelation class using the specified DataRelation name, and parent and child DataColumn objects.

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 String String String

Nom du DataRelation.The name of the 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.If null or an empty string (""), a default name will be given when the created object is added to the DataRelationCollection.

parentColumn
DataColumn DataColumn DataColumn DataColumn

DataColumn parent dans la relation.The parent DataColumn in the relationship.

childColumn
DataColumn DataColumn DataColumn DataColumn

DataColumn enfant dans la relation.The child DataColumn in the relationship.

Exceptions

Un des objets DataColumn ou les deux contiennent null.One or both of the DataColumn objects contains null.

Les colonnes possèdent des types de données différents.The columns have different data types - ou --Or- Les tables n'appartiennent pas au même DataSet.The tables do not belong to the same DataSet.

Exemples

L’exemple suivant crée un nouveau DataRelation et l’ajoute à la DataRelationCollection valeur de DataSet.The following example creates a new DataRelation and adds it to the DataRelationCollection of a 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 = New DataColumn() _
        {DataSet1.Tables("Customers").Columns("CustID"), _
        DataSet1.Tables("Customers").Columns("OrdID")}
    Dim childCols() As DataColumn = New DataColumn() _
        {DataSet1.Tables("Orders").Columns("CustID"), _
        DataSet1.Tables("Orders").Columns("OrdID")}

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

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

DataRelation(String, DataColumn[], DataColumn[]) DataRelation(String, DataColumn[], DataColumn[]) DataRelation(String, DataColumn[], DataColumn[]) 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.Initializes a new instance of the DataRelation class using the specified DataRelation name and matched arrays of parent and child DataColumn objects.

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 String String String

Nom de la relation.The name of the 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.If null or an empty string (""), a default name will be given when the created object is added to the DataRelationCollection.

parentColumns
DataColumn[]

Tableau d'objets DataColumn parents.An array of parent DataColumn objects.

childColumns
DataColumn[]

Tableau d'objets DataColumn enfants.An array of child DataColumn objects.

Exceptions

Un des objets DataColumn ou les deux contiennent null.One or both of the DataColumn objects contains null.

Les objets DataColumn possèdent des types de données différents.The DataColumn objects have different data types - ou --Or- Un des tableaux ou aucun des deux tableaux n'est composé de colonnes distinctes provenant de la même table.One or both of the arrays are not composed of distinct columns from the same table.

- ou --Or- Les tables n'appartiennent pas au même DataSet.The tables do not belong to the same DataSet.

Exemples

L’exemple suivant crée un nouveau DataRelation et l’ajoute à la DataRelationCollection valeur de DataSet.The following example creates a new DataRelation and adds it to the DataRelationCollection of a 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 DataRelation = New DataRelation( _
        "CustomersOrders", parentColumns, childColumns)

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

DataRelation(String, DataColumn, DataColumn, Boolean) DataRelation(String, DataColumn, DataColumn, Boolean) DataRelation(String, DataColumn, DataColumn, Boolean) 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.Initializes a new instance of the DataRelation class using the specified name, parent and child DataColumn objects, and a value that indicates whether to create constraints.

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 String String String

Nom de la relation.The name of the 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.If null or an empty string (""), a default name will be given when the created object is added to the DataRelationCollection.

parentColumn
DataColumn DataColumn DataColumn DataColumn

DataColumn parent dans la relation.The parent DataColumn in the relation.

childColumn
DataColumn DataColumn DataColumn DataColumn

DataColumn enfant dans la relation.The child DataColumn in the relation.

createConstraints
Boolean Boolean Boolean Boolean

Valeur qui indique si des contraintes sont créées.A value that indicates whether constraints are created. true, si des contraintes sont créées.true, if constraints are created. Sinon, false.Otherwise, false.

Exceptions

Un des objets DataColumn ou les deux contiennent null.One or both of the DataColumn objects contains null.

Les colonnes possèdent des types de données différents.The columns have different data types - ou --Or- Les tables n'appartiennent pas au même DataSet.The tables do not belong to the same DataSet.

Exemples

L’exemple suivant crée un nouveau DataRelation et l’ajoute à la DataRelationCollection valeur de DataSet.The following example creates a new DataRelation and adds it to the DataRelationCollection of a 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

DataRelation(String, DataColumn[], DataColumn[], Boolean) DataRelation(String, DataColumn[], DataColumn[], Boolean) DataRelation(String, DataColumn[], DataColumn[], Boolean) 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.Initializes a new instance of the DataRelation class using the specified name, matched arrays of parent and child DataColumn objects, and value that indicates whether to create constraints.

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 String String String

Nom de la relation.The name of the 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.If null or an empty string (""), a default name will be given when the created object is added to the DataRelationCollection.

parentColumns
DataColumn[]

Tableau d'objets DataColumn parents.An array of parent DataColumn objects.

childColumns
DataColumn[]

Tableau d'objets DataColumn enfants.An array of child DataColumn objects.

createConstraints
Boolean Boolean Boolean Boolean

Valeur indiquant si des contraintes doivent être créées.A value that indicates whether to create constraints. true, si des contraintes sont créées.true, if constraints are created. Sinon, false.Otherwise, false.

Exceptions

Un des objets DataColumn ou les deux ont la valeur null.One or both of the DataColumn objects is null.

Les colonnes possèdent des types de données différents.The columns have different data types - ou --Or- Les tables n'appartiennent pas au même DataSet.The tables do not belong to the same DataSet.

Exemples

L’exemple suivant crée un nouveau DataRelation et l’ajoute à la DataRelationCollection valeur de DataSet.The following example creates a new DataRelation and adds it to the DataRelationCollection of a 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 DataRelation = New DataRelation( _
        "CustomersOrders", parentColumns, childColumns,  _
        bConstraints)

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

DataRelation(String, String, String, String[], String[], Boolean) DataRelation(String, String, String, String[], String[], Boolean) DataRelation(String, String, String, String[], String[], Boolean) 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.This constructor is provided for design time support in the Visual Studio environment.

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

Nom de la relation.The name of the 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.If null or an empty string (""), a default name will be given when the created object is added to the DataRelationCollection.

parentTableName
String String String String

Nom du DataTable qui est la table parente de la relation.The name of the DataTable that is the parent table of the relation.

childTableName
String String String String

Nom du DataTable qui est la table enfant de la relation.The name of the DataTable that is the child table of the relation.

parentColumnNames
String[]

Tableau de noms d'objets DataColumn dans le DataTable parent de la relation.An array of DataColumn object names in the parent DataTable of the relation.

childColumnNames
String[]

Tableau de noms d'objets DataColumn dans le DataTable enfant de la relation.An array of DataColumn object names in the child DataTable of the relation.

nested
Boolean Boolean Boolean Boolean

Valeur qui indique si les relations sont imbriquées.A value that indicates whether relationships are nested.

Remarques

Tout DataRelation objet créé à l’aide de ce constructeur doit être ajouté à la collection AddRange avec la méthode à BeginInit l' EndInit intérieur d’un bloc et.Any DataRelation object created by using this constructor must be added to the collection with the AddRange method inside of a BeginInit and EndInit block. Si ce constructeur n’est pas appelé BeginInit entre EndInit et NullReferenceException un se produit.If this constructor is not called between BeginInit and EndInit a NullReferenceException will occur. En outre, les tables et les colonnes portant les noms spécifiés doivent exister au moment de l’appel du constructeur.In addition, the tables and columns with the specified names must exist at the time the constructor is called.

DataRelation(String, String, String, String, String, String[], String[], Boolean) DataRelation(String, String, String, String, String, String[], String[], Boolean) DataRelation(String, String, String, String, String, String[], String[], Boolean) 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.This constructor is provided for design time support in the Visual Studio environment.

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

Nom du DataRelation.The name of the 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.If null or an empty string (""), a default name will be given when the created object is added to the DataRelationCollection.

parentTableName
String String String String

Nom du DataTable qui est la table parente de la relation.The name of the DataTable that is the parent table of the relation.

parentTableNamespace
String String String String

Nom de l'espace de noms de la table parente.The name of the parent table namespace.

childTableName
String String String String

Nom du DataTable qui est la table enfant de la relation.The name of the DataTable that is the child table of the relation.

childTableNamespace
String String String String

Nom de l'espace de noms de la table enfant.The name of the child table namespace.

parentColumnNames
String[]

Tableau de noms d'objets DataColumn dans le DataTable parent de la relation.An array of DataColumn object names in the parent DataTable of the relation.

childColumnNames
String[]

Tableau de noms d'objets DataColumn dans le DataTable enfant de la relation.An array of DataColumn object names in the child DataTable of the relation.

nested
Boolean Boolean Boolean Boolean

Valeur qui indique si les relations sont imbriquées.A value that indicates whether relationships are nested.

Remarques

Tout DataRelation objet créé à l’aide de ce constructeur doit ensuite être ajouté à la AddRangecollection avec.Any DataRelation object created by using this constructor must then be added to the collection with AddRange. Les tables et les colonnes portant les noms spécifiés doivent exister au moment de l’appel de la BeginInit méthode, ou si a été appelé avant l’appel de ce constructeur, les tables et les colonnes portant les noms EndInit spécifiés doivent exister au moment de l’appel à.Tables and columns with the specified names must exist at the time the method is called, or if BeginInit has been called before calling this constructor, the tables and columns with the specified names must exist at the time that EndInit is called.

S’applique à