Gewusst wie: Erstellen einer benutzerdefinierten Listendefinition
Letzte Änderung: Freitag, 9. Juli 2010
Gilt für: SharePoint Foundation 2010
Inhalt dieses Artikels
Erstellen der Felddefinition
Erstellen des Inhaltstyps
Erstellen der Listendefinition vom Inhaltstyp
Bereitstellen der Listendefinition
In dieser Aufgabe wird das Erstellen eines benutzerdefinierten Listenvorlagefeatures mithilfe von SharePoint-Entwicklungstools in Microsoft Visual Studio 2010 gezeigt. Es empfiehlt sich, einen Inhaltstyp zu erstellen und eine Listendefinition auf diesen Inhaltstyp basieren zu lassen.
Erstellen der Felddefinition
Mit einer Felddefinition werden die Spalten definiert, die innerhalb der Listenvorlage angezeigt werden. Weitere Informationen zum XML-Code, der zum Definieren eines Feldtyps verwendet wird, finden Sie unter FieldTypes-XML.
So erstellen Sie die Felddefinition
Starten Sie Microsoft Visual Studio 2010.
Zeigen Sie im Menü Datei auf Neu, und klicken Sie dann auf Projekt.
Wählen Sie in Projekttypen unter Visual Basic oder C# die Option Leeres SharePoint-Projekt aus.
Geben Sie FavoriteColorList als Projektnamen ein. Klicken Sie auf OK.
Wählen Sie im Assistenten zum Anpassen von SharePoint die Option Als Sandkastenlösung bereitstellen aus. Klicken Sie auf Fertig stellen.
Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf das Projekt FavoriteColorList, und wählen Sie Hinzufügen und dann Neues Element aus.
Wählen Sie im Dialogfeld Neues Element hinzufügen die Vorlage Leeres Element aus, und geben Sie FavoriteColorField in das Feld Name ein. Klicken Sie auf Hinzufügen.
Fügen Sie den folgenden XML-Code innerhalb des Elements-Elements hinzu. Mit diesem XML-Code wird ein Feld für den Inhaltstyp definiert.
Wichtig Sie müssen FieldId im ID-Attribut durch eine GUID ersetzen. Klicken Sie zum Generieren einer GUID auf Tools und dann auf GUID erstellen.
<Field ID="FieldId" Type="Choice" Name="FavoriteColor" DisplayName="Favorite Color" ShowInDisplayForm="TRUE" ShowInNewForm="TRUE" ShowInEditForm="TRUE"> <CHOICES> <CHOICE>Red</CHOICE> <CHOICE>Green</CHOICE> <CHOICE>Blue</CHOICE> <CHOICE>Purple</CHOICE> <CHOICE>Magenta</CHOICE> </CHOICES> </Field>
Erstellen des Inhaltstyps
Ein Inhaltstyp definiert eine Auflistung von Elementen, die innerhalb der Liste verwendet werden sollen. Weitere Informationen zu Inhaltstypen finden Sie unter Inhaltstypen.
So erstellen Sie den Inhaltstyp
Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf das Projekt FavoriteColorList, und wählen Sie Hinzufügen und dann Neues Element aus.
Wählen Sie im Dialogfeld Neues Element hinzufügen die Vorlage Inhaltstyp aus, und geben Sie FavoriteColorContentType in das Feld Name ein. Klicken Sie auf Hinzufügen.
Wählen Sie im Dialogfeld Inhaltstypeinstellungen auswählen die Option Element im Dropdownlistenfeld Von welchem Basisinhaltstyp soll dieser Inhaltstyp erben? aus. Klicken Sie auf Fertig stellen.
Sie müssen im FieldRefs-Element ein FieldRef-Element hinzufügen, das auf das zuvor definierte Feld verweist. Im folgenden XML-Code wird ein Verweis auf das Feld hinzugefügt.
Wichtig Das ID-Attribut des FieldRef-Elements muss mit dem ID-Attribut des Field-Elements übereinstimmen.
<FieldRef ID="FieldId" Name="FavoriteColor" />
Erstellen der Listendefinition vom Inhaltstyp
So erstellen Sie die Listendefinition vom Inhaltstyp
Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf das Projekt FavoriteColorList, und wählen Sie Hinzufügen und dann Neues Element aus.
Wählen Sie im Dialogfeld Neues Element hinzufügen die Vorlage Listendefinition von Inhaltstyp aus, und geben Sie FavoriteColorListDefinition in das Feld Name ein. Klicken Sie auf Hinzufügen.
Stellen Sie im Dialogfeld Listendefinitionseinstellungen auswählen sicher, dass FavoriteColorContentType im Dropdownlistenfeld Welcher Inhaltstyp soll für die Listendefinition verwendet werden? ausgewählt ist.
Aktivieren Sie die Option Fügt eine Listeninstanz für diese Listendefinition hinzu. Klicken Sie auf Fertig stellen.
Öffnen Sie dann die erstellt Datei Schema.xml.
Fügen Sie im ViewFields-Element dasselbe FieldRef-Element hinzu, das Sie dem Inhaltstyp hinzugefügt haben. Im folgenden XML-Code wird ein Verweis auf das Feld hinzugefügt.
Wichtig Das ID-Attribut des FieldRef-Elements muss mit dem ID-Attribut des Field-Elements übereinstimmen.
<FieldRef ID="FieldId" Name="FavoriteColor" />
Bereitstellen der Listendefinition
So stellen Sie die Listendefinition bereit
Drücken Sie F5, um die Lösung bereitzustellen.
Klicken Sie bei geöffnetem Browser auf FavoriteColorList - ListInstance1 im linken Navigationsbereich.
Sehen Sie sich, nachdem die Liste geöffnet wurde, das Feld Favorite Color an, das nun sichtbar ist. Klicken Sie auf Neues Element hinzufügen.
Sehen Sie sich das Feld Favorite Color im Formular an.