モジュールを使用してソリューションにファイルを含める
ファイルの種類 (新しいマスター ページなど) に関係なく、SharePoint サーバーへのファイルの配置が必要になる場合があります。 その場合は、"モジュール" (Visual Basic コード モジュールと混同しないでください) を使用できます。 モジュールは、SharePoint ソリューション内のファイルのコンテナーです。 ソリューションが配置されると、モジュール内のファイルが SharePoint サーバー上の指定されたフォルダーにコピーされます。
モジュールの項目と要素
モジュールを作成するには、[新しい項目の追加] ダイアログ ボックスでそれを選択し、プロジェクトに追加します。 その後、その Elements.xml ファイルを変更し、配置するファイルの名前、システム上の配置先、および SharePoint サーバー上でのコピー先を含めます。
モジュールの Elements.xml ファイルの例を以下に示します。
<?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>
新しく作成されたモジュールには、次の既定のファイルが含まれています。
| File Name | 説明 |
|---|---|
| Elements.xml | モジュールの定義ファイル。 |
| Sample.txt | モジュール内のファイルの例として機能するプレースホルダー ファイル。 |
Elements.xml ファイルには次の要素が含まれます。
| 要素名 | 説明 |
|---|---|
| 要素 | モジュールで定義されているすべての要素が含まれます。 |
| モジュール | Module 要素には、<Module Name="Module1"> という形式でモジュールの名前を指定する 1 つの属性 (Name) があります。モジュールの名前 (またはその Folder Name プロパティ) を変更した場合は、Module 要素内の名前を手動で更新する必要があることに注意してください。 Module 要素内のファイルのサブディレクトリを指定すると、Windows SharePoint Services (WSS) によって、それに一致するディレクトリ構造が自動的に作成されます。 |
| ファイル | File 要素には、Path と Url の 2 つのパラメーターがあります。 - Path: SharePoint ソリューション内のファイルの名前と場所。 形式は Path="Module1\Sample.txt" です。- Url: SharePoint サーバー上のファイルの配置先。 形式は Url="Module1/Sample.txt" です。- Type: 次の 2 つの設定値を持つ省略可能な属性: GhostableInLibrary と Ghostable。 形式は Type="GhostableInLibrary" です。 GhostableInLibrary を指定すると、ファイルは、ライブラリに追加されたときにそのファイルに付随するリスト項目と共に、SharePoint のドキュメント ライブラリに追加されます。 Ghostable を指定すると、ファイルがドキュメント ライブラリの外部の SharePoint に追加されます。 |
配置する各ファイルでは、Elements.xml に個別の <File> 要素エントリが必要です。