AddCrossProviderRelation Methode

In diesem Thema

Erstellt eine (virtuelle) 1:n Relation zwischen zwei Tabellen aus dieser Auflistung von Datenprovidern. Die Tabellen können dabei aus unterschiedlichen Datenprovidern oder dem gleichen Datenprovider dieser Auflistung stammen. Beachten Sie jedoch, dass die Unterstützung für diese benutzerdefinierten Relationen abhängig von den Fähigkeiten der verwendeten Datenprovider ist.

Jede Tabelle eines beliebigen Datenproviders kann hierbei als Elterntabelle (Primärschlüsseltabelle) fungieren. Aber nur Tabellen, die auch Filterung unterstützen, können als Kindtabelle (Tabelle, die den Fremdschlüssel enthält) verwendet werden. Die Unterstützung für Filterung ist abhängig vom Typ des Datenproviders und kann mit Hilfe der Eigenschaft SupportsFiltering überprüft werden. Und nur wenn auch die Elterntabelle Filterung unterstützt (das ist optional), kann eine 1:1 Relation zwischen den Zeilen der Kindtabelle und den Zeilen der Elterntabelle im Designer angeboten werden.

Intern müssen die Datenprovider (oder das Datenbanksystem zu dem diese verbunden sind) die Werte der definierten Eltern- und Kindspalten vergleichen. List & Label überprüft nicht, ob die Datentypen der Eltern- und Kindspalten vergleichbar sind. Daher wird empfohlen Relationen auch nur zwischen Spalten mit dem identischen Datentyp zu definieren.

Bei den Bemerkungen finden sich weitere Informationen zu den unterstützten Datenprovidern.

Syntax

Visual Basic
C#
C++/CLI

'Deklaration
 
Public Sub AddCrossProviderRelation( _
   ByVal relationName As String, _
   ByVal parentProvider As IDataProvider, _
   ByVal parentTableName As String, _
   ByVal parentColumnName As String, _
   ByVal childProvider As IDataProvider, _
   ByVal childTableName As String, _
   ByVal childColumnName As String _
)

public void AddCrossProviderRelation( 
   string relationName,
   IDataProvider parentProvider,
   string parentTableName,
   string parentColumnName,
   IDataProvider childProvider,
   string childTableName,
   string childColumnName
)

public:
void AddCrossProviderRelation( 
   String^ relationName,
   IDataProvider^ parentProvider,
   String^ parentTableName,
   String^ parentColumnName,
   IDataProvider^ childProvider,
   String^ childTableName,
   String^ childColumnName
)

Parameter

relationName: Name der Relation
parentProvider: Datenprovider, aus dem die Elterntabelle verwendet werden soll
parentTableName: Tabellenname der Elterntabelle
parentColumnName: Spaltenname aus der Elterntabelle
childProvider: Datenprovider, aus dem die Kindtabelle verwendet werden soll
childTableName: Tabellenname der Kindtabelle
childColumnName: Spaltenname aus der Kindtabelle

Ausnahmen (Exceptions)

Ausnahme (Exception)	Beschreibung
ArgumentException	Wird ausgelöst, wenn parentProvider oder childProvider nicht Bestandteil der DataproviderCollection ist oder wenn die Kindtabelle keine Filterung unterstützt.

Bemerkungen

Filterbare Datenprovider, dessen Tabellen als Eltern- oder Kindtabelle verwendet werden können:
Alle SQL-basierten Datenbanken (SQL Server, Oracle, MySQL, ...), OData, ODBC, OLE DB, MongoDB, Cassandra, Salesforce

Filterbar, sofern in InMemoryDataProvider gekapselt wurde:
CSV, Excel

Nicht filterbare Datenprovider, die nur als Elterntabelle verwendet werden können:
REST, JSON, XML, Google Analytics, Google BigQuery, Google Spreadsheet

Anforderungen

Plattformen: Windows 10 (Version 21H2 - 22H2), Windows 11 (21H2 - 23H2), Windows Server 2016 - 2022
.NET: .NET Framework 4.8, .NET 6, .NET 7, .NET 8

Siehe auch

Referenz

DataProviderCollection Klasse
DataProviderCollection Member

Feedback senden