Listenelementformular-Seiten

Letzte Änderung: Freitag, 9. April 2010

Gilt für: SharePoint Foundation 2010

Inhalt dieses Artikels
Listenelementformulare und Gestaltungsvorlage
Rendern von Anzeigeformularen
Angeben von benutzerdefinierten Seiten zum Erstellen oder Ändern von Listen

Die Listenelementformular-Seiten (DisplayForm.aspx, EditForm.aspx und NewForm.aspx) für die meisten Microsoft SharePoint Foundation-Listen basieren auf derselben Datei Form.aspx, die sich unter %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\Pages befindet. Diese Datei implementiert die default.master-Datei von SharePoint Foundation, die sich unter %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\GLOBAL befindet.

Standardmäßig werden Listenformularseiten für eine bessere Skalierbarkeit im unkompilierten Modus ausgeführt. In SharePoint Foundation ist Code auf Formularseiten nicht zulässig, es sei denn, die Zulässigkeit von Code auf Seiten wird über die Benutzeroberfläche aktiviert.

Listenelementformulare und Gestaltungsvorlage

Standardmäßige Listenformularseiten werden entsprechend der Standardgestaltungsvorlage entworfen, wobei jeder Bereich für das Steuerelement durch einen Platzhalter auf der Seite dargestellt wird. Eine Listenformularseite enthält Platzhalter für die Symbolleiste, die Kopfzeile, den Text und die Fußzeile. Auf jeder einzelnen Formularseite wird bestimmt, welche Steuerelemente für diese Platzhalter verwendet werden können, wodurch der gesamte Gestaltungsvorlagenentwurf mit geschachtelten (abgeleiteten) Gestaltungsvorlagen bedingt wird.

Durch die Gestaltungsvorlage werden die Ränder und Navigationsbereiche definiert, die auf Listenelementformularen angezeigt werden. Weitere Informationen zu Gestaltungsvorlagen in SharePoint Foundation finden Sie unter Gestaltungsvorlagen.

Die Datei Form.aspx enthält ein Microsoft.SharePoint.WebPartPages.WebPartZone-Steuerelement, das ein ListFormWebPart-Objekt im Seitenkörper einfügt. Zum Anzeigen des Inhalts der Seite instanziiert dieses Webpart ein ListForm-Steuerelement, dessen Vorlage in %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\CONTROLTEMPLATES\DefaultTemplates.ascx definiert ist. Das ListForm-Steuerelement enthält HTML-Markup und Steuerelementvorlagen, um das Layout der Symbolleiste, der Felder und anderer Teile des Formulars zu bestimmen. Sie können ein benutzerdefiniertes ListForm-Steuerelement über Vorlageneigenschaften der ListFormWebPart-Klassen angeben.

Wichtig
Das Bearbeiten der Dateien, die von SharePoint Foundation auf Front-End-Webservern installiert werden, wird nicht unterstützt. Änderungen an Dateien, die ursprünglich mit dem Produkt installiert wurden, können beim Installieren von Updates oder Service Packs für SharePoint Foundation oder beim Upgrade einer Installation auf die nächste Produktversion überschrieben werden.

Rendern von Anzeigeformularen

SharePoint Foundation-Anzeigeformulare werden etwas anders gerendert als Formulare zum Bearbeiten und Erstellen. Anzeigeformulare besitzen zwar das gleiche Layout wie Formulare zum Bearbeiten und Erstellen und verwenden im Wesentlichen dieselben Steuerelemente, Anzeigeformularfelder werden jedoch in nicht verwaltetem Code definiert und weisen das gleiche Feldrendering auf, das in Listenansichten verwendet wird. Im Anzeigemodus werden in SharePoint-Feldsteuerelementen CAML-Hauptschemas (Collaborative Application Markup Language)-Definitionen zum Rendern der Felder verwendet.

Wichtig
Obwohl Sie den Formularen zum Anzeigen, Bearbeiten und Erstellen von Listenelementen (DispForm.aspx, EditForm.aspx und NewForm.aspx) Webparts hinzufügen können, wird dies in SharePoint Foundation weder empfohlen noch unterstützt. Das Hinzufügen von Webparts zu Listenansichtsseiten (AllItems.aspx) wird unterstützt.

Angeben von benutzerdefinierten Seiten zum Erstellen oder Ändern von Listen

Sie können eine benutzerdefinierte Seite für das Erstellen von Listen oder zum Bearbeiten von Listeneigenschaften angeben, indem Sie die Attribute NewPage und EditPage für das ListTemplate-Element eines Listendefinitionsfeatures angeben.

Im folgenden Beispiel werden benutzerdefinierte Seiten für Listen angegeben, die durch die Listendefinition erstellt werden.

<Elements xmlns="https://schemas.microsoft.com/sharepoint/">
  <ListTemplate
    Name="MyTemplate"
    Type="2100"
    BaseType="1"
    OnQuickLaunch="TRUE"
    SecurityBits="11"
    DisplayName="My Custom List Type"
    NewPage="MyCreateList.aspx"
    EditPage="MyEditList.aspx"
    Description="My description..."
    Image="/_layouts/images/itsl.gif"
    DocumentTemplate="100">
  </ListTemplate>
</Elements>