Freigeben über

Eigenschaftenseite (EntityDataSource-Steuerelement)

  • Artikel

Aktualisiert: November 2007

Die Eigenschaftenseite für das ASP.NET EntityDataSource-Steuerelement wird in der Visual Studio IDE angezeigt, wenn das Entwurfszeitsteuerelement auf der Entwurfsoberfläche der Webseite ausgewählt wird. Die Eigenschaftenseite bietet die Möglichkeit, Werte festzulegen, auch wenn die Werte gemäß einer bestimmten Metadatenansicht nicht korrekt zu sein scheinen.

Hinweis:

Im Gegensatz zu den im Assistenten zum Konfigurieren von Datenquellen angezeigten Daten werden durch das Auswählen einer Eigenschaft, die mit anderen Eigenschaften verbunden ist, auf der Eigenschaftenseite die zugehörigen Eigenschaften nicht automatisch aktualisiert, um gültige Werte darzustellen. Wenn Sie im Assistenten zum Konfigurieren von Datenquellen einen EntityContainer in der Dropdownliste DefaultContainerName auswählen, werden die gültigen Entitätsmengen für diesen Container automatisch in die Dropdownliste EntitySetName geladen, und alle früheren Werte für EntitySetName werden gelöscht. Der Assistent stellt eine restriktive Ansicht der Konfiguration bereit.

Auch wenn die Eigenschaftenwerte für abhängige Eigenschaften von der Eigenschaftenseite nicht automatisch ausgerichtet werden, können die möglichen Werte in der Dropdownliste für eine angegebene Eigenschaft auf anderen Werten basieren. Wenn z. B. der aktuelle ContainerName erkannt wird, wird durch das Erweitern der Dropdownliste für EntitySetName eine Liste gültiger Entitätsmengen für diesen ContainerName angezeigt.

Die folgende Abbildung zeigt die Eigenschaftenseite mit Eigenschaftenzuweisungen an.

In der folgenden Liste wird das Verhalten für Eigenschaften des EntityDataSource-Steuerelements beschrieben.

  • Alle Eigenschaften in der Verhaltensgruppe sind boolesche Eigenschaften und lassen in einer Dropdownliste nur true oder false zu.

  • ConnectionString ist eine einfache Zeichenfolge. Die Gültigkeit der Zeichenfolge wird zur Laufzeit bestimmt.

  • DefaultContainerName ist eine Dropdownliste derselben Gruppe von Entitätscontainern, wie zuvor in diesem Thema für den Assistenten beschrieben. Der Benutzer kann auch einen Containernamen eingeben, der nicht in der Liste enthalten ist. Ungültige Namen werden zur Laufzeit erkannt.

  • EntitySetName ist eine Dropdownliste der Entitätssätze für den ausgewählten Containernamen. Diese Eigenschaft ist möglicherweise leer, wenn der Containername nicht in erkennbaren Metadaten gefunden wird. Der Benutzer kann einen EntitySetName eingeben, der nicht in der Liste enthalten ist. Ungültige Namen werden zur Laufzeit erkannt.

  • GroupBy ist eine einfache Zeichenfolge ohne Parameter.

  • OrderBy, Where, Select und CommandText bestehen aus zwei Teilen:

    • Einer Zeichenfolge, die den Text des Ausdrucks enthält.

    • Den in diesen Ausdrücken verwendeten Parametern. Die Eigenschaftenseite zeigt nur die Zeichenfolge an. Die Parameter sind nur sichtbar, wenn Sie erneut auf die Schaltfläche mit den Auslassungspunkten für den Generator klicken oder das Markup direkt anzeigen. Weitere Informationen zu den Generator-Dialogfeldern für diese Eigenschaften finden Sie in den Themen zu den Dialogfeldern OrderBy, Select, Where und CommandText in Ausdrucks-Editor (EntityDataSource-Steuerelement).

  • EntityTypeFilter ist eine Dropdownliste derselben Typmenge, die im Assistenten zum Konfigurieren von Daten angezeigt wird, wenn die EntitySetName-Eigenschaft nicht leer ist und in Metadaten erkannt wird. Der Benutzer kann einen Wert eingeben, der nicht in der Liste enthalten ist. Ungültige Namen werden zur Laufzeit erkannt.

  • ID ist der Bezeichner des Steuerelements im Seitenmarkup.

Seite "Ereignis"

Die Seite Ereignis zeigt die öffentlichen Ereignisse des EntityDataSource-Steuerelements an. Visual Studio stellt eine Dropdownliste bereit, die alle Methoden anzeigt, die zur geeigneten Signatur für den Handler dieses Ereignisses passen. Der Benutzer kann auf den Eigenschaftenwert doppelklicken, um eine neue Methode hinzuzufügen, oder zu einer vorhandenen Methode springen, wenn diese bereits im Code vorhanden ist.

Die folgende Abbildung zeigt die EntityDataSource einer Steuerelementereignisseite.

Siehe auch

Konzepte

Toolboxelement (EntityDataSource-Steuerelement)

Entwurfszeit-Steuerelement (EntityDataSource-Steuerelement)

Assistent zum Konfigurieren von Datenquellen (EntityDataSource-Steuerelement)