DataRelation Costruttori

Definizione

Spazio dei nomi:: System.Data

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

Nome	Descrizione
DataRelation(String, DataColumn, DataColumn)	Inizializza una nuova istanza della DataRelation classe utilizzando il nome e gli oggetti padre e figlio DataRelation specificatiDataColumn.
DataRelation(String, DataColumn[], DataColumn[])	Inizializza una nuova istanza della DataRelation classe utilizzando il nome e le matrici corrispondenti degli oggetti padre e figlio DataRelation specificatiDataColumn.
DataRelation(String, DataColumn, DataColumn, Boolean)	Inizializza una nuova istanza della DataRelation classe utilizzando il nome, gli oggetti padre e figlio DataColumn specificati e un valore che indica se creare vincoli.
DataRelation(String, DataColumn[], DataColumn[], Boolean)	Inizializza una nuova istanza della DataRelation classe utilizzando il nome specificato, matrici corrispondenti di oggetti padre e figlio DataColumn e valore che indica se creare vincoli.
DataRelation(String, String, String, String[], String[], Boolean)	Questo costruttore viene fornito per il supporto della fase di progettazione nell'ambiente di Visual Studio.
DataRelation(String, String, String, String, String, String[], String[], Boolean)	Questo costruttore viene fornito per il supporto della fase di progettazione nell'ambiente di Visual Studio.

DataRelation(String, DataColumn, DataColumn)

Inizializza una nuova istanza della DataRelation classe utilizzando il nome e gli oggetti padre e figlio DataRelation specificatiDataColumn.

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

Nome del DataRelation. Se null o una stringa vuota (""), verrà assegnato un nome predefinito quando l'oggetto creato viene aggiunto a DataRelationCollection.

parentColumn: DataColumn

Elemento padre DataColumn nella relazione.

childColumn: DataColumn

Elemento figlio DataColumn nella relazione.

Eccezioni

ArgumentNullException

Uno o entrambi gli DataColumn oggetti contengono null.

InvalidConstraintException

Le colonne hanno tipi di dati diversi

-Or-

Le tabelle non appartengono allo stesso DataSetoggetto .

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[])

Inizializza una nuova istanza della DataRelation classe utilizzando il nome e le matrici corrispondenti degli oggetti padre e figlio DataRelation specificatiDataColumn.

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

Nome della relazione. Se null o una stringa vuota (""), verrà assegnato un nome predefinito quando l'oggetto creato viene aggiunto a DataRelationCollection.

parentColumns: DataColumn[]

Matrice di oggetti padre DataColumn .

childColumns: DataColumn[]

Matrice di oggetti figlio DataColumn .

Eccezioni

ArgumentNullException

Uno o entrambi gli DataColumn oggetti contengono null.

InvalidConstraintException

Gli DataColumn oggetti hanno tipi di dati diversi

-Or-

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

-Or-

Le tabelle non appartengono allo stesso DataSetoggetto .

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)

Inizializza una nuova istanza della DataRelation classe utilizzando il nome, gli oggetti padre e figlio DataColumn specificati 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);

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 null o una stringa vuota (""), verrà assegnato un nome predefinito quando l'oggetto creato viene aggiunto a DataRelationCollection.

parentColumn: DataColumn

Elemento padre DataColumn nella relazione.

childColumn: DataColumn

DataColumn Figlio nella relazione.

createConstraints: Boolean

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

Eccezioni

ArgumentNullException

Uno o entrambi gli DataColumn oggetti contengono null.

InvalidConstraintException

Le colonne hanno tipi di dati diversi

-Or-

Le tabelle non appartengono allo stesso DataSetoggetto .

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)

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

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 null o una stringa vuota (""), verrà assegnato un nome predefinito quando l'oggetto creato viene aggiunto a DataRelationCollection.

parentColumns: DataColumn[]

Matrice di oggetti padre DataColumn .

childColumns: DataColumn[]

Matrice di oggetti figlio DataColumn .

createConstraints: Boolean

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

Eccezioni

ArgumentNullException

Uno o entrambi gli DataColumn oggetti sono null.

InvalidConstraintException

Le colonne hanno tipi di dati diversi

-Or-

Le tabelle non appartengono allo stesso DataSetoggetto .

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)

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

Parametri

relationName: String

Nome della relazione. Se null o una stringa vuota (""), verrà assegnato un nome predefinito quando l'oggetto creato viene aggiunto a 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 DataColumn oggetti nell'elemento padre DataTable della relazione.

childColumnNames: String[]

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

nested: Boolean

Valore che indica se le relazioni sono annidate.

Attributi: BrowsableAttribute

Commenti

Qualsiasi DataRelation oggetto creato tramite questo costruttore deve essere aggiunto all'insieme con il AddRange metodo all'interno di un BeginInit blocco e EndInit . Se questo costruttore non viene chiamato tra BeginInit e EndInit verrà generato 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)

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

Parametri

relationName: String

Nome del DataRelation. Se null o una stringa vuota (""), verrà assegnato un nome predefinito quando l'oggetto creato viene aggiunto a 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 DataColumn oggetti nell'elemento padre DataTable della relazione.

childColumnNames: String[]

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

nested: Boolean

Valore che indica se le relazioni sono annidate.

Attributi: BrowsableAttribute

Commenti

Qualsiasi DataRelation oggetto creato tramite questo costruttore deve quindi essere aggiunto alla raccolta 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

Commenti e suggerimenti

Questa pagina è stata utile?