DataRelation Konstruktoren

Referenz

Definition

Namespace:: System.Data

Assembly:: System.Data.Common.dll

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

DataRelation(String, DataColumn, DataColumn)	Initialisiert eine neue Instanz der DataRelation-Klasse unter Verwendung des angegebenen DataRelation-Namens sowie der angegebenen übergeordneten und untergeordneten DataColumn-Objekte.
DataRelation(String, DataColumn[], DataColumn[])	Initialisiert eine neue Instanz der DataRelation-Klasse unter Verwendung des angegebenen DataRelation-Namens sowie der übereinstimmenden Arrays von übergeordneten und untergeordneten DataColumn-Objekten.
DataRelation(String, DataColumn, DataColumn, Boolean)	Initialisiert eine neue Instanz der DataRelation-Klasse unter Verwendung des angegebenen Namens, der übergeordneten und untergeordneten DataColumn-Objekte sowie eines Werts, der angibt, ob Einschränkungen erstellt werden sollen.
DataRelation(String, DataColumn[], DataColumn[], Boolean)	Initialisiert eine neue Instanz der DataRelation-Klasse unter Verwendung des angegebenen Namens, der übereinstimmenden Arrays von übergeordneten und untergeordneten DataColumn-Objekten sowie eines Werts, der angibt, ob Einschränkungen erstellt werden sollen.
DataRelation(String, String, String, String[], String[], Boolean)	Dieser Konstruktor wird für die Unterstützung zur Entwurfszeit in der Visual Studio-Umgebung bereitgestellt.
DataRelation(String, String, String, String, String, String[], String[], Boolean)	Dieser Konstruktor wird für die Unterstützung zur Entwurfszeit in der Visual Studio-Umgebung bereitgestellt.

DataRelation(String, DataColumn, DataColumn)

Quelle:: DataRelation.cs

Quelle:: DataRelation.cs

Quelle:: DataRelation.cs

Initialisiert eine neue Instanz der DataRelation-Klasse unter Verwendung des angegebenen DataRelation-Namens sowie der angegebenen übergeordneten und untergeordneten DataColumn-Objekte.

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)

Parameter

relationName: String

Der Name von DataRelation. Bei null oder einer leeren Zeichenfolge ("") wird beim Hinzufügen des erstellten Objekts zur DataRelationCollection ein Standardname vergeben.

parentColumn: DataColumn

Die übergeordnete DataColumn in der Beziehung.

childColumn: DataColumn

Die untergeordnete DataColumn in der Beziehung.

Ausnahmen

ArgumentNullException

Eines oder beide der DataColumn-Objekte enthalten null.

InvalidConstraintException

Die Spalten weisen unterschiedliche Datentypen auf.

-Oder-

Die Tabellen gehören nicht zu demselben DataSet.

Beispiele

Im folgenden Beispiel wird eine neue DataRelation erstellt und der DataRelationCollection eines DataSethinzugefügt.

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

Quelle:: DataRelation.cs

Quelle:: DataRelation.cs

Quelle:: DataRelation.cs

Initialisiert eine neue Instanz der DataRelation-Klasse unter Verwendung des angegebenen DataRelation-Namens sowie der ü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);

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. Bei null oder einer leeren Zeichenfolge ("") wird beim Hinzufügen des erstellten Objekts zur DataRelationCollection ein Standardname vergeben.

parentColumns: DataColumn[]

Ein Array von übergeordneten DataColumn-Objekten.

childColumns: DataColumn[]

Ein Array von untergeordneten DataColumn-Objekten.

Ausnahmen

ArgumentNullException

Eines oder beide der DataColumn-Objekte enthalten null.

InvalidConstraintException

Die DataColumn-Objekte weisen unterschiedliche Datentypen auf.

-Oder-

Eines oder beide der Arrays setzen sich nicht aus unterschiedlichen Spalten aus derselben Tabelle zusammen.

-Oder-

Die Tabellen gehören nicht zu demselben DataSet.

Beispiele

Im folgenden Beispiel wird eine neue DataRelation erstellt und der DataRelationCollection eines DataSethinzugefügt.

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)

Quelle:: DataRelation.cs

Quelle:: DataRelation.cs

Quelle:: DataRelation.cs

Initialisiert eine neue Instanz der DataRelation-Klasse unter Verwendung des angegebenen Namens, der übergeordneten und untergeordneten DataColumn-Objekte sowie eines Werts, 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);

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. Bei null oder einer leeren Zeichenfolge ("") wird beim Hinzufügen des erstellten Objekts zur DataRelationCollection ein Standardname vergeben.

parentColumn: DataColumn

Die übergeordnete DataColumn in der Beziehung.

childColumn: DataColumn

Die untergeordnete 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

Eines oder beide der DataColumn-Objekte enthalten null.

InvalidConstraintException

Die Spalten weisen unterschiedliche Datentypen auf.

-Oder-

Die Tabellen gehören nicht zu demselben DataSet.

Beispiele

Im folgenden Beispiel wird eine neue DataRelation erstellt und der DataRelationCollection eines DataSethinzugefügt.


 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)

Quelle:: DataRelation.cs

Quelle:: DataRelation.cs

Quelle:: DataRelation.cs

Initialisiert eine neue Instanz der DataRelation-Klasse unter Verwendung des angegebenen Namens, der übereinstimmenden Arrays von übergeordneten und untergeordneten DataColumn-Objekten sowie eines Werts, der 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);

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. Bei null oder einer leeren Zeichenfolge ("") wird beim Hinzufügen des erstellten Objekts zur DataRelationCollection ein Standardname vergeben.

parentColumns: DataColumn[]

Ein Array von übergeordneten DataColumn-Objekten.

childColumns: DataColumn[]

Ein Array von untergeordneten DataColumn-Objekten.

createConstraints: Boolean

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

Ausnahmen

ArgumentNullException

Eines oder beide der DataColumn-Objekte ist bzw. sind null.

InvalidConstraintException

Die Spalten weisen unterschiedliche Datentypen auf.

-Oder-

Die Tabellen gehören nicht zu demselben DataSet.

Beispiele

Im folgenden Beispiel wird eine neue DataRelation erstellt und der DataRelationCollection eines DataSethinzugefügt.

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)

Quelle:: DataRelation.cs

Quelle:: DataRelation.cs

Quelle:: DataRelation.cs

Dieser Konstruktor wird für die Unterstützung zur Entwurfszeit 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)]
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. Bei null oder einer leeren Zeichenfolge ("") wird beim Hinzufügen des erstellten Objekts zur DataRelationCollection ein Standardname vergeben.

parentTableName: String

Der Name der DataTable, die die übergeordnete Tabelle der Beziehung ist.

childTableName: String

Der Name der DataTable, die die untergeordnete Tabelle der Beziehung ist.

parentColumnNames: String[]

Ein Array von DataColumn-Objektnamen in der übergeordneten DataTable der Beziehung.

childColumnNames: String[]

Ein Array von DataColumn-Objektnamen in der untergeordneten DataTable der Beziehung.

nested: Boolean

Ein Wert, der angibt, ob Beziehungen geschachtelt sind.

Attribute: BrowsableAttribute

Hinweise

Jedes DataRelation mit diesem Konstruktor erstellte Objekt muss der Auflistung mit der AddRange -Methode in einem BeginInit - und EndInit -Block hinzugefügt werden. Wenn dieser Konstruktor nicht zwischen BeginInit und EndInit aufgerufen wird, tritt auf 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)

Quelle:: DataRelation.cs

Quelle:: DataRelation.cs

Quelle:: DataRelation.cs

Dieser Konstruktor wird für die Unterstützung zur Entwurfszeit 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)]
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 von DataRelation. Bei null oder einer leeren Zeichenfolge ("") wird beim Hinzufügen des erstellten Objekts zur DataRelationCollection ein Standardname vergeben.

parentTableName: String

Der Name der DataTable, die die übergeordnete Tabelle der Beziehung ist.

parentTableNamespace: String

Der Name des Namespaces der übergeordneten Tabelle.

childTableName: String

Der Name der DataTable, die die untergeordnete Tabelle der Beziehung ist.

childTableNamespace: String

Der Name des Namespaces der untergeordneten Tabelle.

parentColumnNames: String[]

Ein Array von DataColumn-Objektnamen in der übergeordneten DataTable der Beziehung.

childColumnNames: String[]

Ein Array von DataColumn-Objektnamen in der untergeordneten DataTable der Beziehung.

nested: Boolean

Ein Wert, der angibt, ob Beziehungen geschachtelt sind.

Attribute: BrowsableAttribute

Hinweise

Jedes DataRelation mit diesem Konstruktor erstellte Objekt 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 vor dem Aufruf dieses Konstruktors aufgerufen wurde, müssen die Tabellen und Spalten mit den angegebenen Namen zum Zeitpunkt EndInit des Aufrufs vorhanden sein.

Gilt für:

Freigeben über

DataRelation Konstruktoren

Definition

Überlädt

DataRelation(String, DataColumn, DataColumn)

Parameter

Ausnahmen

Beispiele

Weitere Informationen

Gilt für:

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

Parameter

Ausnahmen

Beispiele

Weitere Informationen

Gilt für:

DataRelation(String, DataColumn, DataColumn, Boolean)

Parameter

Ausnahmen

Beispiele

Weitere Informationen

Gilt für:

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

Parameter

Ausnahmen

Beispiele

Weitere Informationen

Gilt für:

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

Parameter

Hinweise

Gilt für:

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

Parameter

Hinweise

Gilt für:

Zusätzliche Ressourcen