Winres.exe (Lokaliseringsredigeraren för Windows-resurser)

Artikel
05/09/2023

Windows Resource Localization Editor, Winres.exe, är ett visuellt layoutverktyg som hjälper lokaliseringsexperter att lokalisera Windows Forms användargränssnittsresurser (UI) som används av formulär. Du kan skapa .resx - eller .resources-filerna som används som indata för att Winres.exe med hjälp av en visuell designmiljö som Microsoft Visual Studio. Information om hur du distribuerar resurser i .NET Framework program finns i Resurser i .NET-appar.

Winres.exe installeras med Visual Studio. Om du vill köra verktyget använder du Visual Studio Developer Command Prompt eller Visual Studio Developer PowerShell.

Varning

Öppna inte ej betrodda filer med det här verktyget. Om filen är en binär fil kommer den att deserialiseras med binär deserialisering, vilket är osäkert. Mer information finns i Deserialiseringsrisker vid användning av BinaryFormatter och relaterade typer.

Syntax

winres resourceFile
winres /?

Argument

Argument	Description
`resourceFile`	Resursfilen som ska lokaliseras. Den här filen måste vara en Windows Forms formulär .resx- eller .resources-fil som genereras av Visual Studio-designern. Winres.exe kan inte öppna allmänna .resx- eller .resources-filer.

Alternativ	Beskrivning
/?	Visar kommandosyntax och alternativ för verktyget.

Kommentarer

Tillståndet för gränssnittselement från ett formulär i ett Windows Forms projekt lagras vanligtvis i resursfiler, som antingen är XML-baserade filer med tillägget .resx eller motsvarande kompilerade binära versioner med tillägget .resources. Winres.exe är ett verktyg som möjliggör begränsad redigering av någon av filtyperna utanför Visual Studio-designmiljön. Mer specifikt tillåter det följande typer av redigeringsåtgärder:

En neutral eller specifik kulturresursfil kan redigeras för att ändra UI-egenskaperna för formuläret eller dess kontroller, till exempel deras text, storlek eller position.
Neutrala eller specifika kulturresursfiler kan genereras från standardresursfilen.
En kulturresursfil kan sparas som en annan kulturresursfil. En resursfil på engelska (USA) kan till exempel sparas som en polsk resursfil. Normalt redigeras den nya filen senare för att vara kompatibel med den nya kulturen.

Se även Hierarkisk organisation av resurser för lokalisering eller hierarkisk organisation av resurser för lokalisering.

Winres.exe kan inte konvertera en .resx-fil till motsvarande .resources-fil. använd verktyget Resgen.exe i stället. Mer information om Resgen.exe finns iResgen.exe (Resource File Generator).

Winres.exe är ett grafiskt program som återskapar en designtidsversion av ett Windows Forms formulär från bara resursfilen, utan att ha åtkomst till källkoden. Winres.exe är värd för Visual Studio-fönstret Windows Forms Formdesigner och Egenskaper. Dessa funktioner möjliggör visuell redigering av en .resources- eller .resx-fil som innehåller ett Windows Forms formulär. Vanligtvis använder lokaliserare Winres.exe för att redigera kontrolletiketter och justera kontrollernas plats och storlek för att anpassa etiketterna för målkulturen.

Om Winres.exe inte kan matcha typen av kontroll skapas en platshållarkontroll i den lokaliserade .resx- eller .resources-filen. Platshållarkontrollen visas i formuläret Windows Forms som ett kläckt fönster. Storleken och positionen för det kläckta fönstret matchar den faktiska kontrollens. Alla tillgängliga localizable-egenskaper för platshållarkontrollen visas i fönstret Egenskaper . Ändringar som du gör i platshållarkontrollen sparas för den faktiska kontrollen.

Winres.exe jämfört med Visual Studio

Innan du börjar lokalisera ett programs Windows Forms formulär bör du i allmänhet bestämma om du vill använda Visual Studio eller Winres.exe som lokaliseringsverktyg. Versionskompatibilitet, som beskrivs senare, kan hindra dig från att växla från ett verktyg till ett annat.

Fördelen med Visual Studio är att du kan använda det för att både utveckla och lokalisera ett program. Om du vill lokalisera ett formulär när utvecklingen är klar anger du formulärets (egenskapen Localizable i egenskapsredigerarenLocalizableAttribute ) till true och ändrar dess språkegenskap till önskad målkultur. Redigera sedan strängar och justera kontrollernas plats och storlek för att anpassa strängarna för målkulturen. När du sparar den lokaliserade .resx-filen skriver Visual Studio endast de lokaliserade egenskaperna (egenskaper som har ändrats i målkulturen) till filen. Visual Studio skapar automatiskt en satellitsammansättning för den lokaliserade .resx-filen på rätt katalogplats.

Visual Studio tillhandahåller en integrerad utvecklings- och lokaliseringsmiljö, men Winres.exe är det rekommenderade verktyget att använda om lokalisering görs av lokaliserare från tredje part. Eftersom Winres.exe endast är ett lokaliseringsverktyg möjliggör det en renare separation av ett programs kod från de formulär som ska lokaliseras, vilket är mer praktiskt för att hantera stora projekt.

Använda Winres.exe

Om du vill lokalisera med Winres.exe måste du först utveckla ett program med hjälp av en visuell designer som Windows Forms Designer i Visual Studio. När utvecklingen är klar anger du formulärets (egenskapen Localizable i egenskapsredigeraren LocalizableAttribute ) till trueoch lämnar sedan bort .resx-filen för standardkulturen till en localizer från tredje part. Den här .resx-filen innehåller extra information som Winres.exe använder för att återskapa en designtidsversion av det ursprungliga formuläret.

Anteckning

Winres.exe kan inte användas för att redigera standardresursfilen. Winres.exe tolkar alla ändrade egenskaper som lokaliserade egenskaper och sparar dem i målkulturresursfilen.

De slutliga versionerna av kulturresursfilerna kan slutligen användas för att skapa lokaliserade versioner av programmet. Mer information finns i Resurser i .NET-appar.

Winres.exe har följande funktioner:

Winres kan användas i enkelfilsläge (SFM) eller Visual Studio-filläge (VSFM). SFM är det äldre läget där fullständig information om formuläret och dess innehåll lagras i resursfilen. VSFM lagrar endast de kulturella ändringarna i resursfilen.
Ett felrapporteringsfönster som dockas längst ned till vänster i huvudfönstret.
Snabbtangenter kan sökas efter dubbletter: klicka på kommandot Kontrollera HotKeyspå Format-menyn.

Versionskompatibilitet

Du bör använda den version av Winres.exe som släpptes med .NET Framework du använder. I följande tabell visas de kompatibla versionerna:

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 och 3.5	3.0 och 3.5
Visual Studio 2010	4,0	4,0
Visual Studio 2017	4,6	4,6

Anteckning

Även om VSFM har fördelen att vara kompatibelt med Visual Studio, eftersom det bara lagrar ändrade värden i resursfilen, kräver Winres.exe att överordnade till den aktuella resursfilen finns i samma katalog. Om du till exempel redigerar TestApp.de-DE.resources, en tysk i Tyskland-resursfil, krävs förekomsten av standardresursfilen , TestApp.resxoch eventuellt den kulturneutrala resursfilen . TestApp.de.resources

Exempel

Så här lokaliserar du en .resx- eller .resources-fil som är associerad med ett formulär

Om du vill köra Winres.exe anger du winres i kommandotolken för utvecklare.
Om du vill öppna standardresurserna för ett formulär som ska lokaliseras väljer du Öppna fil > och navigerar till filen för att öppna den.

\- eller -

Ange filen som ska öppnas på kommandoraden när du startar Winres.exe. Följande kommando startar Winres.exe och läser in formuläret som är associerat med TestApp.resx i formulärdesignern.
```
winres TestApp.resx
```
Följande kommando startar Winres.exe och läser in formuläret som är associerat med TestApp.resources i formulärdesignern.
```
winres TestApp.resources
```
Anteckning

Om formuläret vars resurser du redigerar är ett ärvt formulär måste både sammansättningen innehålla det ärvda formuläret och sammansättningen som innehåller ärvningsformuläret (härledd) antingen registreras i global sammansättningscache (GAC) eller finnas i samma katalog som WinRes.exe. Mer information om hur du installerar .NET Framework komponenter i GAC finns i Global sammansättningscache.
Välj kontroller i formuläret och ändra deras Text och andra egenskaper så att de återspeglar den lokaliserade kulturen och dess språk. Flytta eller ändra storlek på kontroller efter behov för att anpassa den lokaliserade texten.
Om du vill spara den lokaliserade versionen av .resx- eller .resources-filen klickar du på ikonen Spara eller väljer Spara >fil. Verktyget visar fönstret Välj kultur .
Välj lämplig kultur och filläge och klicka sedan på OK.

Verktyget sparar filen med namngivningskonventionen som körningen förväntar sig för lokaliserade resursfiler. Om du till exempel lokaliserar TestApp.resources för tyska i Tyskland sparar verktyget filen som TestApp.de-DE.resources. Om du lokaliserar TestApp.resx för tyska i Tyskland sparar verktyget filen som TestApp.de-DE.resx. Mer information om namngivningskonventioner för resurser finns i Paketera och distribuera resurser. En lista över fördefinierade kulturnamn som används av körningen finns i CultureInfo klassen .

Dela via