WriteLinesToFile タスクWriteLinesToFile Task

指定したアイテムのパスを指定したテキスト ファイルに書き込みます。Writes the paths of the specified items to the specified text file.

タスク パラメーターTask Parameters

WriteLinestoFile タスクのパラメーターの説明を次の表に示します。The following table describes the parameters of the WriteLinestoFile task.

パラメーターParameter 説明Description
File 必須の ITaskItem 型のパラメーターです。Required ITaskItem parameter.

項目を書き込むファイルを指定します。Specifies the file to write the items to.
Lines 省略可能な ITaskItem[] 型のパラメーターです。Optional ITaskItem[] parameter.

ファイルに書き込む項目を指定します。Specifies the items to write to the file.
Overwrite 省略可能な Boolean 型のパラメーターです。Optional Boolean parameter.

true の場合、タスクはファイル内の既存のコンテンツをすべて上書きします。If true, the task overwrites any existing content in the file.
Encoding 省略可能な String 型のパラメーターです。Optional String parameter.

文字エンコードを選択します。たとえば、"Unicode" を選択します。Selects the character encoding, for example, "Unicode". Encoding」も参照してください。See also Encoding.

コメントRemarks

Overwritetrue の場合、新しいファイルを作成し、内容をそのファイルに書き込んだ後、ファイルを閉じます。If Overwrite is true, creates a new file, write the contents to the file, and then closes the file. 既存のターゲット ファイルは上書きされます。If the target file already exists, it is overwritten. Overwritefalse の場合、ファイルにコンテンツを追加します。ターゲット ファイルがまだ存在しない場合は、ファイルを作成します。If Overwrite is false, appends the contents to file, creating the target file if it does not already exist.

上記のパラメーター以外に、このタスクは TaskExtension クラスからパラメーターを継承します。このクラス自体は、Task クラスから継承されます。In addition to the parameters listed above, this task inherits parameters from the TaskExtension class, which itself inherits from the Task class. これらの追加のパラメーターの一覧とその説明については、「 TaskExtension Base Class」を参照してください。For a list of these additional parameters and their descriptions, see TaskExtension Base Class.

Example

次の例では、WriteLinesToFile タスクを利用し、MyTextFile 項目コレクションにより指定されたファイルに、MyItems 項目コレクションの項目のパスを書き込みます。The following example uses the WriteLinesToFile task to write the paths of the items in the MyItems item collection to the file specified by the MyTextFile item collection.

<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">  

    <ItemGroup>  
        <MyTextFile Include="Items.txt"/>  
        <MyItems Include="*.cs"/>  
    </ItemGroup>  

    <Target Name="WriteToFile">  
        <WriteLinesToFile  
            File="@(MyTextFile)"  
            Lines="@(MyItems)"  
            Overwrite="true"  
            Encoding="Unicode"/>  
    </Target>  

</Project>  

参照See Also

タスク Tasks
Task Reference (タスク リファレンス)Task Reference