Condividi tramite


DataRelation Costruttori

Definizione

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

Uno o entrambi gli oggetti DataColumn sono null.

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

Uno o entrambi gli oggetti DataColumn sono null.

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

Uno o entrambi gli oggetti DataColumn sono null.

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

Uno o entrambi gli oggetti DataColumn sono null.

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

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

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