LinqDataSource-Klasse

LINQ (Language-Integrated Query) ist eine Abfragesyntax, in der eine Reihe von Abfrageoperatoren definiert ist, die Traversal-, Filter- und Projizierungsvorgänge zulassen, die in einer beliebigen .NET-basierten Programmiersprache deklarativ ausgedrückt werden sollen. Als Datenobjekt kann eine Datenauflistung im Speicher oder ein Objekt verwendet werden, das Daten in einer Datenbank darstellt. Sie können die Daten abrufen oder ändern, ohne SQL-Befehle für jede Operation schreiben zu müssen.

Das LinqDataSource-Steuerelement ermöglicht die Verwendung von LINQ auf einer ASP.NET-Webseite durch Festlegen von Eigenschaften im Markuptext. Das LinqDataSource-Steuerelement verwendet LINQ to SQL, um die Datenbefehle automatisch zu generieren. Weitere Informationen über LINQ to SQL finden Sie unter LINQ to SQL.

Wenn Sie Daten von einer Datenauflistung im Speicher abrufen, legen Sie die ContextTypeName-Eigenschaft auf die Klasse mit der Datenauflistung fest. Sie legen die TableName-Eigenschaft auf die Eigenschaft oder das Feld fest, die oder das die Datenauflistung zurückgibt. Zum Beispiel kann eine Klasse mit dem Namen Person vorhanden sein, die die Eigenschaft FavoriteCities enthält, die ein Array von Zeichenfolgenwerten zurückgibt. In diesem Fall legen Sie die ContextTypeName-Eigenschaft auf Person und die TableName-Eigenschaft FavoriteCities fest.

Wenn Sie eine Datenbank abfragen, müssen Sie zuerst Entitätsklassen erstellen, die die Datenbank und deren Tabellen darstellen. Sie können O/R-Designer oder das Dienstprogramm SqlMetal.exe verwenden, um diese Klassen zu generieren. Dann legen Sie die ContextTypeName-Eigenschaft auf die Klasse fest, die die Datenbank darstellt, und legen Sie die TableName-Eigenschaft auf die Eigenschaft fest, die die Datenbanktabelle darstellt.

Das LinqDataSource-Steuerelement wendet Datenoperationen in der folgenden Reihenfolge an:

1. Where (Angeben der zurückzugebenden Datensätze).

2. Order By (Sortieren).

3. Group By (Aggregieren von Datensätzen mit gemeinsamen Werten).

4. Order Groups By (Sortieren von gruppierten Daten).

5. Select (Angeben der zurückzugebenden Felder oder Eigenschaften).

6. Auto-sort (Sortieren der Datensätze nach einer Eigenschaft, die vom Benutzer ausgewählt wurde).

7. Auto-page (Abrufen einer Teilmenge von Datensätzen, die vom Benutzer ausgewählt wurden).

Sie können der Where-Eigenschaft Bedingungen hinzufügen, um die von einer Abfrage zurückgegebenen Datensätze zu filtern. Wenn die Where-Eigenschaft nicht festgelegt wurde, ruft das LinqDataSource-Steuerelement jeden Datensatz vom Datenobjekt ab.

Sie verwenden die OrderBy-Eigenschaft, um die Namen der Eigenschaften für die zurückgegebenen Daten anzugeben, nach denen sortiert werden soll.

Hinweis

Wenn Sie das LinqDataSource-Steuerelement mit SQL Server 2000 oder SQL Server Compact 3.5 verwenden und die AutoPage-Eigenschaft auf true festgelegt ist, müssen Sie in der OrderBy-Eigenschaft einen Wert angeben. Standardmäßig hat die AutoPage-Eigenschaft den Wert true. Wenn Sie der Select-Eigenschaft einen Wert zuweisen, müssen Sie auch alle Identitätsspalten in der Liste der von der Abfrage zurückgegebenen Eigenschaften einbeziehen.

Mit der GroupBy-Eigenschaft geben Sie die Eigenschaften an, die zum Konsolidieren der Datensätze mit identischen Werten verwendet werden. Beim Gruppieren von Daten können Sie die dynamisch erstellten Eigenschaften Key und It in die Select-Eigenschaft einbeziehen. Die Key-Eigenschaft verweist auf die Werte in den zum Gruppieren der Daten verwendeten Eigenschaften. Wenn Sie die Gruppierung beispielsweise nach der Category-Eigenschaft vornehmen, enthält die Key-Eigenschaft alle eindeutigen Werte in der Category-Eigenschaft. Die It-Eigenschaft verweist auf eine Auflistung einzelner Datensätze in einer Gruppierung von Daten. Sie können die It-Eigenschaft durchlaufen, um die einzelnen Datensätze abzurufen, die beim Gruppierungsvorgang konsolidiert wurden. Wenn Sie die Gruppierung beispielsweise nach der Category-Eigenschaft vornehmen, enthält die It-Eigenschaft alle einzelnen Datensätze, die in der Category-Eigenschaft einen gemeinsamen Wert aufweisen.

Sie verwenden die OrderGroupsBy-Eigenschaft, um die Eigenschaften anzugeben, die zum Sortieren der gruppierten Daten verwendet werden sollen. Beim Gruppieren von Daten gibt die OrderBy-Eigenschaft an, wie die einzelnen Datensätze in den gruppierten Daten sortiert werden sollen.

Standardmäßig ruft das LinqDataSource-Steuerelement von einem Datenobjekt Werte für alle Eigenschaften ab. Mit der Select-Eigenschaft können Sie die Eigenschaften angeben, die zurückgegeben werden sollen, wenn Sie mit einer Teilmenge der verfügbaren Eigenschaften arbeiten. Die Select-Operation wird nach den Operationen Where, Order By und Group By angewendet. Wenn Sie in einer Select-Klausel einen Aliasnamen erstellen, ist der Alias daher in anderen Klauseln nicht verfügbar.

Mit den Eigenschaften EnableDelete, EnableInsert, and EnableUpdate können Sie angeben, ob Datenänderungen aktiviert werden. Die Benutzeroberfläche zum Ändern von Daten über ein LinqDataSource-Steuerelement wird meist über ein datengebundenes Steuerelement bereitgestellt, z. B. ein DetailsView-Steuerelement. Um automatische Datenänderungen aktivieren zu können, muss EnableDelete, EnableInsert oder EnableUpdate auf true festgelegt werden, zudem müssen die folgenden Bedingungen erfüllt sein:

• Der Select-Eigenschaft kann kein Wert zugewiesen werden.

• Der GroupBy-Eigenschaft kann kein Wert zugewiesen werden.

• Die der ContextTypeName-Eigenschaft zugewiesene Klasse muss von DataContext abgeleitet werden.

• Die der TableName-Eigenschaft zugewiesene Eigenschaft muss von Table<TEntity> abgeleitet werden.

Sie verfügen über zwei Möglichkeiten, die Eigenschaften einzuschränken, die in einem datengebundenen Steuerelement angezeigt werden. Sie können die Select-Eigenschaft auf eine Teilmenge von Eigenschaften festlegen oder die Felder für ein datengebundenes Steuerelement definieren, indem Sie DataControlField-Steuerelemente hinzufügen. Wenn Sie die Select-Eigenschaft festlegen, können jedoch automatische Aktualisierungs-, Einfüge- und Löschvorgänge nicht aktiviert werden. Wenn Sie während der Arbeit mit einer Teilmenge der verfügbaren Eigenschaften automatische Datenänderungen aktivieren möchten, legen Sie die Select-Eigenschaft nicht fest. Rufen Sie stattdessen alle Eigenschaften vom Datenobjekt ab, und verwalten Sie, welche in einem datengebundenen Steuerelement angezeigt werden. Wenn Sie das DetailsView-Steuerelement oder das GridView-Steuerelement verwenden, müssen Sie auch die AutoGenerateRows-Eigenschaft oder die AutoGenerateColumns-Eigenschaft auf false festlegen. Dies verhindert, dass vom datengebundenen Steuerelement automatisch Schaltflächen zum Bearbeiten und Löschen der Daten einbezogen werden. Alle Werte, die nicht im datengebundenen Steuerelement angezeigt werden, werden im Ansichtszustand gespeichert. Sie werden bei der Datenaktualisierung unverändert an die Datenquelle übergeben.

Wenn Sie Werte zur Laufzeit auswerten müssen, um sie zu anzuordnen, zu filtern oder zu gruppieren, können Sie der Auflistung WhereParameters, GroupByParameters, OrderGroupsByParameters oder OrderByParameters Parameter hinzufügen.

Wenn Sie Standardwerte für Routenparameter definieren möchten, können Sie der InsertParameters-Auflistung Parameter hinzufügen.

Wenn Sie Werte vor der Datenoperation untersuchen oder ändern möchten, können Sie das Ereignis Deleting, Inserting, Selecting oder Updating behandeln. Sie können diese Ereignisse auch behandeln, um den Datenvorgang abzubrechen oder Validierungsfehler zu analysieren, die beim Festlegen der Eigenschaften in der Datenklasse auf Grundlage von Benutzereingaben aufgetreten sind.

Um Werte nach der Datenoperation zu untersuchen, behandeln Sie die Ereignisse Deleted, Inserted, Selected, oder Updated.

Mit dem LinqDataSource-Steuerelement rufen Sie Daten aus einer gespeicherten Prozedur ab, indem Sie einen Ereignishandler für das Selecting-Ereignis erstellen. Im Ereignishandler rufen Sie die Methode der Datenkontextklasse auf, die die gespeicherte Prozedur darstellt, und legen das Ergebnis auf die Result-Eigenschaft des LinqDataSourceSelectEventArgs-Objekts fest. Wenn Sie automatische Aktualisierungs-, Einfüge- und Löschvorgänge für die Daten aktivieren möchten, muss der von der Methode zurückgegebene Typ dem Typ entsprechen, der in der TableName-Eigenschaft angegeben ist. Weitere Informationen zum Erstellen von Datenkontextmethoden finden Sie unter Vorgehensweise: Erstellen von DataContext-Methoden, die gespeicherten Prozeduren und Funktionen (O/R-Designer) zugeordnet sind.