Editor-Steuerelemente für Feldtypeigenschaften
Letzte Änderung: Mittwoch, 30. September 2009
Gilt für: SharePoint Foundation 2010
Ein Editor-Steuerelement für die variablen Eigenschaften eines Feldtyps kann, als Alternative zu einem PropertySchema-Element (Feldtypen), zum Rendern der Eigenschaften des Felds auf den Seiten Neue Websitespalte, Websitespalte ändern, Spalte erstellen und Spalte ändern verwendet werden. Unter Rendern der Eigenschaften von benutzerdefinierten Feldtypen finden Sie eine Übersicht zu den beiden Optionen. Außerdem wird dort erläutert, in welchen Fällen die jeweiligen Methoden verwendet werden.
Erstellen eines Editor-Steuerelements
Ein Editor-Steuerelement wird in einer ASCX-Datei in %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\ControlTemplates und in einer CodeBehind-Datei erstellt, die in derselben Assembly als benutzerdefinierte Feldklasse kompiliert werden. Zusätzlich zum Rendern der Eigenschaften des Felds unterstützt das Editor-Steuerelement Spaltenersteller, die diese Eigenschaften mit speziellen Funktionen festlegen, beispielsweise mit komplizierter Berechnungslogik, Nachschlagen von Werten in Datenquellen und benutzerdefinierter Datenvalidierung.
Hinweis: Es wird empfohlen, die Klassen des Editor-Steuerelements entsprechend der folgenden Benennungskonvention zu benennen:
FeldtypnameFieldEditor
Beispiele sind TargetDateFieldEditor oder RegularExpressionFieldEditor. Entsprechend dieser Konvention wird der ASCX-Datei der Name FeldtypnameFieldEditor.ascx zugewiesen, und sie erbt von der CodeBehind-Klasse FeldtypnameFieldEditor.
Die IFieldEditor-Schnittstelle
Für die CodeBehind-Klasse muss Folgendes gelten, wenn sie als Feld-Editor-Benutzersteuerelement fungieren soll:
Sie muss von der UserControl-Klasse oder einer davon abgeleiteten Klasse erben.
Sie muss die IFieldEditor-Schnittstelle implementieren.
Die IFieldEditor-Schnittstelle enthält die folgende Eigenschaft und die folgenden Methoden. Klicken Sie auf den Namen des jeweiligen Elements, um weitere Informationen zur Implementierung zu erhalten.
DisplayAsNewSection: Geben Sie mit dieser Eigenschaft an, ob das Steuerelement im Abschnitt Zusätzliche Spalteneinstellungen auf den Seiten Neue Websitespalte, Websitespalte ändern, Spalte erstellen und Spalte ändern oder eigenständig in einem neuen Abschnitt angezeigt werden soll.
OnSaveChange: Verwenden Sie diese Methode, um die Änderungen eines Spaltenerstellers oder Spaltenbearbeiters an den Eigenschaften des Felds (der Spalte) zu validieren und zu speichern.
InitializeWithField: Initialisieren Sie mit dieser Methode das Editor-Steuerelement mit den Standardwerten oder mit den aktuellen Eigenschaftswerten des Felds (der Spalte).
Siehe auch
Konzepte
Gewusst wie: Erstellen einer benutzerdefinierten Feldklasse
Vorgehensweise: Erstellen einer benutzerdefinierten Feldtypdefinition