Compartilhar via

Sinalizadores de linha de comando do compilador VSCT

O compilador VSCT (Tabela de Comandos do Visual Studio) fornece opções de linha de comando para garantir a compilação bem-sucedida de arquivos .vsct.

Parâmetros da linha de comando

Para exibir a ajuda básica do VSCT em uma janela de comando do Visual Studio, navegue até a pasta Caminho de instalação do SDK do Visual Studio\VisualStudioIntegration\Tools\Bin\ e digite:

vsct /?

Isso retorna:

Microsoft (R) Visual Studio (R) Command Table Compiler Version 3.00.2000

Syntax: vsct <infile> [<outfile>] [-S[symbols file]] [-D<preprocessor-define>]*
[-I<include-path>]* [-L<language>] [-E[C|H|N]:<name>]

  -D    Specify any additional preprocessor defines
  -I    Indicate what additional include paths to send to the preprocessor
  -L    Specify the language to use when selecting strings
  -E    Emit C# objects in the specified namespace for command items,
        followed by [L|F|H|N]:<value>
        F = Name of the file to emit (used if -EL is provided)
        L = Name of a language providing a CodeDOM provider
        N = namespace (required if -EL is provided)
        H = C++ header
  -c    Clean build skipping dependency checks
  -v    Verbose output

Observação

Os caracteres - (traço) e / (barra para frente) são ambos notação aceita para indicar parâmetros de linha de comando.

As bandeiras aceitáveis e o que elas significam são as seguintes.

Switch Descrição
-D Especifique quaisquer símbolos adicionais definidos.
-I Indique os caminhos de inclusão adicionais que devem ser usados ao resolver referências de arquivo.
-L Especifique o nome da CultureInfo cultura, por exemplo, "en-US".
-E Emita objetos C# no namespace especificado para itens de comando, seguido por [C|H|N]:nome do arquivoonde C = C#, H = cabeçalho C++, N = namespace. O namespace é necessário para C#.
-v Saída detalhada.

A opção -L instrui o compilador a selecionar um grupo de cadeias de caracteres para produzir o arquivo binário .cto que corresponde ao nome de cultura fornecido CultureInfo . O nome da cultura especificado deve corresponder ao atributo Language de um ou mais Strings Element no arquivo .vsct. Se um elemento Strings não tiver nenhum atributo Language, ele será herdado do elemento CommandTable que contém.

Um arquivo .vsct pode ter vários elementos Strings e cada um pode ter um atributo Language diferente. A globalização é obtida executando o compilador VSCT várias vezes e alterando a opção -L para cada nome de cultura.

Se o nome da cultura dado pela opção -L não corresponder ao atributo Language de qualquer elemento Strings, o compilador tentará corresponder ao idioma, e não à região. Por exemplo, se "en-US" não puder ser encontrado, o compilador tentará "en". Caso contrário, ele tentará a cultura atual do sistema operacional. Caso contrário, ele compilará o primeiro elemento Strings encontrado.

A opção -E pode ser usada para emitir um arquivo de cabeçalho de estilo C que contém os símbolos usados pela tabela de comandos ou para emitir um arquivo C# que contém objetos para os símbolos de comando.

As opções -D e -I têm a sintaxe dos sinalizadores de pré-processador Cl.exe C que têm o mesmo nome. -D definições que têm o formato X=Y são usadas para a expansão de testes definidos> baseados <em XML em Condition atributos. -I include caminhos são usados para resolver <referências de arquivo Include>, <Extern> e <Bitmap> . Para obter mais informações, consulte VSCT XML Schema Reference.

O compilador VSCT também pode descompilar um arquivo binário criado anteriormente. Para fazer isso, forneça um arquivo binário para o <infile>. Se o arquivo binário foi produzido pelo compilador VSCT, ele terá seus símbolos já incorporados e produzirá saída com os nomes simbólicos em uma <seção Símbolos> da saída. Se o binário foi produzido pelo compilador CTC, a saída conterá os GUIDs e IDs reais. Se o arquivo *.ctsym produzido pelas versões atuais do Ctc.exe estiver na mesma pasta que o arquivo de entrada binário, os símbolos serão carregados desse arquivo e usados para saída.

Confira também