Assistent zum Konfigurieren von Datenquellen (EntityDataSource-Steuerelement)

Artikel
10/22/2014

Aktualisiert: November 2007

Der Assistent Datenquelle konfigurieren des EntityDataSource-Steuerelements im ASP.NET-Framework bietet zwei Seiten zum Initialisieren der Datenquelle. Auf der ersten Seite des Assistenten können Sie eine benannte Verbindung aus der WebConfig-Datei auswählen oder eine Verbindungszeichenfolge hinzufügen, durch die die Datenbank identifiziert wird. Der Inhalt der zweiten Seite des Assistenten ist abhängig davon, ob Sie eine durch die Optionen im Assistenten konfigurierte Select-Anweisung oder Ihren eigenen Befehlstext verwenden.

Seite 1 des Assistenten

Die folgende Abbildung zeigt die erste Seite des Assistenten. In der Dropdownliste wurde die in der Web.config-Projektdatei enthaltene benannte VerbindungAdvWksSalesEntities ausgewählt. In der Dropdownliste DefaultContainerName wurde ebenfalls AdvWksSalesEntities ausgewählt. Die Verbindungszeichenfolge in einer Implementierung des Entity Data Model (EDM) wird standardmäßig durch EntityContainer im Entwurfsschema identifiziert. Weitere Informationen zum EntityContainer-Typ finden Sie unter ADO.NET Entity Framework. Die erste Seite des Assistenten sieht folgendermaßen aus:

Weitere Informationen über die Eigenschaften von EntityDataSource, die durch die erste Seite des Assistenten initialisiert werden, finden Sie unter Konfigurieren des EntityDataSource-Steuerelements.

Seite 2 des Assistenten

Die zweite Seite des Assistenten sieht unterschiedlich aus, je nachdem, ob der Select-Eigenschaft ein Wert zugewiesen wird.

Die einfache Select-Ansicht des Assistenten

Die einfache Select-Ansicht des Assistenten wird angezeigt, wenn der Select-Eigenschaft des EntityDataSource-Steuerelements kein Wert zugewiesen wird oder wenn der Select-Eigenschaft eine durch Trennzeichen getrennte Liste bekannter Entitätseigenschaften in folgendem Format zugewiesen wird: item.[Property1], item.[Property2] (mit oder ohne eckige Klammern). Die möglichen Eigenschaftensätze für DefaultContainerName, EntitySetName und EntityTypeFilter müssen als gültige Werte im Datenmodell, das von der Anwendung verwendet wird, erkannt werden.

Benutzer wählen in der einfachen Select-Ansicht des Assistenten EntitySetName aus, geben wahlweise einen EntityTypeFilter an und wählen die Eigenschaften aus, die im Datensteuerelement angezeigt werden sollen. EntityTypeFilter ist nur erforderlich, wenn abgeleitete Typen in einer Vererbungshierarchie verwendet werden.

Bei Auswahl von Alles auswählen (Entitätswert) werden keine Ergebnisse mit einzelnen Eigenschaften, sondern vollständige Entitäten zurückgegeben. Entitätswerte können aktualisiert werden und lassen zu, dass die Schlüsseleigenschaften zugehöriger Entitäten und komplexer Typmember durch datengebundene Steuerelemente angezeigt und geändert werden.

Die folgende Abbildung zeigt die einfache Select-Ansicht der zweiten Seite des Assistenten.

Erweiterte Select-Ansicht des Assistenten

Die erweiterte Select-Ansicht des Assistenten (siehe unten) wird angezeigt, wenn der Select-Eigenschaft ein Wert zugewiesen wird, bei dem es sich nicht um eine der in der einfachen Ansicht angezeigten Optionen handelt.

Die Kontrollkästchen Automatische Einfügungen aktivieren, Automatische Aktualisierungen aktivieren und Automatische Löschungen aktivieren verfügen jeweils über zwei mögliche Werte. Wenn auf der einfachen Select-Seite des Assistenten eine andere Option als Alles auswählen in der Liste der Eigenschaften ausgewählt wird, werden diese Kontrollkästchen auf der erweiterten Select-Seite des Assistenten deaktiviert. In der erweiterten Select-Ansicht des Assistenten werden diese Kontrollkästchen deaktiviert, sobald im Select-Textfeld eine Eingabe erfolgt, wie an der benutzerdefinierten Select-Anweisung in der Abbildung zu sehen ist.

Hinweis:
Wie im Entity Framework wird durch Select eine Projektion der Daten erstellt. Projektionen können nicht aktualisiert werden. Select kann nicht verwendet werden, wenn Automatische Einfügungen aktivieren, Automatische Aktualisierungen aktivieren oder Automatische Löschungen aktivieren aktiviert ist.