Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Initialisiert eine neue Instanz der DataRelation-Klasse unter Verwendung des angegebenen DataRelation-Namens sowie der angegebenen übergeordneten und untergeordneten DataColumn-Objekte.
Namespace: System.Data
Assembly: System.Data (in system.data.dll)
Syntax
'Declaration
Public Sub New ( _
relationName As String, _
parentColumn As DataColumn, _
childColumn As DataColumn _
)
'Usage
Dim relationName As String
Dim parentColumn As DataColumn
Dim childColumn As DataColumn
Dim instance As New DataRelation(relationName, parentColumn, childColumn)
public DataRelation (
string relationName,
DataColumn parentColumn,
DataColumn childColumn
)
public:
DataRelation (
String^ relationName,
DataColumn^ parentColumn,
DataColumn^ childColumn
)
public DataRelation (
String relationName,
DataColumn parentColumn,
DataColumn childColumn
)
public function DataRelation (
relationName : String,
parentColumn : DataColumn,
childColumn : DataColumn
)
Parameter
- relationName
Der Name der DataRelation. Bei NULL (Nothing in Visual Basic) oder einer leeren Zeichenfolge ("") wird beim Hinzufügen des erstellten Objekts zur DataRelationCollection ein Standardname vergeben.
- parentColumn
Die übergeordnete DataColumn in der Beziehung.
- childColumn
Die untergeordnete DataColumn in der Beziehung.
Ausnahmen
| Ausnahmetyp | Bedingung |
|---|---|
Eines oder beide der DataColumn-Objekte enthalten NULL (Nothing in Visual Basic). |
|
Die Spalten weisen unterschiedliche Datentypen auf. – oder – Die Tabellen gehören nicht zu demselben DataSet. |
Beispiel
Im folgenden Beispiel wird eine neue DataRelation erstellt und der DataRelationCollection eines DataSet hinzugefügt.
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 = New DataColumn() _
{DataSet1.Tables("Customers").Columns("CustID"), _
DataSet1.Tables("Customers").Columns("OrdID")}
Dim childCols() As DataColumn = New DataColumn() _
{DataSet1.Tables("Orders").Columns("CustID"), _
DataSet1.Tables("Orders").Columns("OrdID")}
' Create DataRelation.
Dim CustOrderRel As DataRelation = New DataRelation( _
"CustomersOrders", parentCols, childCols)
' Add the relation to the DataSet.
DataSet1.Relations.Add(CustOrderRel)
End Sub
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);
}
Plattformen
Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
.NET Compact Framework
Unterstützt in: 2.0, 1.0
Siehe auch
Referenz
DataRelation-Klasse
DataRelation-Member
System.Data-Namespace
DataColumn-Klasse
RelationName