Compartilhar via

Winmdexp.exe (Ferramenta de Exportação de Metadados do Windows Runtime)

A Ferramenta de Exportação de Metadados do Windows Runtime (Winmdexp.exe) transforma um módulo do .NET Framework em um arquivo que contém metadados do Windows Runtime. Embora os assemblies do .NET Framework e os arquivos de metadados do Windows Runtime usem o mesmo formato físico, há diferenças no conteúdo das tabelas de metadados, o que significa que os assemblies do .NET Framework não são utilizáveis automaticamente como componentes do Windows Runtime. O processo de transformar um módulo do .NET Framework em um componente do Windows Runtime é chamado de exportação. No .NET Framework 4.5 e 4.5.1, o arquivo de metadados do Windows resultante (.winmd) contém metadados e implementação.

Quando você usa o modelo componente do Windows Runtime , que está localizado na Windows Store para C# e visual Basic no Visual Studio 2013 ou Visual Studio 2012, o destino do compilador é um arquivo .winmdobj e uma etapa de build subsequente chama Winmdexp.exe para exportar o arquivo .winmdobj para um arquivo .winmd. Essa é a maneira recomendada de criar um componente do Windows Runtime. Use Winmdexp.exe diretamente quando quiser mais controle sobre o processo de build do que o Visual Studio fornece.

Essa ferramenta é instalada automaticamente com o Visual Studio. Para executar a ferramenta, use o Prompt de Comando do Desenvolvedor do Visual Studio ou o PowerShell do Desenvolvedor do Visual Studio.

No prompt de comando, digite o seguinte:

Sintaxe

winmdexp [options] winmdmodule

Parâmetros

Argumento ou opção Descrição
winmdmodule Especifica o módulo (.winmdobj) a ser exportado. Somente um módulo é permitido. Para criar este módulo, use a opção /target do compilador com o winmdobj destino. Consulte -target:winmdobj (Opções do Compilador C#) ou -target (Visual Basic).
/docfile: docfile

/d: docfile 		Especifica o arquivo de documentação XML de saída que Winmdexp.exe produzirá. No .NET Framework 4.5, o arquivo de saída é essencialmente o mesmo que o arquivo de documentação XML de entrada.
/moduledoc: docfile

/md: docfile 		Especifica o nome do arquivo de documentação XML que o compilador produziu com winmdmodule.
/modulepdb: symbolfile

/mp: symbolfile 		Especifica o nome do arquivo PDB (banco de dados do programa) que contém símbolos para winmdmodule.
/nowarn: warning Suprime o número de aviso especificado. Para aviso, forneça apenas a parte numérica do código de erro, sem zeros à esquerda.
/out: file

/o: file 		Especifica o nome do arquivo de metadados do Windows de saída (.winmd).
/pdb: symbolfile

/p: symbolfile 		Especifica o nome do arquivo PDB (banco de dados do programa de saída) que conterá os símbolos do arquivo de metadados do Windows exportado (.winmd).
/reference: winmd

/r: winmd 		Especifica um arquivo de metadados (.winmd ou assembly) a ser referenciado durante a exportação. Se você usar os assemblies de referência em "\Arquivos de Programas (x86)\Assemblies de Referência\Microsoft\Framework\. NETCore\v4.5" ("\Arquivos de Programas\..." em computadores de 32 bits), inclua referências a System.Runtime.dll e mscorlib.dll.
/utf8output Especifica que as mensagens de saída devem estar na codificação UTF-8.
/warnaserror+ Especifica que todos os avisos devem ser tratados como erros.
@ responsefile Especifica um arquivo de resposta (.rsp) que contém opções (e, opcionalmente winmdmodule). Cada linha deve responsefile conter um único argumento ou opção.

Observações

Winmdexp.exe não foi projetado para converter um assembly arbitrário do .NET Framework em um arquivo .winmd. Ele requer um módulo compilado com a opção /target:winmdobj e restrições adicionais se aplicam. A mais importante dessas restrições é que todos os tipos expostos na superfície da API do assembly devem ser tipos do Windows Runtime. Para obter mais informações, consulte a seção "Declarando tipos em componentes do Windows Runtime" do artigo Criando componentes do Windows Runtime em C# e Visual Basic.

Quando você escreve um aplicativo da Windows 8.x Store ou um componente do Windows Runtime com C# ou Visual Basic, o .NET Framework dá suporte para tornar a programação com o Windows Runtime mais natural. Isso é discutido no artigo .NET Framework Support for Windows Store Apps and Windows Runtime. No processo, alguns tipos de Windows Runtime comumente usados são mapeados para tipos do .NET Framework. Winmdexp.exe inverte esse processo e produz uma superfície de API que usa os tipos de Windows Runtime correspondentes. Por exemplo, tipos que são construídos do IList<T> mapa de interface para tipos que são construídos a partir da interface do Windows Runtime IVector<T> .

Consulte também

  • Last updated on