DataRelation Konstruktorer

Definition

Namnområde:: System.Data

Sammansättning:: System.Data.dll

Sammansättning:: netstandard.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Initierar en ny instans av DataRelation klassen.

Överlagringar

Name	Description
DataRelation(String, DataColumn, DataColumn)	Initierar en ny instans av DataRelation klassen med det angivna DataRelation namnet och överordnade och underordnade DataColumn objekt.
DataRelation(String, DataColumn[], DataColumn[])	Initierar en ny instans av DataRelation klassen med det angivna DataRelation namnet och matchade matriser med överordnade och underordnade DataColumn objekt.
DataRelation(String, DataColumn, DataColumn, Boolean)	Initierar en ny instans av DataRelation klassen med det angivna namnet, överordnat och underordnat DataColumn objekt och ett värde som anger om du vill skapa begränsningar.
DataRelation(String, DataColumn[], DataColumn[], Boolean)	Initierar en ny instans av DataRelation klassen med det angivna namnet, matchade matriser med överordnade och underordnade DataColumn objekt och värde som anger om begränsningar ska skapas.
DataRelation(String, String, String, String[], String[], Boolean)	Den här konstruktorn tillhandahålls för stöd för designtid i den Visual Studio miljön.
DataRelation(String, String, String, String, String, String[], String[], Boolean)	Den här konstruktorn tillhandahålls för stöd för designtid i den Visual Studio miljön.

DataRelation(String, DataColumn, DataColumn)

Initierar en ny instans av DataRelation klassen med det angivna DataRelation namnet och överordnade och underordnade DataColumn objekt.

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)

Parametrar

relationName: String

Namnet på DataRelation. Om null eller en tom sträng (") anges ett standardnamn när det skapade objektet läggs till i DataRelationCollection.

parentColumn: DataColumn

Den överordnade DataColumn i relationen.

childColumn: DataColumn

DataColumn Barnet i relationen.

Undantag

ArgumentNullException

Ett eller båda objekten DataColumn innehåller null.

InvalidConstraintException

Kolumnerna har olika datatyper

-eller-

Tabellerna tillhör inte samma DataSet.

Exempel

I följande exempel skapas en ny DataRelation och läggs till i DataRelationCollection en 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

Se även

Gäller för

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

Initierar en ny instans av DataRelation klassen med det angivna DataRelation namnet och matchade matriser med överordnade och underordnade DataColumn objekt.

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

Parametrar

relationName: String

Namnet på relationen. Om null eller en tom sträng (") anges ett standardnamn när det skapade objektet läggs till i DataRelationCollection.

parentColumns: DataColumn[]

En matris med överordnade DataColumn objekt.

childColumns: DataColumn[]

En matris med underordnade DataColumn objekt.

Undantag

ArgumentNullException

Ett eller båda objekten DataColumn innehåller null.

InvalidConstraintException

Objekten DataColumn har olika datatyper

-eller-

En eller båda matriserna består inte av distinkta kolumner från samma tabell.

-eller-

Tabellerna tillhör inte samma DataSet.

Exempel

I följande exempel skapas en ny DataRelation och läggs till i DataRelationCollection en 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

Se även

Gäller för

DataRelation(String, DataColumn, DataColumn, Boolean)

Initierar en ny instans av DataRelation klassen med det angivna namnet, överordnat och underordnat DataColumn objekt och ett värde som anger om du vill skapa begränsningar.

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)

Parametrar

relationName: String

Namnet på relationen. Om null eller en tom sträng (") anges ett standardnamn när det skapade objektet läggs till i DataRelationCollection.

parentColumn: DataColumn

Den överordnade DataColumn i relationen.

childColumn: DataColumn

DataColumn Barnet i relationen.

createConstraints: Boolean

Ett värde som anger om begränsningar skapas. true, om begränsningar skapas. Annars, false.

Undantag

ArgumentNullException

Ett eller båda objekten DataColumn innehåller null.

InvalidConstraintException

Kolumnerna har olika datatyper

-eller-

Tabellerna tillhör inte samma DataSet.

Exempel

I följande exempel skapas en ny DataRelation och läggs till i DataRelationCollection en 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

Se även

Gäller för

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

Initierar en ny instans av DataRelation klassen med det angivna namnet, matchade matriser med överordnade och underordnade DataColumn objekt och värde som anger om begränsningar ska skapas.

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)

Parametrar

relationName: String

Namnet på relationen. Om null eller en tom sträng (") anges ett standardnamn när det skapade objektet läggs till i DataRelationCollection.

parentColumns: DataColumn[]

En matris med överordnade DataColumn objekt.

childColumns: DataColumn[]

En matris med underordnade DataColumn objekt.

createConstraints: Boolean

Ett värde som anger om du vill skapa begränsningar. true, om begränsningar skapas. Annars, false.

Undantag

ArgumentNullException

Ett eller båda objekten DataColumn är null.

InvalidConstraintException

Kolumnerna har olika datatyper

-eller-

Tabellerna tillhör inte samma DataSet.

Exempel

I följande exempel skapas en ny DataRelation och läggs till i DataRelationCollection en 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

Se även

Gäller för

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

Den här konstruktorn tillhandahålls för stöd för designtid i den Visual Studio miljön.

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)

Parametrar

relationName: String

Namnet på relationen. Om null eller en tom sträng (") anges ett standardnamn när det skapade objektet läggs till i DataRelationCollection.

parentTableName: String

Namnet på den DataTable överordnade tabellen i relationen.

childTableName: String

Namnet på den DataTable underordnade tabellen i relationen.

parentColumnNames: String[]

En matris med DataColumn objektnamn i relationens överordnade DataTable .

childColumnNames: String[]

En matris med DataColumn objektnamn i den underordnade DataTable relationen.

nested: Boolean

Ett värde som anger om relationer är kapslade.

Attribut: BrowsableAttribute

Kommentarer

Alla DataRelation objekt som skapas med hjälp av den här konstruktorn måste läggas till i samlingen med AddRange metoden inuti ett BeginInit och EndInit -block. Om den här konstruktorn inte anropas mellan BeginInit och EndInit en NullReferenceException inträffar. Dessutom måste tabellerna och kolumnerna med de angivna namnen finnas när konstruktorn anropas.

Gäller för

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

Den här konstruktorn tillhandahålls för stöd för designtid i den Visual Studio miljön.

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)

Parametrar

relationName: String

Namnet på DataRelation. Om null eller en tom sträng (") anges ett standardnamn när det skapade objektet läggs till i DataRelationCollection.

parentTableName: String

Namnet på den DataTable överordnade tabellen i relationen.

parentTableNamespace: String

Namnet på det överordnade tabellnamnområdet.

childTableName: String

Namnet på den DataTable underordnade tabellen i relationen.

childTableNamespace: String

Namnet på det underordnade tabellnamnområdet.

parentColumnNames: String[]

En matris med DataColumn objektnamn i relationens överordnade DataTable .

childColumnNames: String[]

En matris med DataColumn objektnamn i den underordnade DataTable relationen.

nested: Boolean

Ett värde som anger om relationer är kapslade.

Attribut: BrowsableAttribute

Kommentarer

Alla DataRelation objekt som skapas med den här konstruktorn måste sedan läggas till i samlingen med AddRange. Tabeller och kolumner med de angivna namnen måste finnas när metoden anropas, eller om BeginInit den anropas innan konstruktorn anropas måste tabellerna och kolumnerna med de angivna namnen finnas vid den tidpunkt då EndInit anropas.

Gäller för

Feedback

Var den här sidan till hjälp?