Delen via


Resgen.exe (resourcebestandsgenerator)

De resourcebestandsgenerator (Resgen.exe) converteert tekstbestanden (.txt- of .restext)-bestanden en XML-bestanden (.resx)-bestanden naar binaire bestanden (.resources) van common language Runtime die kunnen worden ingesloten in een binair uitvoerbaar runtimebestand of satellietassembly. Zie Resourcebestanden maken voor meer informatie.

Resgen.exe is een hulpprogramma voor het converteren van algemene resources waarmee de volgende taken worden uitgevoerd:

  • Converteert .txt- of .restext-bestanden naar .resources of .resx-bestanden. (De indeling van .restext-bestanden is identiek aan de indeling van .txt bestanden. Met de extensie .restext kunt u echter gemakkelijker tekstbestanden identificeren die resourcedefinities bevatten.)

  • Converteert .resources-bestanden naar tekst- of .resx-bestanden.

  • Converteert .resx-bestanden naar tekst- of .resources-bestanden.

  • Extraheert de tekenreeksresources uit een assembly in een RESW-bestand dat geschikt is voor gebruik in een Windows 8.x Store-app.

  • Hiermee maakt u een sterk getypte klasse die toegang biedt tot afzonderlijke benoemde resources en tot het ResourceManager exemplaar.

Als Resgen.exe om welke reden dan ook mislukt, is de retourwaarde –1.

Als u hulp wilt krijgen bij Resgen.exe, kunt u de volgende opdracht zonder opgegeven opties gebruiken om de syntaxis van de opdracht en de opties voor Resgen.exe weer te geven:

resgen

U kunt ook de /? schakeloptie gebruiken:

resgen /?

Als u Resgen.exe gebruikt om binaire .resources-bestanden te genereren, kunt u een taalcompilator gebruiken om de binaire bestanden in te sluiten in uitvoerbare assembly's, of u kunt de Assembly Linker (Al.exe) gebruiken om ze te compileren in satellietassembly's.

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

resgen  [-define:symbol1[,symbol2,...]] [/useSourcePath] filename.extension  | /compile filename.extension... [outputFilename.extension] [/r:assembly] [/str:lang[,namespace[,class[,file]]] [/publicclass]]
resgen filename.extension [outputDirectory]

Parameters

Parameter of schakeloptie Beschrijving
/define:symbol1[, symbool2,...] Vanaf .NET Framework 4.5 ondersteunt u voorwaardelijke compilatie in bronbestanden op basis van tekst (.txt of .restext). Als het symbool overeenkomt met een symbool dat is opgenomen in het invoertekstbestand binnen een #ifdef constructie, wordt de bijbehorende tekenreeksresource opgenomen in het .resources-bestand. Als het invoertekstbestand een #if ! instructie bevat met een symbool dat niet is gedefinieerd door de /define schakeloptie, wordt de bijbehorende tekenreeksresource opgenomen in het resourcebestand.

/define wordt genegeerd als deze wordt gebruikt met niet-tekstbestanden. Symbolen zijn hoofdlettergevoelig.

Zie Resources voorwaardelijk compileren verderop in dit onderwerp voor meer informatie over deze optie.
useSourcePath Hiermee geeft u op dat de huidige map van het invoerbestand moet worden gebruikt om relatieve bestandspaden op te lossen.
/compile Hiermee kunt u meerdere .resx- of tekstbestanden opgeven om te converteren naar meerdere .resources-bestanden in één bulkbewerking. Als u deze optie niet opgeeft, kunt u slechts één argument voor het invoerbestand opgeven. Uitvoerbestanden hebben de naam bestandsnaam.resources.

Deze optie kan niet worden gebruikt met de /str: optie.

Zie Compiling or Converting Multiple Files verderop in dit onderwerp voor meer informatie over deze optie.
/r: assembly Verwijst naar metagegevens van de opgegeven assembly. Het wordt gebruikt bij het converteren van .resx-bestanden en staat Resgen.exe toe om objectresources te serialiseren of deserialiseren. Het is vergelijkbaar met de /reference: of /r: opties voor de C#- en Visual Basic-compilers.
filename.extension Hiermee geeft u de naam van het invoerbestand dat moet worden geconverteerd. Als u de eerste, langere opdrachtregelsyntaxis gebruikt die vóór deze tabel wordt weergegeven, extension moet u een van de volgende opties hebben:

.txt of .restext
Een tekstbestand dat moet worden geconverteerd naar een .resources of een RESX-bestand. Tekstbestanden kunnen alleen tekenreeksbronnen bevatten. Zie de sectie Resources in Tekstbestanden van Resourcebestanden maken voor informatie over de bestandsindeling.

.resx
Een op XML gebaseerd resourcebestand dat moet worden geconverteerd naar een .resources of een tekstbestand (.txt of .restext).

bronnen.
Een binair resourcebestand dat moet worden geconverteerd naar een .resx- of een tekstbestand (.txt of .restext).

Als u de tweede, kortere opdrachtregelsyntaxis gebruikt die vóór deze tabel wordt weergegeven, extension moet dit het volgende zijn:

.exe of .dll
Een .NET Framework-assembly (uitvoerbaar bestand of bibliotheek) waarvan de tekenreeksresources moeten worden geëxtraheerd naar een RESW-bestand voor gebruik bij het ontwikkelen van Windows 8.x Store-apps.
outputFilename.extension Hiermee geeft u de naam en het type van het resourcebestand dat moet worden gemaakt.

Dit argument is optioneel bij het converteren van een .txt-, .restext- of .resx-bestand naar een .resources-bestand. Als u dit niet opgeeft outputFilename, voegt Resgen.exe een extensie .resources toe aan de invoer filename en schrijft het bestand naar de map die bevat filename,extension.

Het outputFilename.extension argument is verplicht bij het converteren van een .resources-bestand. Geef een bestandsnaam op met de extensie .resx bij het converteren van een .resources-bestand naar een XML-resourcebestand. Geef een bestandsnaam op met de extensie .txt of .restext bij het converteren van een .resources-bestand naar een tekstbestand. U moet een .resources-bestand alleen converteren naar een .txt-bestand wanneer het .resources-bestand alleen tekenreekswaarden bevat.
outputDirectory Voor Windows 8.x Store-apps geeft u de map op waarin een RESW-bestand met de tekenreeksresources filename.extension wordt geschreven. outputDirectory moet al bestaan.
/str: language[,namespace[,classname[,filename]]] Hiermee maakt u een sterk getypt resourceklassebestand in de programmeertaal die is opgegeven in de language optie. language kan bestaan uit een van de volgende letterlijke waarden:

- Voor C#: c#, csof csharp.
- Voor Visual Basic: vb of visualbasic.
- Voor VBScript: vbs of vbscript.
- Voor C++: c++, mcof cpp.
- Voor JavaScript: js, jscriptof javascript.

De namespace optie specificeert de standaardnaamruimte van het project, de classname optie geeft de naam van de gegenereerde klasse op en de filename optie geeft de naam van het klassebestand op.

De /str: optie staat slechts één invoerbestand toe, dus het kan niet worden gebruikt met de /compile optie.

Als namespace deze is opgegeven maar classname niet, wordt de klassenaam afgeleid van de naam van het uitvoerbestand (onderstrepingstekens worden bijvoorbeeld vervangen door punten). De sterk getypte resources werken mogelijk niet goed als gevolg hiervan. Om dit te voorkomen, geeft u zowel de klassenaam als de naam van het uitvoerbestand op.

Zie Voor meer informatie over deze optie het genereren van een sterk getypte resourceklasse verderop in dit onderwerp.
/publicClass Hiermee maakt u een sterk getypte resourceklasse als een openbare klasse. De resourceklasse bevindt zich internal standaard in C# en Friend in Visual Basic.

Deze optie wordt genegeerd als de /str: optie niet wordt gebruikt.

Resgen.exe en resourcebestandstypen

Om ervoor te zorgen dat Resgen.exe resources kan converteren, moeten tekst- en RESX-bestanden de juiste indeling hebben.

Tekstbestanden (.txt en .restext)

Tekstbestanden (.txt of .restext) mogen alleen tekenreeksresources bevatten. Tekenreeksresources zijn handig als u een toepassing schrijft waarvoor tekenreeksen moeten zijn vertaald in verschillende talen. U kunt bijvoorbeeld eenvoudig menutekenreeksen regionaliseren met behulp van de juiste tekenreeksresource. Resgen.exe tekstbestanden leest die naam-/waardeparen bevatten, waarbij de naam een tekenreeks is die de resource beschrijft en de waarde de resourcereeks zelf is.

Een tekstbestand met resources moet worden opgeslagen met UTF-8- of Unicode-codering (UTF-16), tenzij het alleen tekens bevat in het Latijnse basisbereik (naar U+007F). Resgen.exe verwijdert uitgebreide ANSI-tekens wanneer een tekstbestand wordt verwerkt dat wordt opgeslagen met ANSI-codering.

Resgen.exe controleert het tekstbestand op dubbele resourcenamen. Als het tekstbestand dubbele resourcenamen bevat, verzendt Resgen.exe een waarschuwing en negeert u de tweede waarde.

.resx-bestanden

De .resx-resourcebestandsindeling bestaat uit XML-vermeldingen. U kunt tekenreeksbronnen in deze XML-vermeldingen opgeven, net zoals in tekstbestanden. Een belangrijk voordeel van .resx-bestanden ten opzichte van tekstbestanden is dat u ook objecten kunt opgeven of insluiten. Wanneer u een RESX-bestand bekijkt, ziet u de binaire vorm van een ingesloten object (bijvoorbeeld een afbeelding) wanneer deze binaire informatie deel uitmaakt van het resourcemanifest. Net als bij tekstbestanden kunt u een RESX-bestand openen met een teksteditor (zoals Kladblok of Microsoft Word) en de inhoud ervan schrijven, parseren en bewerken. Houd er rekening mee dat dit een goede kennis van XML-tags en de RESX-bestandsstructuur vereist. Zie de sectie Resources in .resx Files van resourcebestanden maken voor meer informatie over de .resx-bestandsindeling.

Als u een .resources-bestand wilt maken dat ingesloten niet-tekenreeksobjecten bevat, moet u Resgen.exe gebruiken om een RESX-bestand met objecten te converteren of de objectresources rechtstreeks vanuit code toe te voegen aan uw bestand door de methoden van de ResourceWriter klasse aan te roepen.

Als uw .resx- of .resources-bestand objecten bevat en u Resgen.exe gebruikt om het te converteren naar een tekstbestand, worden alle tekenreeksresources correct geconverteerd, maar worden de gegevenstypen van de niet-tekenreeksobjecten ook als tekenreeksen naar het bestand geschreven. U verliest de ingesloten objecten in de conversie en Resgen.exe meldt dat er een fout is opgetreden bij het ophalen van de resources.

Converteren tussen resourcebestandstypen

Wanneer u converteert tussen verschillende resourcebestandstypen, kan Resgen.exe de conversie mogelijk niet uitvoeren of kan er informatie over specifieke resources verloren gaan, afhankelijk van de bron- en doelbestandstypen. In de volgende tabel worden de typen conversies opgegeven die succesvol zijn bij het converteren van het ene bronbestandstype naar het andere.

Converteren van Naar tekstbestand Naar .resx-bestand Naar .resw-bestand Naar .resources-bestand
Tekstbestand (.txt of .restext) -- Geen problemen Niet ondersteund Geen problemen
.resx-bestand Conversie mislukt als het bestand niet-tekenreeksbronnen bevat (inclusief bestandskoppelingen) -- Niet ondersteund* Geen problemen
.resources-bestand Conversie mislukt als het bestand niet-tekenreeksbronnen bevat (inclusief bestandskoppelingen) Geen problemen Niet ondersteund --
.exe of .dll assembly Niet ondersteund Niet ondersteund Alleen tekenreeksbronnen (inclusief padnamen) worden herkend als resources Niet ondersteund

*In Windows 8.x Store-apps gebruikt u .resw-bestanden om resources te maken. Ondanks het verschil in de bestandsextensie is de .resw-bestandsindeling identiek aan de .resx-bestandsindeling, behalve dat .resw-bestanden alleen tekenreeksen en bestandspaden kunnen bevatten. U kunt .resx-bestanden die alleen tekenreeksen en bestandspaden bevatten, converteren naar .resw-bestanden door simpelweg de bestandsextensie te wijzigen.

Specifieke Resgen.exe-taken uitvoeren

U kunt Resgen.exe op verschillende manieren gebruiken: om een op tekst gebaseerd of XML-resourcebestand te compileren in een binair bestand, om te converteren tussen resourcebestandsindelingen en om een klasse te genereren die functionaliteit terugloopt ResourceManager en toegang biedt tot resources. In deze sectie vindt u gedetailleerde informatie over elke taak:

Resources compileren in een binair bestand

Het meest voorkomende gebruik van Resgen.exe is het compileren van een op tekst gebaseerd resourcebestand (een .txt- of .restext-bestand) of een XML-resourcebestand (een RESX-bestand) in een binair .resources-bestand. Het uitvoerbestand kan vervolgens worden ingesloten in een hoofdassembly door een taalcompilator of in een satellietassembly door Assembly Linker (AL.exe).

De syntaxis voor het compileren van een resourcebestand is:

resgen inputFilename [outputFilename]

waarbij de parameters zijn:

inputFilename De bestandsnaam, inclusief de extensie, van het resourcebestand dat moet worden gecompileerd. Resgen.exe compileert alleen bestanden met extensies van .txt, .restext of .resx.

outputFilename De naam van het uitvoerbestand. Als u weglaat outputFilename, Resgen.exe maakt u een .resources-bestand met de naam van inputFilename het hoofdbestand in dezelfde map als inputFilename. Als outputFilename dit een mappad bevat, moet de map bestaan.

U geeft een volledig gekwalificeerde naamruimte op voor het .resources-bestand door het op te geven in de bestandsnaam en deze te scheiden van de hoofdbestandsnaam door een punt. Als dat het bijvoorbeeld outputFilename is MyCompany.Libraries.Strings.resources, is de naamruimte MyCompany.Libraries.

De volgende opdracht leest de naam/waardeparen in Resources.txt en schrijft een binair .resources-bestand met de naam Resources.resources. Omdat de naam van het uitvoerbestand niet expliciet is opgegeven, ontvangt het standaard dezelfde naam als het invoerbestand.

resgen Resources.txt

De volgende opdracht leest de naam/waardeparen in Resources.restext en schrijft een binair resourcesbestand met de naam StringResources.resources.

resgen Resources.restext StringResources.resources

Met de volgende opdracht wordt een op XML gebaseerd invoerbestand met de naam Resources.resx gelezen en wordt een binair .resources-bestand met de naam Resources.resources geschreven.

resgen Resources.resx Resources.resources

Converteren tussen resourcebestandstypen

Naast het compileren van bronbestanden op basis van tekst of XML in binaire .resources-bestanden, kan Resgen.exe elk ondersteund bestandstype converteren naar elk ander ondersteund bestandstype. Dit betekent dat de volgende conversies kunnen worden uitgevoerd:

  • .txt- en .restext-bestanden naar .resx-bestanden.

  • .resx-bestanden voor .txt- en .restext-bestanden.

  • .resources-bestanden voor .txt- en .restext-bestanden.

  • .resources-bestanden naar .resx-bestanden.

De syntaxis is hetzelfde als die in de vorige sectie.

Daarnaast kunt u Resgen.exe gebruiken om ingesloten resources in een .NET Framework-assembly te converteren naar een RESW-bestand voor Windows 8.x Store-apps.

Met de volgende opdracht wordt een binair resources-bestand Resources.resources gelezen en wordt een op XML gebaseerd uitvoerbestand met de naam Resources.resx geschreven.

resgen Resources.resources Resources.resx

Met de volgende opdracht wordt een bestand met tekstresources met de naam StringResources.txt gelezen en wordt een xml-resourcesbestand met de naam LibraryResources.resx geschreven. Naast het bevatten van tekenreeksresources kan het RESX-bestand ook worden gebruikt om niet-tekenreeksresources op te slaan.

resgen StringResources.txt LibraryResources.resx

De volgende twee opdrachten lezen een xml-resourcesbestand met de naam Resources.resx en schrijf tekstbestanden met de naam Resources.txt en Resources.restext. Als het RESX-bestand ingesloten objecten bevat, worden ze niet nauwkeurig geconverteerd naar de tekstbestanden.

resgen Resources.resx Resources.txt
resgen Resources.resx Resources.restext

Meerdere bestanden compileren of converteren

U kunt de /compile schakeloptie gebruiken om een lijst met resourcebestanden van de ene indeling naar de andere te converteren in één bewerking. De syntaxis is:

resgen /compile filename.extension [filename.extension...]

Met de volgende opdracht worden drie bestanden, StringResources.txt, TableResources.resw en ImageResources.resw, gecompileerd in afzonderlijke .resources-bestanden met de naam StringResources.resources, TableResources.resources en ImageResources.resources.

resgen /compile StringResources.txt TableResources.resx ImageResources.resx

Resources exporteren naar een .resw-bestand

Als u een Windows 8.x Store-app ontwikkelt, kunt u resources van een bestaande desktop-app gebruiken. De twee soorten toepassingen ondersteunen echter verschillende bestandsindelingen. In bureaublad-apps worden resources in tekst (.txt of .restext) of .resx-bestanden gecompileerd in binaire .resources-bestanden. In Windows 8.x Store-apps worden RESW-bestanden gecompileerd in PRI-bestanden (Binary Package Resource Index). U kunt Resgen.exe gebruiken om deze kloof te overbruggen door resources te extraheren uit een uitvoerbaar bestand of een satellietassembly en deze te schrijven naar een of meer .resw-bestanden die kunnen worden gebruikt bij het ontwikkelen van een Windows 8.x Store-app.

Belangrijk

Visual Studio verwerkt automatisch alle conversies die nodig zijn voor het opnemen van de resources in een draagbare bibliotheek in een Windows 8.x Store-app. Het gebruik van Resgen.exe rechtstreeks om de resources in een assembly te converteren naar .resw-bestandsindeling is alleen interessant voor ontwikkelaars die een Windows 8.x Store-app buiten Visual Studio willen ontwikkelen.

De syntaxis voor het genereren van .resw-bestanden van een assembly is:

resgen filename.extension  [outputDirectory]

waarbij de parameters zijn:

filename.extension De naam van een .NET Framework-assembly (een uitvoerbaar bestand of .DLL). Als het bestand geen resources bevat, maakt Resgen.exe geen bestanden.

outputDirectory De bestaande map waarnaar de RESW-bestanden moeten worden geschreven. Als outputDirectory u dit weglaat, worden .resw-bestanden naar de huidige map geschreven. Resgen.exe maakt één RESW-bestand voor elk .resources-bestand in de assembly. De hoofdbestandsnaam van het RESW-bestand is hetzelfde als de hoofdnaam van het .resources-bestand.

Met de volgende opdracht maakt u een RESW-bestand in de map Win8Resources voor elk .resources-bestand dat is ingesloten in MyApp.exe:

resgen MyApp.exe Win8Resources

Resources voorwaardelijk compileren

Vanaf .NET Framework 4.5 ondersteunt Resgen.exe voorwaardelijke compilatie van tekenreeksresources in tekstbestanden (.txt en .restext). Hiermee kunt u één resourcebestand op basis van tekst gebruiken in meerdere buildconfiguraties.

In een .txt- of .restext-bestand gebruikt u de #ifdef...#endif construct to include a resource in the binary .resources file if a symbol is defined, and you use the #if !... #endif construct to include a resource if a symbol not defined. Tijdens het compileren definieert u symbolen met behulp van de /define: optie gevolgd door een door komma's gescheiden lijst met symbolen. De vergelijking is hoofdlettergevoelig. Het geval van symbolen die zijn gedefinieerd door /define , moet overeenkomen met het geval van symbolen in de tekstbestanden die moeten worden gecompileerd.

Het volgende bestand met de naam UIResources.text bevat bijvoorbeeld een tekenreeksresource met de naam AppTitle drie waarden, afhankelijk van of symbolen met de naam PRODUCTION, CONSULTof RETAIL zijn gedefinieerd.

#ifdef PRODUCTION
AppTitle=My Software Company Project Manager
#endif
#ifdef CONSULT
AppTitle=My Consulting Company Project Manager
#endif
#ifdef RETAIL
AppTitle=My Retail Store Project Manager
#endif
FileMenuName=File

Het bestand kan vervolgens worden gecompileerd in een binair .resources-bestand met de volgende opdracht:

resgen /define:CONSULT UIResources.restext

Dit produceert een .resources-bestand dat twee tekenreeksbronnen bevat. De waarde van de AppTitle resource is 'My Consulting Company Project Manager'.

Een sterk getypte resourceklasse genereren

Resgen.exe ondersteunt sterk getypte resources, die de toegang tot resources inkapselen door klassen te maken die een set statische alleen-lezeneigenschappen bevatten. Dit biedt een alternatief voor het rechtstreeks aanroepen van de methoden van de ResourceManager klasse om resources op te halen. U kunt sterk getypte resourceondersteuning inschakelen met behulp van de /str optie in Resgen.exe, waarmee de functionaliteit van de StronglyTypedResourceBuilder klasse wordt verpakt. Wanneer u de /str optie opgeeft, is de uitvoer van Resgen.exe een klasse die sterk getypte eigenschappen bevat die overeenkomen met de resources waarnaar wordt verwezen in de invoerparameter. Deze klasse biedt sterk getypte alleen-lezentoegang tot de resources die beschikbaar zijn in het verwerkte bestand.

De syntaxis voor het maken van een sterk getypte resource is:

resgen inputFilename [outputFilename] /str:language[,namespace,[classname[,filename]]] [/publicClass]

De parameters en schakelopties zijn:

inputFilename De bestandsnaam, inclusief de extensie, van het resourcebestand waarvoor een sterk getypte resourceklasse moet worden gegenereerd. Het bestand kan een bestand op basis van tekst, XML of binaire .resources zijn; het kan een uitbreiding hebben van .txt, .restext, .resw of .resources.

outputFilename De naam van het uitvoerbestand. Als outputFilename dit een mappad bevat, moet de map bestaan. Als u weglaat outputFilename, Resgen.exe maakt u een .resources-bestand met de naam van inputFilename het hoofdbestand in dezelfde map als inputFilename.

outputFilename kan een bestand met tekst, XML of binaire .resources zijn. Als de bestandsextensie outputFilename verschilt van de bestandsextensie van inputFilename, Resgen.exe voert de bestandsconversie uit.

Als inputFilename dit een .resources-bestand is, kopieert Resgen.exe het .resources-bestand als outputFilename dat ook een .resources-bestand is. Als outputFilename u dit weglaat, wordt Resgen.exe overschreven inputFilename met een identiek .resources-bestand.

taal De taal waarin broncode moet worden gegenereerd voor de sterk getypte resourceklasse. Mogelijke waarden zijncs, C#en csharp voor C#-codevb, en visualbasic voor Visual Basic-code, vbs en vbscript voor VBScript-code, en c++mcvoor cpp C++-code.

naamruimte De naamruimte die de sterk getypte resourceklasse bevat. Het .resources-bestand en de resourceklasse moeten dezelfde naamruimte hebben. Zie Resources compileren in een binair bestand voor meer informatie over het opgeven van de naamruimte in de outputFilenamenaamruimte. Als u een naamruimte weglaat, bevindt de resourceklasse zich niet in een naamruimte.

klassenaam De naam van de sterk getypte resourceklasse. Dit moet overeenkomen met de hoofdnaam van het .resources-bestand. Als Resgen.exe bijvoorbeeld een .resources-bestand genereert met de naam MyCompany.Libraries.Strings.resources, is de naam van de sterk getypte resourceklasse Tekenreeksen. Als klassenaam wordt weggelaten, wordt de gegenereerde klasse afgeleid van de hoofdnaam van outputFilename. Als outputFilename u dit weglaat, wordt de gegenereerde klasse afgeleid van de hoofdnaam van inputFilename.

klassenaam mag geen ongeldige tekens bevatten, zoals ingesloten spaties. Als klassenaam ingesloten spaties bevat of als klassenaam standaard wordt gegenereerd op basis van inputFilename en inputFilename ingesloten spaties bevat, vervangt Resgen.exe alle ongeldige tekens door een onderstrepingsteken (_).

bestandsnaam De naam van het klassebestand.

/publicclass Hiermee maakt u de sterk getypte resourceklasse openbaar in plaats internal van (in C#) of Friend (in Visual Basic). Hierdoor kunnen de resources worden geopend van buiten de assembly waarin ze zijn ingesloten.

Belangrijk

Wanneer u een sterk getypte resourceklasse maakt, moet de naam van het .resources-bestand overeenkomen met de naamruimte en klassenaam van de gegenereerde code. Met Resgen.exe kunt u echter opties opgeven waarmee een .resources-bestand met een incompatibele naam wordt geproduceerd. Als u dit gedrag wilt omzeilen, wijzigt u de naam van het uitvoerbestand nadat het is gegenereerd.

De sterk getypte resourceklasse heeft de volgende leden:

  • Een parameterloze constructor, die kan worden gebruikt om de sterk getypte resourceklasse te instantiëren.

  • Een static (C#) of Shared (Visual Basic) en de alleen-lezen ResourceManager eigenschap, die het ResourceManager exemplaar retourneert dat de sterk getypte resource beheert.

  • Een statische Culture eigenschap waarmee u de cultuur kunt instellen die wordt gebruikt voor het ophalen van resources. De waarde is nullstandaard, wat betekent dat de huidige UI-cultuur wordt gebruikt.

  • Eén static (C#) of Shared (Visual Basic) en alleen-lezen eigenschap voor elke resource in het .resources-bestand. De naam van de eigenschap is de naam van de resource.-

Met de volgende opdracht wordt bijvoorbeeld een resourcebestand met de naam StringResources.txt gecompileerd in StringResources.resources en wordt een klasse gegenereerd met de naam StringResources in een Visual Basic-broncodebestand met de naam StringResources.vb dat kan worden gebruikt voor toegang tot Resource Manager.

resgen StringResources.txt /str:vb,,StringResources

Zie ook