Delen via

Winmdexp.exe (hulpprogramma voor het exporteren van metagegevens van Windows Runtime)

  • Artikel

Met het Hulpprogramma voor het exporteren van metagegevens van Windows Runtime (Winmdexp.exe) wordt een .NET Framework-module omgezet in een bestand dat metagegevens van Windows Runtime bevat. Hoewel .NET Framework-assembly's en Windows Runtime-metagegevensbestanden dezelfde fysieke indeling gebruiken, zijn er verschillen in de inhoud van de metagegevenstabellen, wat betekent dat .NET Framework-assembly's niet automatisch kunnen worden gebruikt als Windows Runtime-onderdelen. Het proces voor het omzetten van een .NET Framework-module in een Windows Runtime-onderdeel wordt ook wel exporteren genoemd. In .NET Framework 4.5 en 4.5.1 bevat het resulterende Windows-metagegevensbestand (.winmd) zowel metagegevens als implementatie.

Wanneer u de Windows Runtime Component-sjabloon gebruikt, die zich bevindt onder Windows Store voor C# en Visual Basic in Visual Studio 2013 of Visual Studio 2012, is het compilerdoel een .winmdobj-bestand en wordt in een volgende buildstap Winmdexp.exe aangeroepen om het .winmdobj-bestand te exporteren naar een .winmd-bestand. Dit is de aanbevolen manier om een Windows Runtime-onderdeel te bouwen. Gebruik Winmdexp.exe rechtstreeks als u meer controle wilt over het buildproces dan Visual Studio biedt.

Dit hulpprogramma wordt automatisch geïnstalleerd met Visual Studio. Als u het hulpprogramma wilt uitvoeren, gebruikt u de Visual Studio Developer-opdrachtprompt of Visual Studio Developer PowerShell.

Typ het volgende bij de opdrachtprompt:

Syntaxis

winmdexp [options] winmdmodule

Parameters

Argument of optie Beschrijving
winmdmodule Hiermee geeft u de module (.winmdobj) die moet worden geëxporteerd. Er is slechts één module toegestaan. Als u deze module wilt maken, gebruikt u de /target compileroptie met het winmdobj doel. Zie -target:winmdobj (C#-compileropties) of -target (Visual Basic).
/docfile: docfile

/d: docfile		 Hiermee geeft u het XML-uitvoerdocumentatiebestand op dat Winmdexp.exe produceert. In .NET Framework 4.5 is het uitvoerbestand in feite hetzelfde als het XML-invoerdocumentatiebestand.
/moduledoc: docfile

/md: docfile		 Hiermee geeft u de naam van het XML-documentatiebestand waarmee de compiler is geproduceerd winmdmodule.
/modulepdb: symbolfile

/mp: symbolfile		 Hiermee geeft u de naam van het programmadatabasebestand (PDB) dat symbolen voor winmdmodulebevat.
/nowarn: warning Onderdrukt het opgegeven waarschuwingsnummer. Geef voor waarschuwing alleen het numerieke gedeelte van de foutcode op, zonder voorloopnullen.
/out: file

/o: file		 Hiermee geeft u de naam van het windows-uitvoermetagegevensbestand (.winmd).
/pdb: symbolfile

/p: symbolfile		 Hiermee geeft u de naam van het PDB-bestand (output program database) dat de symbolen voor het geëxporteerde Windows-metagegevensbestand (.winmd) bevat.
/reference: winmd

/r: winmd		 Hiermee geeft u een metagegevensbestand (.winmd of assembly) waarnaar moet worden verwezen tijdens de export. Als u de referentieassembly's gebruikt in \Program Files (x86)\Reference Assemblies\Microsoft\Framework\. NETCore\v4.5" ("\Program Files\..." op 32-bits computers) bevatten verwijzingen naar zowel System.Runtime.dll als mscorlib.dll.
/utf8output Hiermee geeft u op dat uitvoerberichten moeten worden gecodeerd in UTF-8.
/warnaserror+ Hiermee geeft u op dat alle waarschuwingen moeten worden behandeld als fouten.
@ responsefile Hiermee geeft u een antwoordbestand (.rsp) met opties (en optioneel winmdmodule). Elke regel moet responsefile één argument of optie bevatten.

Opmerkingen

Winmdexp.exe is niet ontworpen om een willekeurige .NET Framework-assembly te converteren naar een .winmd-bestand. Hiervoor is een module vereist die is gecompileerd met de /target:winmdobj optie en er gelden aanvullende beperkingen. Het belangrijkste van deze beperkingen is dat alle typen die worden weergegeven in het API-oppervlak van de assembly Windows Runtime-typen moeten zijn. Zie de sectie 'Typen declareren in Windows Runtime-onderdelen' van het artikel Windows Runtime-onderdelen maken in C# en Visual Basic voor meer informatie.

Wanneer u een Windows 8.x Store-app of een Windows Runtime-onderdeel schrijft met C# of Visual Basic, biedt .NET Framework ondersteuning om programmeren met Windows Runtime natuurlijker te maken. Dit wordt besproken in het artikel .NET Framework-ondersteuning voor Windows Store-apps en Windows Runtime. In het proces worden enkele veelgebruikte Windows Runtime-typen toegewezen aan .NET Framework-typen. Winmdexp.exe dit proces omkeren en een API-oppervlak produceert dat gebruikmaakt van de bijbehorende Windows Runtime-typen. Bijvoorbeeld typen die zijn samengesteld op basis van de IList<T> interfacetoewijzing naar typen die zijn samengesteld vanuit de Windows Runtime-interface IVector<T> .

Zie ook