tarefa SGen

  • Artigo

Cria um assembly de serialização de XML para tipos no assembly especificado. A tarefa encapsula a Ferramenta geradora de serializador de XML (Sgen.exe). Para saber mais, confira Ferramenta geradora de serializador de XML (Sgen.exe).

Parâmetros

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

Parâmetro Descrição
BuildAssemblyName Parâmetro String obrigatório.

Defina o assembly para o qual gerar código de serialização.
BuildAssemblyPath Parâmetro String obrigatório.

O caminho para o assembly para o qual gerar código de serialização.
DelaySign Parâmetro Boolean opcional.

Se for true, especificará que você apenas deseja colocar a chave pública no assembly. Se for false, especificará que você deseja um assembly totalmente com sinal.

Esse parâmetro não terá nenhum efeito a menos que seja usado com o parâmetro KeyFile ou KeyContainer.
KeyContainer Parâmetro String opcional.

Especifica um contêiner que mantém um par de chaves. Isso assinará o assembly inserindo uma chave pública no manifesto do assembly. A tarefa assinará então o assembly final com a chave privada.
KeyFile Parâmetro String opcional.

Especifica um par de chaves ou uma chave pública a usar para assinar um assembly. O compilador insere a chave pública no manifesto do assembly e, em seguida, assina o assembly final com a chave privada.
Platform Parâmetro String opcional.

Obtém ou define a plataforma do compilador usado para gerar o assembly de saída. Esse parâmetro pode ter um valor igual a x86, x64 ou anycpu. O padrão é anycpu.
References Parâmetro String[] opcional.

Especifica os assemblies que são referenciados pelos tipos que exigem a serialização de XML.
SdkToolsPath Parâmetro String opcional.

Especifica o caminho para o SDK Tools, como resgen.exe.
SerializationAssembly Parâmetro de saída ITaskItem[] opcional.

Contém o assembly de serialização gerado.
SerializationAssemblyName Parâmetro String opcional.

Especifica o nome do assembly de serialização gerado.
ShouldGenerateSerializer Parâmetro Boolean obrigatório.

Se true, a tarefa SGen deve gerar um assembly de serialização.
Timeout Parâmetro Int32 opcional.

Especifica a quantidade de tempo em milissegundos após o qual o executável da tarefa é encerrado. O valor padrão é Int.MaxValue, indicando que não há período de tempo limite.
ToolPath Parâmetro String opcional.

Especifica o local de onde tarefa carregará o arquivo executável subjacente (sgen.exe). Se esse parâmetro não for especificado, a tarefa usará o caminho de instalação do SDK correspondente à versão da estrutura que está executando o MSBuild.
Types Parâmetro String[] opcional.

Obtém ou define uma lista de tipos específicos para os quais gerar código de serialização. O SGen gerará o código de serialização somente para esses tipos.
UseProxyTypes Parâmetro Boolean obrigatório.

Se true, a tarefa SGen gera o código de serialização somente para os tipos de proxy de serviço Web XML.

Parâmetros de ToolTaskExtension

Essa tarefa herda da classe ToolTaskExtension, que herda da classe ToolTask, que por sua vez herda da classe Task. Esta cadeia de herança adiciona vários parâmetros nas tarefas que derivam deles.

A seguinte tabela descreve os parâmetros das classes base:

Parâmetro Descrição
EchoOff Parâmetro bool opcional.

Quando definido como true, essa tarefa passa /Q para a linha de comando de cmd.exe, de modo que a linha de comando não é copiada para stdout.
EnvironmentVariables Parâmetro de matriz String opcional.

Matriz de definições da variável de ambiente, separadas por ponto e vírgula. Cada definição deve especificar um nome da variável de ambiente e um valor separados por um sinal de igual. Essas variáveis são passadas para o executável gerado além, ou seletivamente substituindo, o bloco de ambiente regular. Por exemplo, Variable1=Value1;Variable2=Value2.
ExitCode Parâmetro de saída opcional somente leitura Int32.

Especifica o código de saída fornecido pelo comando executado. Se a tarefa registra erros, mas o processo tem um código de saída de 0 (êxito), isso é definido como -1.
LogStandardErrorAsError Parâmetro bool opcional.

Se true, todas as mensagens recebidas no fluxo de erro padrão são registradas como erros.
StandardErrorImportance Parâmetro String opcional.

a importância com a qual o texto do fluxo de erro padrão deve ser registrado.
StandardOutputImportance Parâmetro String opcional.

Importância para fazer o texto de log do fluxo de saída do padrão.
Timeout Parâmetro Int32 opcional.

Especifica a quantidade de tempo em milissegundos após o qual o executável da tarefa é encerrado. O valor padrão é Int.MaxValue, indicando que não há período de tempo limite. O tempo limite está em milissegundos.
ToolExe Parâmetro string opcional.

Projetos podem implementar para substituir um ToolName. Tarefas podem substituir isso para preservar o ToolName.
ToolPath Parâmetro string opcional.

Especifica o local de onde a tarefa carrega o arquivo executável subjacente. Se esse parâmetro não for especificado, a tarefa usará o caminho de instalação do SDK correspondente à versão da estrutura que está executando o MSBuild.
UseCommandProcessor Parâmetro bool opcional.

Quando definido como true, essa tarefa cria um arquivo em lotes para a linha de comando e o executa usando o processador de comando em vez de executar o comando diretamente.
YieldDuringToolExecution Parâmetro bool opcional.

Quando definido como true, essa tarefa gera o nó quando a tarefa está em execução.

Confira também