ASP.NET Dynamic Data-Standardfeldvorlagen
Aktualisiert: November 2007
Feldvorlagen sind ASP.NET-Benutzersteuerelemente, mit denen das Datensteuerelementfeld Datentypen in einem Datenmodell zugeordnet wird. Diese Steuerelemente werden von der FieldTemplateUserControl-Klasse abgeleitet, durch die der Zugriff auf Datenfelder, Datenbankspalten und Metadaten ermöglicht wird. Dynamic Data verwendet Feldvorlagen, um automatisch Daten anhand des Datenbankschemas und Datentyps anzuzeigen und um Benutzern die Möglichkeit zu geben, Daten mit nur wenig oder gar keinem Code in einem Datenmodell zu bearbeiten und in ein Datenmodell einzufügen. Dynamic Data stellt Standardfeldvorlagen bereit, wenn Sie Webanwendungen für Dynamic Data erstellen.
Standardfeldvorlagen
ASP.NET Dynamic Data ermittelt den Datentyp der Daten im Datenmodell und verwendet die entsprechende Standard- bzw. Benutzerfeldvorlage zur Wiedergabe der Daten in einem Datensteuerelement. Welche Feldvorlage gerendert wird, ist abhängig vom Datentyp, dem UIHint bzw. dem definierten DataTypeAttribute und dem Modus (Anzeigen, Bearbeiten oder Einfügen) des Datensteuerelements. Wenn Sie in Visual Studio 2008 ein Dynamic Data-Projekt erstellen, werden die Standardfeldvorlagen im Verzeichnis DynamicData/FieldTemplates erstellt.
In der folgenden Tabelle werden die Standardfeldvorlagen in ASP.NET Dynamic Data-Projekten beschrieben.
Standardfeldvorlage |
Beschreibung |
|---|---|
Boolean.ascx |
Zeigt den Datentyp Boolean an. Rendert ein CheckBox-Steuerelement. Das CheckBox-Steuerelement wird deaktiviert und kann nicht geändert werden. |
Boolean_Edit.ascx |
Ermöglicht Benutzern die Bearbeitung von Boolean-Werten. Rendert ein CheckBox-Steuerelement. |
Children.ascx |
Zeigt Felder mit einer 1:n-Beziehung an und leitet Benutzer zur Beziehungsseite weiter. Rendert ein HyperLink-Steuerelement. |
DateTime.ascx |
Zeigt den DateTime-Datentyp als Text an. Wird als Literal gerendert. |
DateTime_Edit.ascx |
Rendert ein TextBox-Steuerelement. Falls das Feld in der Datenbank nicht null sein kann oder falls dem Datenmodell ein erforderliches Attribut hinzugefügt wird, rendert dieses Steuerelement zudem ein RequiredFieldValidator-Steuerelement. Die Feldvorlage DateTime_Edit.ascx stellt ein System.Web.DynamicData.DynamicValidator-Steuerelement bereit, durch das alle vom Datenmodell ausgegebenen Ausnahmen verarbeitet werden. Sie unterstützt die Regex-Klasse. |
Decimal_Edit.ascx |
Rendert ein TextBox-Steuerelement. Rendert darüber hinaus ein CompareValidator-Steuerelement, mit dem überprüft wird, ob die Eingabe in einen Decimal-Datentyp konvertiert werden kann. Falls das Feld in der Datenbank nicht null sein kann oder falls dem Datenmodell ein erforderliches Attribut hinzugefügt wird, rendert dieses Steuerelement zudem ein RequiredFieldValidator-Steuerelement. Falls das Feld über ein Bereichsattribut verfügt, rendert das Feld auch ein RangeValidator-Steuerelement. Die Feldvorlage Decimal_Edit.ascx stellt ein System.Web.DynamicData.DynamicValidator-Steuerelement bereit, durch das alle vom Datenmodell ausgegebenen Ausnahmen verarbeitet werden. Diese Feldvorlage unterstützt die Regex-Klasse. |
ForeignKey.ascx |
Zeigt Felder mit einer n:1-Beziehung an. Rendert ein HyperLink-Steuerelement, durch das Benutzer zur Beziehungsseite umgeleitet werden. |
ForeignKey_Edit.ascx |
Wird zur Bearbeitung von Feldern mit einer n:1-Beziehung verwendet. Rendert ein DropDownList-Steuerelement, mit dem Benutzer Fremdschlüssel im Datenmodell auswählen können. |
Integer_Edit.ascx |
Rendert ein TextBox-Steuerelement und ein CompareValidator-Steuerelement, mit dem überprüft wird, ob die Eingabe im Textfeld in eine Ganzzahl konvertiert werden kann. Falls das Feld in der Datenbank nicht null sein kann oder falls dem Datenmodell ein erforderliches Attribut hinzugefügt wird, rendert dieses Steuerelement zudem ein RequiredFieldValidator-Steuerelement. Falls das Feld im Modell über ein Bereichsattribut verfügt, rendert das Feld auch ein RangeValidator-Steuerelement. Integer_Edit.ascx stellt ein System.Web.DynamicData.DynamicValidator-Steuerelement bereit, durch das alle vom Datenmodell ausgegebenen Ausnahmen verarbeitet werden. Sie unterstützt die Regex-Klasse. |
Text.ascx |
Zeigt String, Decimal, Double und Int32 einschließlich weiterer Ganzzahltypen wie byte, short und long an. Wird als Literal gerendert. |
Text_Edit.ascx |
Rendert ein TextBox-Steuerelement. Die TextMode-Eigenschaft des Textfelds wird auf SingleLine festgelegt. Falls das Feld in der Datenbank nicht null sein kann oder falls dem Datenmodell ein erforderliches Attribut hinzugefügt wird, rendert Text_Edit.ascx zudem ein RequiredFieldValidator-Steuerelement. Falls dem Feld in der Datenbank eine Länge zugewiesen ist, wird die MaxLength-Eigenschaft des Textfelds erzwungen. Falls das Datenmodell ein RegularExpression-Attribut aufweist, rendert die Standardfeldvorlage auch ein RegularExpressionValidator-Steuerelement. Text_Edit.ascxstellt ein System.Web.DynamicData.DynamicValidator-Steuerelement bereit, durch das alle vom Datenmodell ausgegebenen Ausnahmen verarbeitet werden. |
Multiline_Edit.ascx |
Wird für Datenbankfelder verwendet, die als Textblöcke gekennzeichnet sind. In SQL Server ist Multiline_Edit.ascx beispielsweise den Datentypen TEXT, NTEXT, VARCHAR(MAX) und NVARCHAR(MAX) zugeordnet. Rendert ein TextBox-Steuerelement. Die TextMode-Eigenschaft des Textfelds wird auf MultiLine festgelegt. Falls das Feld in der Datenbank nicht null sein kann oder falls dem Datenmodell ein erforderliches Attribut hinzugefügt wird, rendert TextArea_Edit.ascx zudem ein RequiredFieldValidator-Steuerelement. Falls dem Datenmodell ein RegularExpression-Attribut hinzugefügt wird, rendert das Datenfeld auch ein RegularExpressionValidator-Steuerelement. TextArea_Edit.ascxstellt ein System.Web.DynamicData.DynamicValidator-Steuerelement bereit, durch das alle vom Datenmodell ausgegebenen Ausnahmen verarbeitet werden. |
Anpassen der Standardvorlagen
Sie können die Standardfeldvorlagen bearbeiten, um das Anzeige-, Bearbeitungs- und Einfügeverhalten zu ändern. Die Änderung wirkt sich auf die gesamte Website aus. So können Sie beispielsweise die Hintergrund- und die Vordergrundfarbe von DateTime_Edit.ascx ändern, indem Sie die BackColor-Eigenschaft und die ForeColor-Eigenschaft des Textfelds bearbeiten, das die Feldvorlage rendert. Sie können eine solche Änderung zum Beispiel bewerkstelligen, indem Sie die BackColor-Eigenschaft und die ForeColor-Eigenschaft in einer CSS-Datei definieren. Weitere Informationen hierzu finden Sie unter Gewusst wie: Anpassen von ASP.NET Dynamic Data-Standardfeldvorlagen.
Siehe auch
Aufgaben
Gewusst wie: Anpassen der Darstellung und des Verhaltens von Datenfeldern im Datenmodell
Gewusst wie: Anpassen der Datenfeldanzeige im Datenmodell