Winres.exe (Windows Resource Localization Editor)

Artikel
05/09/2023

De Windows Resource Localization Editor, Winres.exe, is een hulpmiddel voor visuele indeling waarmee lokalisatie-experts Windows Forms bronnen van de gebruikersinterface (UI) die door formulieren worden gebruikt, kunnen lokaliseren. U kunt de .resx - of .resources-bestanden maken die worden gebruikt als invoer voor Winres.exe met behulp van een visuele ontwerpomgeving zoals Microsoft Visual Studio. Zie Resources in .NET-apps voor meer informatie over het implementeren van resources in .NET Framework-toepassingen.

Winres.exe wordt geïnstalleerd met Visual Studio. Als u het hulpprogramma wilt uitvoeren, gebruikt u Visual Studio Developer Command Prompt of Visual Studio Developer PowerShell.

Waarschuwing

Open niet-vertrouwde bestanden niet met dit hulpprogramma. Als het bestand een binair bestand is, wordt het gedeserialiseerd met behulp van binaire deserialisatie, wat onveilig is. Zie Deserialisatierisico's in het gebruik van BinaryFormatter en gerelateerde typen voor meer informatie.

Syntaxis

winres resourceFile
winres /?

Argumenten

Argument	Beschrijving
`resourceFile`	Het bronbestand dat moet worden gelokaliseerd. Dit bestand moet een Windows Forms formulier .resx- of .resources-bestand zijn dat is gegenereerd door visual studioontwerper. Winres.exe kan geen algemene resx- of .resources-bestanden openen.

Optie	Beschrijving
/?	Geeft de opdrachtsyntaxis en opties voor het hulpprogramma weer.

Opmerkingen

De status van UI-elementen van een formulier in een Windows Forms-project wordt meestal opgeslagen in resourcebestanden. Dit zijn XML-bestanden met de extensie .resx of de bijbehorende gecompileerde binaire versies met de extensie .resources. Winres.exe is een hulpprogramma waarmee u een van beide typen bestanden beperkt kunt bewerken buiten de Visual Studio-ontwerpomgeving. Met name de volgende typen bewerkingen zijn toegestaan:

Een neutraal of specifiek cultuurresourcebestand kan worden bewerkt om de ui-eigenschappen van het formulier of de besturingselementen te wijzigen, zoals de tekst, grootte of positie.
Neutrale of specifieke cultuurresourcebestanden kunnen worden gegenereerd op basis van het standaardresourcebestand.
Een cultuurresourcebestand kan worden opgeslagen als een ander cultuurresourcebestand. Een Engels bronbestand (VS) kan bijvoorbeeld worden opgeslagen als een Pools bronbestand. Normaal gesproken wordt het nieuwe bestand vervolgens bewerkt om compatibel te zijn met de nieuwe cultuur.

Zie ook Hiërarchische organisatie van resources voor lokalisatie of Hiërarchische organisatie van resources voor lokalisatie.

Winres.exe kan een RESX-bestand niet converteren naar het bijbehorende .resources-bestand; gebruik in plaats daarvan het hulpprogramma Resgen.exe. Zie Resgen.exe (resourcebestandsgenerator) voor meer informatie over Resgen.exe.

Winres.exe is een grafische toepassing die een ontwerpversie van een Windows Forms formulier opnieuw maakt op basis van alleen het bronbestand, zonder toegang te hebben tot de broncode. Winres.exe host het venster Windows Forms Formulierontwerper en eigenschappen van Visual Studio. Met deze functies kunt u een .resources- of RESX-bestand met een Windows Forms formulier visueel bewerken. Lokalisatiefuncties gebruiken doorgaans Winres.exe om besturingslabels te bewerken en de locatie en grootte van besturingselementen aan te passen aan de labels voor de doelcultuur.

Als Winres.exe het type besturingselement niet kan oplossen, wordt er een tijdelijke aanduiding voor een besturingselement gemaakt in het gelokaliseerde .resx- of .resources-bestand. Het besturingselement van de tijdelijke aanduiding wordt op het Windows Forms-formulier weergegeven als een venster dat is uitgebroed. De grootte en positie van het uitgebroede venster komen overeen met die van de werkelijke besturing. Alle beschikbare lokaliseerbare eigenschappen voor het besturingselement van de tijdelijke aanduiding worden weergegeven in het venster Eigenschappen . Alle wijzigingen die u aanbrengt in het besturingselement van de tijdelijke aanduiding, worden opgeslagen voor het werkelijke besturingselement.

Winres.exe versus Visual Studio

Voordat u begint met het lokaliseren van de Windows Forms formulieren van een toepassing, moet u over het algemeen beslissen of u Visual Studio of Winres.exe wilt gebruiken als lokalisatieprogramma. Versiecompatibiliteit, zoals later beschreven, kan verhinderen dat u van het ene hulpprogramma naar het andere overschakelt.

Het voordeel van Visual Studio is dat u deze kunt gebruiken om zowel een toepassing te ontwikkelen als te lokaliseren. Als u een formulier wilt lokaliseren nadat de ontwikkeling is voltooid, stelt u de eigenschap Van het formulier (de eigenschap Lokaliseerbaar in de editor Eigenschappen) true in op en wijzigt u de eigenschap Language van het formulier LocalizableAttribute in de gewenste doelcultuur. Bewerk vervolgens tekenreeksen en pas de locatie en grootte van besturingselementen aan om de tekenreeksen voor de doelcultuur aan te passen. Wanneer u het gelokaliseerde .resx-bestand opslaat, schrijft Visual Studio alleen de lokaliseerbare eigenschappen (eigenschappen die zijn gewijzigd in de doelcultuur) naar het bestand. Visual Studio maakt automatisch een satellietassembly voor het gelokaliseerde .resx-bestand in de juiste maplocatie.

Hoewel Visual Studio een geïntegreerde ontwikkel- en lokalisatieomgeving biedt, is Winres.exe het aanbevolen hulpprogramma om te gebruiken als lokalisatie wordt uitgevoerd door localizers van derden. Omdat Winres.exe alleen een lokalisatieprogramma is, kan de code van een toepassing beter worden gescheiden van de formulieren die moeten worden gelokaliseerd. Dit is handiger voor het beheren van grote projecten.

Winres.exe gebruiken

Als u Winres.exe wilt lokaliseren, moet u eerst een toepassing ontwikkelen met behulp van een visuele ontwerper, zoals de Windows Forms Designer in Visual Studio. Wanneer de ontwikkeling is voltooid, stelt u het formulier LocalizableAttribute (de eigenschap Lokaliseerbaar in de editor Eigenschappen ) in op trueen geeft u het RESX-bestand voor de standaardcultuur aan een localizer van derden. Dit RESX-bestand bevat extra informatie die Winres.exe gebruikt om een ontwerpversie van het oorspronkelijke formulier opnieuw te maken.

Notitie

Winres.exe kan niet worden gebruikt om het standaardresourcebestand te bewerken. Winres.exe interpreteert alle gewijzigde eigenschappen als gelokaliseerde eigenschappen en slaat deze op in het bronbestand van de doelcultuur.

De definitieve versies van de cultuurresourcebestanden kunnen ten slotte worden gebruikt om gelokaliseerde versies van de toepassing te maken. Zie Resources in .NET-apps voor meer informatie.

Winres.exe heeft de volgende functies en mogelijkheden:

Winres kan worden gebruikt in SFM (Single File Mode) of Visual Studio File Mode (VSFM). SFM is de verouderde modus waarin volledige informatie over het formulier en de inhoud ervan wordt opgeslagen in het bronbestand. VSFM slaat alleen de culturele wijzigingen op in het resourcebestand.
Een venster voor foutrapportage, gekoppeld aan de linkerbenedenhoek van het hoofdvenster.
Sneltoetsen kunnen worden gecontroleerd op duplicaten: klik in het menu Opmaak op de opdracht Sneltoetsen controleren .

Versiecompatibiliteit

Gebruik de versie van Winres.exe die is uitgebracht met de .NET Framework die u gebruikt. De volgende tabel bevat de compatibele versies:

Visual Studio	.NET Framework	Winres.exe
Visual Studio .NET 2002	1.0	1.0
Visual Studio .NET 2003	1.1	1.1
Visual Studio 2005	2,0	2,0
Visual Studio 2008	3.0 en 3.5	3.0 en 3.5
Visual Studio 2010	4,0	4,0
Visual Studio 2017	4,6	4,6

Notitie

Hoewel VSFM het voordeel heeft dat het compatibel is met Visual Studio, omdat het alleen gewijzigde waarden in het resourcebestand opslaat, vereist Winres.exe dat de bovenliggende items van het huidige bronbestand zich in dezelfde map bevinden. Voor het bewerken TestApp.de-DE.resourcesvan een Duits in Duitsland-bronbestand is bijvoorbeeld de aanwezigheid vereist van het standaardbronbestand, TestApp.resx, en mogelijk het cultuurneutrale bronbestand, TestApp.de.resources.

Voorbeelden

Een RESX- of .resources-bestand lokaliseren dat is gekoppeld aan een formulier

Als u Winres.exe wilt uitvoeren, voert u in winres de opdrachtprompt voor ontwikkelaars in.
Als u de standaardresources wilt openen voor een formulier dat moet worden gelokaliseerd, selecteert u Bestand > openen en navigeert u naar het bestand om het te openen.

-of-

Geef het bestand op dat moet worden geopend op de opdrachtregel wanneer u Winres.exe start. Met de volgende opdracht wordt Winres.exe gestart en wordt het formulier geladen dat is TestApp.resx gekoppeld aan in de Formulierontwerper.
```
winres TestApp.resx
```
Met de volgende opdracht wordt Winres.exe gestart en wordt het formulier geladen dat is TestApp.resources gekoppeld aan in de Formulierontwerper.
```
winres TestApp.resources
```
Notitie

Als het formulier waarvan u de resources bewerkt een overgenomen formulier is, moeten zowel de assembly met het overgenomen formulier als de assembly met het overnemende (afgeleide) formulier worden geregistreerd in de Global Assembly Cache (GAC) of moeten ze zich in dezelfde map bevinden als WinRes.exe. Zie Global Assembly Cache voor meer informatie over het installeren van .NET Framework onderdelen in de GAC.
Selecteer besturingselementen op het formulier en wijzig de bijbehorende Text en andere eigenschappen zodat deze overeenkomen met de gelokaliseerde cultuur en de taal. Verplaats of wijzig het formaat van besturingselementen indien nodig om de gelokaliseerde tekst aan te passen.
Als u de gelokaliseerde versie van het .resx- of .resources-bestand wilt opslaan, klikt u op het pictogram Opslaan of selecteert u Bestand > opslaan. Het hulpprogramma geeft het venster Cultuur selecteren weer.
Selecteer de juiste cultuur en bestandsmodus en klik vervolgens op OK.

Het hulpprogramma slaat het bestand op met behulp van de naamconventie die de runtime verwacht voor gelokaliseerde resourcebestanden. Als u bijvoorbeeld voor Duits in Duitsland lokaliseer TestApp.resources , wordt het bestand met het hulpprogramma opgeslagen als TestApp.de-DE.resources. Als u voor Duits in Duitsland lokaliseer TestApp.resx , slaat het hulpprogramma het bestand op als TestApp.de-DE.resx. Zie Resources verpakken en implementeren voor meer informatie over naamconventies voor resources. Zie de klasse voor een lijst met de vooraf gedefinieerde cultuurnamen die door de CultureInfo runtime worden gebruikt.

Delen via