DataRelation Costruttori

Riferimento

Definizione

Spazio dei nomi:: System.Data

Assembly:: System.Data.Common.dll

Assembly:: System.Data.dll

Assembly:: netstandard.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Inizializza una nuova istanza della classe DataRelation.

Overload

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.
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.
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.
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.
DataRelation(String, String, String, String[], String[], Boolean)	Questo costruttore viene fornito per il supporto in fase di progettazione nell'ambiente Visual Studio.
DataRelation(String, String, String, String, String, String[], String[], Boolean)	Questo costruttore viene fornito per il supporto in fase di progettazione nell'ambiente Visual Studio.

DataRelation(String, DataColumn, DataColumn)

Origine:: DataRelation.cs

Origine:: DataRelation.cs

Origine:: DataRelation.cs

Inizializza una nuova istanza della classe DataRelation utilizzando il nome dell'oggetto DataRelation specificato e gli oggetti DataColumn padre e figlio.

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)

Parametri

relationName: String

Nome di 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.

parentColumn: DataColumn

Oggetto DataColumn padre della relazione.

childColumn: DataColumn

Oggetto DataColumn figlio della relazione.

Eccezioni

ArgumentNullException

Uno o entrambi gli oggetti DataColumn sono null.

InvalidConstraintException

Le colonne presentano tipi di dati diversi

Oppure

Le tabelle non appartengono allo stesso DataSet.

Esempio

Nell'esempio seguente viene creato un nuovo DataRelation oggetto e viene aggiunto all'oggetto DataRelationCollection di un oggetto 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

Si applica a

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

Origine:: DataRelation.cs

Origine:: DataRelation.cs

Origine:: DataRelation.cs

Inizializza una nuova istanza della classe DataRelation utilizzando il nome dell'oggetto DataRelation specificato e le matrici corrispondenti di oggetti DataColumn padre e figlio.

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

Parametri

relationName: String

Nome della relazione. 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.

parentColumns: DataColumn[]

Matrice di oggetti DataColumn padre.

childColumns: DataColumn[]

Matrice di oggetti DataColumn figlio.

Eccezioni

ArgumentNullException

Uno o entrambi gli oggetti DataColumn sono null.

InvalidConstraintException

Gli oggetti DataColumn presentano tipi di dati diversi

Oppure

Una o entrambe le matrici non sono composte da colonne distinte della stessa tabella.

Oppure

Le tabelle non appartengono allo stesso DataSet.

Esempio

Nell'esempio seguente viene creato un nuovo DataRelation oggetto e viene aggiunto all'oggetto DataRelationCollection di un oggetto 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

Si applica a

DataRelation(String, DataColumn, DataColumn, Boolean)

Origine:: DataRelation.cs

Origine:: DataRelation.cs

Origine:: DataRelation.cs

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.

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)

Parametri

relationName: String

Nome della relazione. 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.

parentColumn: DataColumn

Oggetto DataColumn padre della relazione.

childColumn: DataColumn

Oggetto DataColumn figlio della relazione.

createConstraints: Boolean

Valore che indica se vengono creati vincoli. true se i vincoli vengono creati. In caso contrario, false.

Eccezioni

ArgumentNullException

Uno o entrambi gli oggetti DataColumn sono null.

InvalidConstraintException

Le colonne presentano tipi di dati diversi

Oppure

Le tabelle non appartengono allo stesso DataSet.

Esempio

Nell'esempio seguente viene creato un nuovo DataRelation oggetto e viene aggiunto all'oggetto DataRelationCollection di un oggetto 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

Si applica a

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

Origine:: DataRelation.cs

Origine:: DataRelation.cs

Origine:: DataRelation.cs

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.

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)

Parametri

relationName: String

Nome della relazione. 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.

parentColumns: DataColumn[]

Matrice di oggetti DataColumn padre.

childColumns: DataColumn[]

Matrice di oggetti DataColumn figlio.

createConstraints: Boolean

Valore che indica se creare vincoli. true se i vincoli vengono creati. In caso contrario, false.

Eccezioni

ArgumentNullException

Uno o entrambi gli oggetti DataColumn sono null.

InvalidConstraintException

Le colonne presentano tipi di dati diversi

Oppure

Le tabelle non appartengono allo stesso DataSet.

Esempio

Nell'esempio seguente viene creato un nuovo DataRelation oggetto e viene aggiunto all'oggetto DataRelationCollection di un oggetto 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

Si applica a

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

Origine:: DataRelation.cs

Origine:: DataRelation.cs

Origine:: DataRelation.cs

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

Parametri

relationName: String

Nome della relazione. 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.

parentTableName: String

Nome dell'oggetto DataTable che rappresenta la tabella padre della relazione.

childTableName: String

Nome dell'oggetto DataTable che rappresenta la tabella figlio della relazione.

parentColumnNames: String[]

Matrice di nomi di oggetti DataColumn nell'oggetto DataTable padre della relazione.

childColumnNames: String[]

Matrice di nomi di oggetti DataColumn nell'oggetto DataTable figlio della relazione.

nested: Boolean

Valore che indica se le relazioni sono annidate.

Attributi: BrowsableAttribute

Commenti

Qualsiasi DataRelation oggetto creato utilizzando questo costruttore deve essere aggiunto alla raccolta con il AddRange metodo all'interno di un BeginInit blocco e EndInit . Se questo costruttore non viene chiamato tra BeginInit e EndInit si verificherà un oggetto NullReferenceException . Inoltre, le tabelle e le colonne con i nomi specificati devono esistere al momento della chiamata del costruttore.

Si applica a

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

Origine:: DataRelation.cs

Origine:: DataRelation.cs

Origine:: DataRelation.cs

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

Parametri

relationName: String

Nome di 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.

parentTableName: String

Nome dell'oggetto DataTable che rappresenta la tabella padre della relazione.

parentTableNamespace: String

Nome dello spazio dei nomi della tabella padre.

childTableName: String

Nome dell'oggetto DataTable che rappresenta la tabella figlio della relazione.

childTableNamespace: String

Nome dello spazio dei nomi della tabella figlio.

parentColumnNames: String[]

Matrice di nomi di oggetti DataColumn nell'oggetto DataTable padre della relazione.

childColumnNames: String[]

Matrice di nomi di oggetti DataColumn nell'oggetto DataTable figlio della relazione.

nested: Boolean

Valore che indica se le relazioni sono annidate.

Attributi: BrowsableAttribute

Commenti

Qualsiasi DataRelation oggetto creato utilizzando questo costruttore deve quindi essere aggiunto all'insieme con AddRange. Le tabelle e le colonne con i nomi specificati devono esistere al momento della chiamata al metodo oppure se BeginInit è stato chiamato prima di chiamare questo costruttore, le tabelle e le colonne con i nomi specificati devono esistere al momento EndInit della chiamata.

Si applica a

DataRelation Costruttori

Definizione

Overload

DataRelation(String, DataColumn, DataColumn)

Parametri

Eccezioni

Esempio

Vedi anche

Si applica a

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

Parametri

Eccezioni

Esempio

Vedi anche

Si applica a

DataRelation(String, DataColumn, DataColumn, Boolean)

Parametri

Eccezioni

Esempio

Vedi anche

Si applica a

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

Parametri

Eccezioni

Esempio

Vedi anche

Si applica a

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

Parametri

Commenti

Si applica a

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

Parametri

Commenti

Si applica a

Commenti e suggerimenti

Risorse aggiuntive