DataRelation Konstruktoren

Definition

Namespace:: System.Data

Assembly:: System.Data.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Initialisiert eine neue Instanz der DataRelation-Klasse.

Überlädt

Name	Beschreibung
DataRelation(String, DataColumn, DataColumn)	Initialisiert eine neue Instanz der DataRelation Klasse mit dem angegebenen DataRelation Namen und übergeordneten und untergeordneten DataColumn Objekten.
DataRelation(String, DataColumn[], DataColumn[])	Initialisiert eine neue Instanz der DataRelation Klasse mithilfe des angegebenen DataRelation Namens und übereinstimmenden Arrays von übergeordneten und untergeordneten DataColumn Objekten.
DataRelation(String, DataColumn, DataColumn, Boolean)	Initialisiert eine neue Instanz der DataRelation Klasse mit dem angegebenen Namen, übergeordneten und untergeordneten DataColumn Objekten und einem Wert, der angibt, ob Einschränkungen erstellt werden sollen.
DataRelation(String, DataColumn[], DataColumn[], Boolean)	Initialisiert eine neue Instanz der DataRelation Klasse mit dem angegebenen Namen, übereinstimmenden Arrays von übergeordneten und untergeordneten DataColumn Objekten und Wert, die angibt, ob Einschränkungen erstellt werden sollen.
DataRelation(String, String, String, String[], String[], Boolean)	Dieser Konstruktor wird für die Entwurfszeitunterstützung in der Visual Studio-Umgebung bereitgestellt.
DataRelation(String, String, String, String, String, String[], String[], Boolean)	Dieser Konstruktor wird für die Entwurfszeitunterstützung in der Visual Studio-Umgebung bereitgestellt.

DataRelation(String, DataColumn, DataColumn)

Initialisiert eine neue Instanz der DataRelation Klasse mit dem angegebenen DataRelation Namen und übergeordneten und untergeordneten DataColumn Objekten.

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)

Parameter

relationName: String

Der Name des DataRelation. Wenn null oder eine leere Zeichenfolge (""), wird ein Standardname angegeben, wenn das erstellte Objekt dem DataRelationCollectionhinzugefügt wird.

parentColumn: DataColumn

Das übergeordnete Element DataColumn in der Beziehung.

childColumn: DataColumn

Das untergeordnete Element DataColumn in der Beziehung.

Ausnahmen

ArgumentNullException

Mindestens eines der DataColumn Objekte enthält null.

InvalidConstraintException

Die Spalten weisen unterschiedliche Datentypen auf

-ODER-

Die Tabellen gehören nicht zu demselben DataSet.

Beispiele

Im folgenden Beispiel wird ein neues DataRelation erstellt und dem DataRelationCollection Objekt eines 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

Weitere Informationen

Gilt für:

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

Initialisiert eine neue Instanz der DataRelation Klasse mithilfe des angegebenen DataRelation Namens und übereinstimmenden Arrays von übergeordneten und untergeordneten DataColumn Objekten.

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

Parameter

relationName: String

Der Name der Beziehung. Wenn null oder eine leere Zeichenfolge (""), wird ein Standardname angegeben, wenn das erstellte Objekt dem DataRelationCollectionhinzugefügt wird.

parentColumns: DataColumn[]

Ein Array von übergeordneten DataColumn Objekten.

childColumns: DataColumn[]

Ein Array untergeordneter DataColumn Objekte.

Ausnahmen

ArgumentNullException

Mindestens eines der DataColumn Objekte enthält null.

InvalidConstraintException

Die DataColumn Objekte weisen unterschiedliche Datentypen auf

-ODER-

Eine oder beide Arrays bestehen nicht aus unterschiedlichen Spalten aus derselben Tabelle.

-ODER-

Die Tabellen gehören nicht zu demselben DataSet.

Beispiele

Im folgenden Beispiel wird ein neues DataRelation erstellt und dem DataRelationCollection Objekt eines 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

Weitere Informationen

Gilt für:

DataRelation(String, DataColumn, DataColumn, Boolean)

Initialisiert eine neue Instanz der DataRelation Klasse mit dem angegebenen Namen, übergeordneten und untergeordneten DataColumn Objekten und einem Wert, der angibt, ob Einschränkungen erstellt werden sollen.

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)

Parameter

relationName: String

Der Name der Beziehung. Wenn null oder eine leere Zeichenfolge (""), wird ein Standardname angegeben, wenn das erstellte Objekt dem DataRelationCollectionhinzugefügt wird.

parentColumn: DataColumn

Das übergeordnete Element DataColumn in der Beziehung.

childColumn: DataColumn

Das untergeordnete Element DataColumn in der Beziehung.

createConstraints: Boolean

Ein Wert, der angibt, ob Einschränkungen erstellt werden. true, wenn Einschränkungen erstellt werden. Andernfalls, false.

Ausnahmen

ArgumentNullException

Mindestens eines der DataColumn Objekte enthält null.

InvalidConstraintException

Die Spalten weisen unterschiedliche Datentypen auf

-ODER-

Die Tabellen gehören nicht zu demselben DataSet.

Beispiele

Im folgenden Beispiel wird ein neues DataRelation erstellt und dem DataRelationCollection Objekt eines 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

Weitere Informationen

Gilt für:

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

Initialisiert eine neue Instanz der DataRelation Klasse mit dem angegebenen Namen, übereinstimmenden Arrays von übergeordneten und untergeordneten DataColumn Objekten und Wert, die angibt, ob Einschränkungen erstellt werden sollen.

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)

Parameter

relationName: String

Der Name der Beziehung. Wenn null oder eine leere Zeichenfolge (""), wird ein Standardname angegeben, wenn das erstellte Objekt dem DataRelationCollectionhinzugefügt wird.

parentColumns: DataColumn[]

Ein Array von übergeordneten DataColumn Objekten.

childColumns: DataColumn[]

Ein Array untergeordneter DataColumn Objekte.

createConstraints: Boolean

Ein Wert, der angibt, ob Einschränkungen erstellt werden sollen. true, wenn Einschränkungen erstellt werden. Andernfalls, false.

Ausnahmen

ArgumentNullException

Mindestens eines der DataColumn Objekte ist null.

InvalidConstraintException

Die Spalten weisen unterschiedliche Datentypen auf

-ODER-

Die Tabellen gehören nicht zu demselben DataSet.

Beispiele

Im folgenden Beispiel wird ein neues DataRelation erstellt und dem DataRelationCollection Objekt eines 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

Weitere Informationen

Gilt für:

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

Dieser Konstruktor wird für die Entwurfszeitunterstützung in der Visual Studio-Umgebung bereitgestellt.

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)

Parameter

relationName: String

Der Name der Beziehung. Wenn null oder eine leere Zeichenfolge (""), wird ein Standardname angegeben, wenn das erstellte Objekt dem DataRelationCollectionhinzugefügt wird.

parentTableName: String

Der Name des Übergeordneten DataTable Tabellen der Beziehung.

childTableName: String

Der Name des elements DataTable ist die untergeordnete Tabelle der Beziehung.

parentColumnNames: String[]

Ein Array von Objektnamen im übergeordneten DataColumn DataTable Element der Beziehung.

childColumnNames: String[]

Ein Array von Objektnamen im untergeordneten DataColumn DataTable Element der Beziehung.

nested: Boolean

Ein Wert, der angibt, ob Beziehungen geschachtelt sind.

Attribute: BrowsableAttribute

Hinweise

Jedes DataRelation Objekt, das mit diesem Konstruktor erstellt wird, muss der Auflistung mit der AddRange Methode innerhalb eines Und EndInit BeginInit Blocks hinzugefügt werden. Wenn dieser Konstruktor nicht zwischen BeginInit und EndInit a aufgerufen wird, tritt ein NullReferenceException . Darüber hinaus müssen die Tabellen und Spalten mit den angegebenen Namen zum Zeitpunkt des Aufrufs des Konstruktors vorhanden sein.

Gilt für:

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

Dieser Konstruktor wird für die Entwurfszeitunterstützung in der Visual Studio-Umgebung bereitgestellt.

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)

Parameter

relationName: String

Der Name des DataRelation. Wenn null oder eine leere Zeichenfolge (""), wird ein Standardname angegeben, wenn das erstellte Objekt dem DataRelationCollectionhinzugefügt wird.

parentTableName: String

Der Name des Übergeordneten DataTable Tabellen der Beziehung.

parentTableNamespace: String

Der Name des übergeordneten Tabellennamespaces.

childTableName: String

Der Name des elements DataTable ist die untergeordnete Tabelle der Beziehung.

childTableNamespace: String

Der Name des namespace der untergeordneten Tabelle.

parentColumnNames: String[]

Ein Array von Objektnamen im übergeordneten DataColumn DataTable Element der Beziehung.

childColumnNames: String[]

Ein Array von Objektnamen im untergeordneten DataColumn DataTable Element der Beziehung.

nested: Boolean

Ein Wert, der angibt, ob Beziehungen geschachtelt sind.

Attribute: BrowsableAttribute

Hinweise

Jedes DataRelation objekt, das mit diesem Konstruktor erstellt wird, muss dann der Auflistung mit AddRangehinzugefügt werden. Tabellen und Spalten mit den angegebenen Namen müssen zum Zeitpunkt des Aufrufs der Methode vorhanden sein, oder wenn BeginInit sie vor dem Aufrufen dieses Konstruktors aufgerufen wurde, müssen die Tabellen und Spalten mit den angegebenen Namen zum Zeitpunkt EndInit des Aufrufs vorhanden sein.

Gilt für:

Feedback

War diese Seite hilfreich?