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

  • Artículo

La Herramienta de exportación de metadatos de Windows (Winmdexp.exe) transforma un módulo de .NET Framework en un archivo que contiene los metadatos de Windows Runtime. Aunque los ensamblados de .NET Framework y los archivos de metadatos de Windows Runtime utilizan 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 utilizar de forma automática como componentes de Windows Runtime. El proceso de convertir un módulo de .NET Framework en un componente de Windows Runtime se denomina exportación. En .NET Framework 4.5 y 4.5.1, el archivo de metadatos de Windows resultante (.winmd) contiene metadatos y la implementación.

Cuando se utiliza 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 en un paso de compilación subsiguiente llama a Winmdexp.exe para exportar el archivo .winmdobj a un archivo .winmd. Esta es la manera recomendada de crear un componente de Windows Runtime. Utilice Winmdexp.exe directamente si desea 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 PowerShell de Visual Studio para desarrolladores.

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

Sintaxis

winmdexp [options] winmdmodule

Parámetros

Argumento u 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, utilice la opción del compilador /target con el destino de winmdobj. 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 va a generar. En .NET Framework 4.5, el archivo de salida es básicamente igual 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 los símbolos para winmdmodule.
/nowarn: warning Suprime el número de advertencias especificadas. Para 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 (PDB) de salida que contendrá los símbolos del archivo de metadatos de Windows (.winmd) exportado.
/reference: winmd

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

Comentarios

Winmdexp.exe no está diseñado para convertir un ensamblado de .NET Framework. arbitrario en un archivo .winmd. Requiere un módulo que se compila con la opción /target:winmdobj, y se aplican restricciones adicionales. La restricción más importante consiste en que todos los tipos que aparecen en la superficie de la API del ensamblado deben ser tipos de Windows Runtime. Para más información, vea la sección "Declarar tipos en componentes de Windows Runtime" del artículo Componentes de Windows Runtime con 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 ofrece compatibilidad para que la programación con Windows Runtime resulte un proceso más natural. Todo esto se analiza en el artículo Compatibilidad de .NET Framework con las aplicaciones de la Tienda Windows y Windows en tiempo de ejecución. En dicho proceso, se asignan a algunos tipos de uso general de Windows Runtime a tipos de .NET Framework. Winmdexp.exe invierte este proceso y genera una superficie de API que utiliza los tipos correspondientes de Windows Runtime. Por ejemplo, los tipos que se crean a partir de la interfaz IList<T> se asignan a los tipos que se crean a partir de la interfaz IVector<T> de Windows Runtime.

Consulte también