Share via


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

  1. Starten Sie Microsoft Visual Studio 2010.

  2. Zeigen Sie im Menü Datei auf Neu, und klicken Sie dann auf Projekt.

  3. Wählen Sie in Projekttypen unter Visual Basic oder C# die Option Leeres SharePoint-Projekt aus.

  4. Geben Sie FavoriteColorList als Projektnamen ein. Klicken Sie auf OK.

  5. Wählen Sie im Assistenten zum Anpassen von SharePoint die Option Als Sandkastenlösung bereitstellen aus. Klicken Sie auf Fertig stellen.

  6. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf das Projekt FavoriteColorList, und wählen Sie Hinzufügen und dann Neues Element aus.

  7. 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.

  8. Fügen Sie den folgenden XML-Code innerhalb des Elements-Elements hinzu. Mit diesem XML-Code wird ein Feld für den Inhaltstyp definiert.

    Wichtiger HinweisWichtig

    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

  1. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf das Projekt FavoriteColorList, und wählen Sie Hinzufügen und dann Neues Element aus.

  2. 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.

  3. 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.

  4. 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.

    Wichtiger HinweisWichtig

    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

  1. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf das Projekt FavoriteColorList, und wählen Sie Hinzufügen und dann Neues Element aus.

  2. 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.

  3. Stellen Sie im Dialogfeld Listendefinitionseinstellungen auswählen sicher, dass FavoriteColorContentType im Dropdownlistenfeld Welcher Inhaltstyp soll für die Listendefinition verwendet werden? ausgewählt ist.

  4. Aktivieren Sie die Option Fügt eine Listeninstanz für diese Listendefinition hinzu. Klicken Sie auf Fertig stellen.

  5. Öffnen Sie dann die erstellt Datei Schema.xml.

  6. 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.

    Wichtiger HinweisWichtig

    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

  1. Drücken Sie F5, um die Lösung bereitzustellen.

  2. Klicken Sie bei geöffnetem Browser auf FavoriteColorList - ListInstance1 im linken Navigationsbereich.

  3. 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.

  4. Sehen Sie sich das Feld Favorite Color im Formular an.

Siehe auch

Konzepte

Listenvorlagendateien

Verwenden von Features

Websitetypen: WebTemplates und Websitedefinitionen

Grundlegendes zu "Schema.XML"-Dateien