Compartilhar via


Tarefa WriteLinesToFile

Grava os caminhos dos itens especificados no arquivo de texto especificado.

Parâmetros da tarefa

A tabela a seguir descreve os parâmetros da WriteLinestoFile tarefa.

Parâmetro

Descrição

File

Obrigatório ITaskItem parâmetro.

Especifica o arquivo para gravar os itens.

Lines

Opcional ITaskItem[] parâmetro.

Especifica os itens para gravar no arquivo.

Overwrite

Opcional Boolean parâmetro.

Se true, a tarefa substitui qualquer conteúdo existente no arquivo.

Encoding

Opcional String parâmetro.

Seleciona o caractere de codificação, por exemplo, "Unicode". See also Encoding.

Comentários

Se Overwrite é true, cria um novo arquivo, gravar o conteúdo no arquivo e, em seguida, fecha o arquivo. Se o arquivo de destino já existir, ele será sobrescrito. Se Overwrite é false, acrescenta o conteúdo para o arquivo, criando o arquivo de destino se ele ainda não existir.

Com os parâmetros listados acima, esta tarefa herda os parâmetros da TaskExtension herda de classe, que por si só a Task classe. Para obter uma lista desses parâmetros adicionais e suas descrições, consulte Classe TaskExtension (base).

Exemplo

O exemplo a seguir usa a WriteLinesToFile tarefa de escrever os caminhos dos itens na MyItems item da coleção para o arquivo especificado pelo MyTextFile item da coleção.

<Project xmlns="https://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>

Consulte também

Conceitos

Tarefas do MSBuild

Outros recursos

Referência das tarefas do MSBuild