DataRelation DataRelation DataRelation DataRelation Constructors

Definizione

Overload

DataRelation(String, DataColumn, DataColumn) DataRelation(String, DataColumn, DataColumn) DataRelation(String, DataColumn, DataColumn) DataRelation(String, DataColumn, DataColumn)

Inizializza una nuova istanza della classe DataRelation utilizzando il nome dell'oggetto DataRelation specificato e gli oggetti DataColumn padre e figlio.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[])

Inizializza una nuova istanza della classe DataRelation utilizzando il nome dell'oggetto DataRelation specificato e le matrici corrispondenti di oggetti DataColumn padre e figlio.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)

Inizializza una nuova istanza della classe DataRelation utilizzando il nome specificato, gli oggetti DataColumn padre e figlio e un valore che indica se creare vincoli.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)

Inizializza una nuova istanza della classe DataRelation utilizzando il nome specificato, le matrici corrispondenti di oggetti DataColumn padre e figlio e un valore che indica se creare vincoli.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)

Questo costruttore viene fornito per il supporto in fase di progettazione nell'ambiente 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)

Questo costruttore viene fornito per il supporto in fase di progettazione nell'ambiente 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)

Inizializza una nuova istanza della classe DataRelation utilizzando il nome dell'oggetto DataRelation specificato e gli oggetti DataColumn padre e figlio.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)

Parametri

relationName
String String String String

Nome di DataRelation.The name of the DataRelation. Se impostato su null o su una stringa vuota (""), verrà assegnato un nome predefinito nel momento in cui l'oggetto creato viene aggiunto all'insieme 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

Oggetto DataColumn padre della relazione.The parent DataColumn in the relationship.

childColumn
DataColumn DataColumn DataColumn DataColumn

Oggetto DataColumn figlio della relazione.The child DataColumn in the relationship.

Eccezioni

Uno o entrambi gli oggetti DataColumn sono null.One or both of the DataColumn objects contains null.

Le colonne presentano tipi di dati diversiThe columns have different data types oppure-Or- Le tabelle non appartengono allo stesso DataSet.The tables do not belong to the same DataSet.

Esempi

Nell'esempio seguente viene creato un DataRelation nuovo oggetto che viene aggiunto DataRelationCollection all'oggetto DataSetdi un oggetto.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() = _
        {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
Vedi anche

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

Inizializza una nuova istanza della classe DataRelation utilizzando il nome dell'oggetto DataRelation specificato e le matrici corrispondenti di oggetti DataColumn padre e figlio.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())

Parametri

relationName
String String String String

Nome della relazione.The name of the relation. Se impostato su null o su una stringa vuota (""), verrà assegnato un nome predefinito nel momento in cui l'oggetto creato viene aggiunto all'insieme DataRelationCollection.If null or an empty string (""), a default name will be given when the created object is added to the DataRelationCollection.

parentColumns
DataColumn[]

Matrice di oggetti DataColumn padre.An array of parent DataColumn objects.

childColumns
DataColumn[]

Matrice di oggetti DataColumn figlio.An array of child DataColumn objects.

Eccezioni

Uno o entrambi gli oggetti DataColumn sono null.One or both of the DataColumn objects contains null.

Gli oggetti DataColumn presentano tipi di dati diversiThe DataColumn objects have different data types oppure-Or- Una o entrambe le matrici non sono composte da colonne distinte della stessa tabella.One or both of the arrays are not composed of distinct columns from the same table.

oppure-Or- Le tabelle non appartengono allo stesso DataSet.The tables do not belong to the same DataSet.

Esempi

Nell'esempio seguente viene creato un DataRelation nuovo oggetto che viene aggiunto DataRelationCollection all'oggetto DataSetdi un oggetto.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 New DataRelation( _
        "CustomersOrders", parentColumns, childColumns)

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

DataRelation(String, DataColumn, DataColumn, Boolean) DataRelation(String, DataColumn, DataColumn, Boolean) DataRelation(String, DataColumn, DataColumn, Boolean) DataRelation(String, DataColumn, DataColumn, Boolean)

Inizializza una nuova istanza della classe DataRelation utilizzando il nome specificato, gli oggetti DataColumn padre e figlio e un valore che indica se creare vincoli.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)

Parametri

relationName
String String String String

Nome della relazione.The name of the relation. Se impostato su null o su una stringa vuota (""), verrà assegnato un nome predefinito nel momento in cui l'oggetto creato viene aggiunto all'insieme 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

Oggetto DataColumn padre della relazione.The parent DataColumn in the relation.

childColumn
DataColumn DataColumn DataColumn DataColumn

Oggetto DataColumn figlio della relazione.The child DataColumn in the relation.

createConstraints
Boolean Boolean Boolean Boolean

Valore che indica se vengono creati vincoli.A value that indicates whether constraints are created. true se i vincoli vengono creati.true, if constraints are created. In caso contrario, false.Otherwise, false.

Eccezioni

Uno o entrambi gli oggetti DataColumn sono null.One or both of the DataColumn objects contains null.

Le colonne presentano tipi di dati diversiThe columns have different data types oppure-Or- Le tabelle non appartengono allo stesso DataSet.The tables do not belong to the same DataSet.

Esempi

Nell'esempio seguente viene creato un DataRelation nuovo oggetto che viene aggiunto DataRelationCollection all'oggetto DataSetdi un oggetto.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
Vedi anche

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

Inizializza una nuova istanza della classe DataRelation utilizzando il nome specificato, le matrici corrispondenti di oggetti DataColumn padre e figlio e un valore che indica se creare vincoli.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)

Parametri

relationName
String String String String

Nome della relazione.The name of the relation. Se impostato su null o su una stringa vuota (""), verrà assegnato un nome predefinito nel momento in cui l'oggetto creato viene aggiunto all'insieme DataRelationCollection.If null or an empty string (""), a default name will be given when the created object is added to the DataRelationCollection.

parentColumns
DataColumn[]

Matrice di oggetti DataColumn padre.An array of parent DataColumn objects.

childColumns
DataColumn[]

Matrice di oggetti DataColumn figlio.An array of child DataColumn objects.

createConstraints
Boolean Boolean Boolean Boolean

Valore che indica se creare vincoli.A value that indicates whether to create constraints. true se i vincoli vengono creati.true, if constraints are created. In caso contrario, false.Otherwise, false.

Eccezioni

Uno o entrambi gli oggetti DataColumn sono null.One or both of the DataColumn objects is null.

Le colonne presentano tipi di dati diversiThe columns have different data types oppure-Or- Le tabelle non appartengono allo stesso DataSet.The tables do not belong to the same DataSet.

Esempi

Nell'esempio seguente viene creato un DataRelation nuovo oggetto che viene aggiunto DataRelationCollection all'oggetto DataSetdi un oggetto.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 New DataRelation( _
        "CustomersOrders", parentColumns, childColumns,  _
        bConstraints)

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

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)

Questo costruttore viene fornito per il supporto in fase di progettazione nell'ambiente 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)

Parametri

relationName
String String String String

Nome della relazione.The name of the relation. Se impostato su null o su una stringa vuota (""), verrà assegnato un nome predefinito nel momento in cui l'oggetto creato viene aggiunto all'insieme 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

Nome dell'oggetto DataTable che rappresenta la tabella padre della relazione.The name of the DataTable that is the parent table of the relation.

childTableName
String String String String

Nome dell'oggetto DataTable che rappresenta la tabella figlio della relazione.The name of the DataTable that is the child table of the relation.

parentColumnNames
String[]

Matrice di nomi di oggetti DataColumn nell'oggetto DataTable padre della relazione.An array of DataColumn object names in the parent DataTable of the relation.

childColumnNames
String[]

Matrice di nomi di oggetti DataColumn nell'oggetto DataTable figlio della relazione.An array of DataColumn object names in the child DataTable of the relation.

nested
Boolean Boolean Boolean Boolean

Valore che indica se le relazioni sono annidate.A value that indicates whether relationships are nested.

Commenti

Qualsiasi DataRelation oggetto creato mediante questo costruttore deve essere aggiunto alla raccolta con il AddRange metodo all'interno di un BeginInit blocco e EndInit .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. Se il costruttore non viene chiamato tra BeginInit e EndInit si NullReferenceException verificherà un oggetto.If this constructor is not called between BeginInit and EndInit a NullReferenceException will occur. Inoltre, le tabelle e le colonne con i nomi specificati devono esistere nel momento in cui viene chiamato il costruttore.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)

Questo costruttore viene fornito per il supporto in fase di progettazione nell'ambiente 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)

Parametri

relationName
String String String String

Nome di DataRelation.The name of the DataRelation. Se impostato su null o su una stringa vuota (""), verrà assegnato un nome predefinito nel momento in cui l'oggetto creato viene aggiunto all'insieme 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

Nome dell'oggetto DataTable che rappresenta la tabella padre della relazione.The name of the DataTable that is the parent table of the relation.

parentTableNamespace
String String String String

Nome dello spazio dei nomi della tabella padre.The name of the parent table namespace.

childTableName
String String String String

Nome dell'oggetto DataTable che rappresenta la tabella figlio della relazione.The name of the DataTable that is the child table of the relation.

childTableNamespace
String String String String

Nome dello spazio dei nomi della tabella figlio.The name of the child table namespace.

parentColumnNames
String[]

Matrice di nomi di oggetti DataColumn nell'oggetto DataTable padre della relazione.An array of DataColumn object names in the parent DataTable of the relation.

childColumnNames
String[]

Matrice di nomi di oggetti DataColumn nell'oggetto DataTable figlio della relazione.An array of DataColumn object names in the child DataTable of the relation.

nested
Boolean Boolean Boolean Boolean

Valore che indica se le relazioni sono annidate.A value that indicates whether relationships are nested.

Commenti

Qualsiasi DataRelation oggetto creato mediante questo costruttore deve quindi essere aggiunto alla raccolta con AddRange.Any DataRelation object created by using this constructor must then be added to the collection with AddRange. Le tabelle e le colonne con i nomi specificati devono esistere nel momento in cui viene chiamato il metodo BeginInit o, se è stato chiamato prima di chiamare questo costruttore, le tabelle e le colonne con i nomi specificati devono EndInit esistere nel momento in cui viene chiamato.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.

Si applica a