Compartir por

Winmdexp.exe (Herramienta de exportación de metadatos de Windows Runtime)

La Herramienta de exportación de metadatos de Windows Runtime (Winmdexp.exe) transforma un módulo de .NET Framework en un archivo que contiene metadatos de Windows Runtime. Aunque los ensamblados de .NET Framework y los archivos de metadatos de Windows Runtime usan el mismo formato físico, existen diferencias en el contenido de las tablas de metadatos, lo que significa que los ensamblados de .NET Framework no se pueden usar automáticamente como componentes de Windows Runtime. El proceso de convertir un módulo de .NET Framework en un componente de Windows Runtime se conoce como exportación. En .NET Framework 4.5 y 4.5.1, el archivo resultante de metadatos de Windows (.winmd) contiene metadatos e implementación.

Cuando usas la plantilla Componente de Windows Runtime , que se encuentra en la Tienda Windows para C# y Visual Basic en Visual Studio 2013 o Visual Studio 2012, el destino del compilador es un archivo .winmdobj y un paso de compilación posterior llama a Winmdexp.exe para exportar el archivo .winmdobj a un archivo .winmd. Esta es la manera recomendada de compilar un componente de Windows Runtime. Use Winmdexp.exe directamente cuando quiera tener más control sobre el proceso de compilación que proporciona Visual Studio.

Esta herramienta se instala automáticamente con Visual Studio. Para ejecutar la herramienta, use el símbolo del sistema para desarrolladores de Visual Studio o Visual Studio Developer PowerShell.

En el símbolo del sistema, escriba lo siguiente:

Sintaxis

winmdexp [options] winmdmodule

Parámetros

Argumento o opción Descripción
winmdmodule Especifica el módulo (.winmdobj) que se va a exportar. Solo se permite un módulo. Para crear este módulo, use la /target opción del compilador con el winmdobj destino. Consulte -target:winmdobj (Opciones del compilador de C#) o -target (Visual Basic).
/docfile: docfile

/d: docfile 		Especifica el archivo de documentación XML de salida que Winmdexp.exe generará. En .NET Framework 4.5, el archivo de salida es esencialmente el mismo que el archivo de documentación XML de entrada.
/moduledoc: docfile

/md: docfile 		Especifica el nombre del archivo de documentación XML que el compilador generó con winmdmodule.
/modulepdb: symbolfile

/mp: symbolfile 		Especifica el nombre del archivo de base de datos de programa (PDB) que contiene símbolos para winmdmodule.
/nowarn: warning Suprime el número de advertencia especificado. Para la advertencia, proporcione solo la parte numérica del código de error, sin ceros iniciales.
/out: file

/o: file 		Especifica el nombre del archivo de metadatos de Windows de salida (.winmd).
/pdb: symbolfile

/p: symbolfile 		Especifica el nombre del archivo de base de datos de programa de salida (PDB) que contendrá los símbolos del archivo de metadatos de Windows exportado (.winmd).
/reference: winmd

/r: winmd 		Especifica un archivo de metadatos (.winmd o ensamblado) al que se hace referencia durante la exportación. Si usa los ensamblados de referencia en "\Archivos de programa (x86)\Ensamblados de referencia\Microsoft\Framework\. NETCore\v4.5" ("\Archivos de programa\..." en equipos de 32 bits), incluya referencias a System.Runtime.dll y mscorlib.dll.
/utf8output Especifica que los mensajes de salida deben estar en codificación UTF-8.
/warnaserror+ Especifica que todas las advertencias deben tratarse como errores.
@ responsefile Especifica un archivo de respuesta (.rsp) que contiene opciones (y opcionalmente winmdmodule). Cada línea de responsefile debe contener un único argumento o opción.

Observaciones

Winmdexp.exe no está diseñado para convertir un ensamblado arbitrario de .NET Framework en un archivo .winmd. Requiere un módulo compilado con la /target:winmdobj opción y se aplican restricciones adicionales. Lo más importante de estas restricciones es que todos los tipos que se exponen en la superficie de API del ensamblado deben ser tipos de Windows Runtime. Para obtener más información, vea la sección "Declarar tipos en componentes de Windows Runtime" del artículo Creación de componentes de Windows Runtime en C# y Visual Basic.

Al escribir una aplicación de la Tienda Windows 8.x o un componente de Windows Runtime con C# o Visual Basic, .NET Framework proporciona compatibilidad para que la programación con Windows Runtime sea más natural. Esto se describe en el artículo Compatibilidad de .NET Framework con aplicaciones de la Tienda Windows y Windows Runtime. En el proceso, algunos tipos de Windows Runtime usados habitualmente se asignan a tipos de .NET Framework. Winmdexp.exe invierte este proceso y genera una superficie de API que usa los tipos de Windows Runtime correspondientes. Por ejemplo, los tipos que se construyen a partir de la IList<T> interfaz se asignan a tipos que se construyen a partir de la interfaz de Windows Runtime IVector<T> .

Consulte también

  • Last updated on