Verwenden von Modulen zum Einbinden von Dateien in eine Projektmappe
Manchmal kann es vorkommen, dass Sie Dateien auf dem SharePoint-Server unabhängig vom Dateityp bereitstellen möchten, z. B. neue Masterseiten. Zu diesem Zweck können Sie Module verwenden (nicht zu verwechseln mit Visual Basic-Codemodulen). Module sind Container für Dateien in einer SharePoint-Lösung. Wenn die Lösung bereitgestellt wird, werden die Dateien im Modul in die angegebenen Ordner auf dem SharePoint-Server kopiert.
Module-Elemente und Elements-Dateien
Um ein Modul zu erstellen, fügen Sie es einem Projekt hinzu, indem Sie es im Dialogfeld Neues Element hinzufügen auswählen. Ändern Sie dann seine Datei Elements.xml so, dass sie die Namen der Dateien enthält, die Sie bereitstellen möchten, und angibt, wo sie sich im System befinden und wohin sie auf dem SharePoint-Server kopiert werden sollen.
Im Folgenden finden Sie ein Beispiel für die Datei Elements.xml für ein Modul:
<?xml version="1.0" encoding="utf-8"?>
<Elements xmlns="http://schemas.microsoft.com/sharepoint/">
<Module Name="Module1">
<File Path="Module1\Sample.txt" Url="Module1/Sample.txt" />
</Module>
</Elements>
Neu erstellte Module enthalten die folgenden Standarddateien:
| Dateiname | Beschreibung |
|---|---|
| Elements.xml | Die Definitionsdatei für das Modul. |
| Sample.txt | Eine Platzhalterdatei, die als Beispiel für eine Datei im Modul dient. |
Die Datei Elements.xml enthält die folgenden Elemente:
| Elementname | BESCHREIBUNG |
|---|---|
| Elemente | Enthält alle Elemente, die im Modul definiert sind. |
| Modul | Das Module-Element verfügt über ein einzelnes Attribut (Name), das den Namen des Moduls im Format <Module Name="Module1"> angibt.Beachten Sie Folgendes: Wenn Sie den Namen des Moduls (oder dessen Eigenschaft Folder Name) ändern, müssen Sie den Namen im Module-Element manuell aktualisieren. Wenn Sie ein Unterverzeichnis für die Dateien im Module-Element angeben, erstellt Windows SharePoint Services (WSS) automatisch eine passende Verzeichnisstruktur. |
| Datei | Das File-Element verfügt über zwei Parameter: Path und Url. - Path: Der Name und Speicherort der Datei in der SharePoint-Lösung. Das Format lautet: Path="Module1\Sample.txt".- Url: Der Speicherort, in dem die Datei auf dem SharePoint-Server bereitgestellt wird. Das Format lautet: Url="Module1/Sample.txt".- Type: Ein optionales Attribut, das über zwei Einstellungen verfügt: GhostableInLibrary und Ghostable. Das Format lautet: Type="GhostableInLibrary". Wenn Sie GhostableInLibrary angeben, wird die Datei einer Dokumentbibliothek in SharePoint gemeinsam mit einem Listenelement hinzugefügt, das die Datei begleitet, wenn sie der Bibliothek hinzugefügt wird. Wenn Sie Ghostable angeben, wird die Datei SharePoint außerhalb der Dokumentbibliothek hinzugefügt. |
Für jede Datei, die Sie bereitstellen möchten, ist ein separater <File>-Elementeintrag in Elements.xml erforderlich.