DataRelation Constructors

Definitie

Naamruimte:: System.Data

Assembly's:: netstandard.dll, System.Data.Common.dll

Assembly:: System.Data.Common.dll

Assembly:: System.Data.dll

Assembly:: netstandard.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Initialiseert een nieuw exemplaar van de DataRelation klasse.

Overloads

Name	Description
DataRelation(String, DataColumn, DataColumn)	Initialiseert een nieuw exemplaar van de DataRelation klasse met behulp van de opgegeven naam en bovenliggende DataRelation en onderliggende DataColumn objecten.
DataRelation(String, DataColumn[], DataColumn[])	Initialiseert een nieuw exemplaar van de DataRelation klasse met behulp van de opgegeven DataRelation naam en overeenkomende matrices van bovenliggende en onderliggende DataColumn objecten.
DataRelation(String, DataColumn, DataColumn, Boolean)	Initialiseert een nieuw exemplaar van de DataRelation klasse met behulp van de opgegeven naam, bovenliggende en onderliggende DataColumn objecten en een waarde die aangeeft of beperkingen moeten worden gemaakt.
DataRelation(String, DataColumn[], DataColumn[], Boolean)	Initialiseert een nieuw exemplaar van de DataRelation klasse met behulp van de opgegeven naam, overeenkomende matrices van bovenliggende en onderliggende DataColumn objecten en waarde die aangeeft of beperkingen moeten worden gemaakt.
DataRelation(String, String, String, String[], String[], Boolean)	Deze constructor wordt geleverd voor ontwerptijdondersteuning in de Visual Studio-omgeving.
DataRelation(String, String, String, String, String, String[], String[], Boolean)	Deze constructor wordt geleverd voor ontwerptijdondersteuning in de Visual Studio-omgeving.

DataRelation(String, DataColumn, DataColumn)

Bron:: DataRelation.cs

Bron:: DataRelation.cs

Bron:: DataRelation.cs

Bron:: DataRelation.cs

Bron:: DataRelation.cs

Initialiseert een nieuw exemplaar van de DataRelation klasse met behulp van de opgegeven naam en bovenliggende DataRelation en onderliggende DataColumn objecten.

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)

Parameters

relationName: String

De naam van de DataRelation. Als null of een lege tekenreeks (""), wordt er een standaardnaam gegeven wanneer het gemaakte object wordt toegevoegd aan de DataRelationCollection.

parentColumn: DataColumn

Het bovenliggende DataColumn item in de relatie.

childColumn: DataColumn

Het kind DataColumn in de relatie.

Uitzonderingen

ArgumentNullException

Een of beide objecten DataColumn bevatten null.

InvalidConstraintException

De kolommen hebben verschillende gegevenstypen

-Of-

De tabellen horen niet bij hetzelfde DataSet.

Voorbeelden

In het volgende voorbeeld wordt een nieuwe DataRelation gemaakt en toegevoegd aan een DataRelationCollection 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

Zie ook

Van toepassing op

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

Bron:: DataRelation.cs

Bron:: DataRelation.cs

Bron:: DataRelation.cs

Bron:: DataRelation.cs

Bron:: DataRelation.cs

Initialiseert een nieuw exemplaar van de DataRelation klasse met behulp van de opgegeven DataRelation naam en overeenkomende matrices van bovenliggende en onderliggende DataColumn objecten.

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

Parameters

relationName: String

De naam van de relatie. Als null of een lege tekenreeks (""), wordt er een standaardnaam gegeven wanneer het gemaakte object wordt toegevoegd aan de DataRelationCollection.

parentColumns: DataColumn[]

Een matrix met bovenliggende DataColumn objecten.

childColumns: DataColumn[]

Een matrix met onderliggende DataColumn objecten.

Uitzonderingen

ArgumentNullException

Een of beide objecten DataColumn bevatten null.

InvalidConstraintException

De DataColumn objecten hebben verschillende gegevenstypen

-Of-

Een of beide matrices bestaan niet uit afzonderlijke kolommen uit dezelfde tabel.

-Of-

De tabellen horen niet bij hetzelfde DataSet.

Voorbeelden

In het volgende voorbeeld wordt een nieuwe DataRelation gemaakt en toegevoegd aan een DataRelationCollection 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

Zie ook

Van toepassing op

DataRelation(String, DataColumn, DataColumn, Boolean)

Bron:: DataRelation.cs

Bron:: DataRelation.cs

Bron:: DataRelation.cs

Bron:: DataRelation.cs

Bron:: DataRelation.cs

Initialiseert een nieuw exemplaar van de DataRelation klasse met behulp van de opgegeven naam, bovenliggende en onderliggende DataColumn objecten en een waarde die aangeeft of beperkingen moeten worden gemaakt.

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)

Parameters

relationName: String

De naam van de relatie. Als null of een lege tekenreeks (""), wordt er een standaardnaam gegeven wanneer het gemaakte object wordt toegevoegd aan de DataRelationCollection.

parentColumn: DataColumn

Het bovenliggende DataColumn element in de relatie.

childColumn: DataColumn

Het kind DataColumn in de relatie.

createConstraints: Boolean

Een waarde die aangeeft of er beperkingen worden gemaakt. true, als er beperkingen worden gemaakt. Anders false.

Uitzonderingen

ArgumentNullException

Een of beide objecten DataColumn bevatten null.

InvalidConstraintException

De kolommen hebben verschillende gegevenstypen

-Of-

De tabellen horen niet bij hetzelfde DataSet.

Voorbeelden

In het volgende voorbeeld wordt een nieuwe DataRelation gemaakt en toegevoegd aan een DataRelationCollection 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

Zie ook

Van toepassing op

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

Bron:: DataRelation.cs

Bron:: DataRelation.cs

Bron:: DataRelation.cs

Bron:: DataRelation.cs

Bron:: DataRelation.cs

Initialiseert een nieuw exemplaar van de DataRelation klasse met behulp van de opgegeven naam, overeenkomende matrices van bovenliggende en onderliggende DataColumn objecten en waarde die aangeeft of beperkingen moeten worden gemaakt.

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)

Parameters

relationName: String

De naam van de relatie. Als null of een lege tekenreeks (""), wordt er een standaardnaam gegeven wanneer het gemaakte object wordt toegevoegd aan de DataRelationCollection.

parentColumns: DataColumn[]

Een matrix met bovenliggende DataColumn objecten.

childColumns: DataColumn[]

Een matrix met onderliggende DataColumn objecten.

createConstraints: Boolean

Een waarde die aangeeft of er beperkingen moeten worden gemaakt. true, als er beperkingen worden gemaakt. Anders false.

Uitzonderingen

ArgumentNullException

Een of beide DataColumn objecten zijn null.

InvalidConstraintException

De kolommen hebben verschillende gegevenstypen

-Of-

De tabellen horen niet bij hetzelfde DataSet.

Voorbeelden

In het volgende voorbeeld wordt een nieuwe DataRelation gemaakt en toegevoegd aan een DataRelationCollection 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

Zie ook

Van toepassing op

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

Bron:: DataRelation.cs

Bron:: DataRelation.cs

Bron:: DataRelation.cs

Bron:: DataRelation.cs

Bron:: DataRelation.cs

Deze constructor wordt geleverd voor ontwerptijdondersteuning in de Visual Studio-omgeving.

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)

Parameters

relationName: String

De naam van de relatie. Als null of een lege tekenreeks (""), wordt er een standaardnaam gegeven wanneer het gemaakte object wordt toegevoegd aan de DataRelationCollection.

parentTableName: String

De naam van de DataTable bovenliggende tabel van de relatie.

childTableName: String

De naam van de DataTable onderliggende tabel van de relatie.

parentColumnNames: String[]

Een matrix met DataColumn objectnamen in het bovenliggende DataTable element van de relatie.

childColumnNames: String[]

Een matrix met DataColumn objectnamen in het onderliggende DataTable element van de relatie.

nested: Boolean

Een waarde die aangeeft of relaties zijn genest.

Kenmerken: BrowsableAttribute

Opmerkingen

Elk DataRelation object dat met deze constructor wordt gemaakt, moet worden toegevoegd aan de verzameling met de AddRange methode binnen een BeginInit en EndInit blok. Als deze constructor niet wordt aangeroepen tussen BeginInit en EndInit een NullReferenceException wordt uitgevoerd. Bovendien moeten de tabellen en kolommen met de opgegeven namen bestaan op het moment dat de constructor wordt aangeroepen.

Van toepassing op

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

Bron:: DataRelation.cs

Bron:: DataRelation.cs

Bron:: DataRelation.cs

Bron:: DataRelation.cs

Bron:: DataRelation.cs

Deze constructor wordt geleverd voor ontwerptijdondersteuning in de Visual Studio-omgeving.

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)

Parameters

relationName: String

De naam van de DataRelation. Als null of een lege tekenreeks (""), wordt er een standaardnaam gegeven wanneer het gemaakte object wordt toegevoegd aan de DataRelationCollection.

parentTableName: String

De naam van de DataTable bovenliggende tabel van de relatie.

parentTableNamespace: String

De naam van de bovenliggende tabelnaamruimte.

childTableName: String

De naam van de DataTable onderliggende tabel van de relatie.

childTableNamespace: String

De naam van de naamruimte van de onderliggende tabel.

parentColumnNames: String[]

Een matrix met DataColumn objectnamen in het bovenliggende DataTable element van de relatie.

childColumnNames: String[]

Een matrix met DataColumn objectnamen in het onderliggende DataTable element van de relatie.

nested: Boolean

Een waarde die aangeeft of relaties zijn genest.

Kenmerken: BrowsableAttribute

Opmerkingen

Elk DataRelation object dat met deze constructor wordt gemaakt, moet vervolgens worden toegevoegd aan de verzameling met AddRange. Tabellen en kolommen met de opgegeven namen moeten bestaan op het moment dat de methode wordt aangeroepen, of als BeginInit deze constructor is aangeroepen voordat deze constructor wordt aangeroepen, moeten de tabellen en kolommen met de opgegeven namen bestaan op het moment dat deze EndInit wordt aangeroepen.

Van toepassing op

Feedback

Is deze pagina nuttig?