Udostępnij przez

Resgen.exe (generator plików zasobów)

Generator plików zasobów (Resgen.exe) konwertuje pliki tekstowe (.txt lub restext) i pliki formatu zasobów opartego na formacie XML (resx) na pliki binarne środowiska uruchomieniowego języka wspólnego (.resources), które mogą być osadzone w pliku wykonywalnym binarnym środowiska uruchomieniowego lub zestawie satelitarnym. Aby uzyskać więcej informacji, zobacz Tworzenie plików zasobów.

Resgen.exe to narzędzie konwersji zasobów ogólnego przeznaczenia, które wykonuje następujące zadania:

  • Konwertuje pliki .txt lub restext na pliki resources lub resx. (Format plików restext jest identyczny z formatem plików .txt. Jednak rozszerzenie restext ułatwia identyfikowanie plików tekstowych zawierających definicje zasobów).

  • Konwertuje pliki resources na pliki tekstowe lub resx.

  • Konwertuje pliki resx na pliki tekstowe lub pliki resources.

  • Wyodrębnia zasoby ciągów z zestawu do pliku resw, który jest odpowiedni do użycia w aplikacji ze Sklepu Windows 8.x.

  • Tworzy silnie typizowana klasę, która zapewnia dostęp do poszczególnych nazwanych zasobów i ResourceManager wystąpienia.

Jeśli Resgen.exe nie powiedzie się z jakiegokolwiek powodu, zwracana wartość to -1.

Aby uzyskać pomoc dotyczącą Resgen.exe, możesz użyć następującego polecenia bez określonych opcji, aby wyświetlić składnię poleceń i opcje dla Resgen.exe:

resgen

Możesz również użyć przełącznika /? :

resgen /?

Jeśli używasz Resgen.exe do generowania plików binarnych zasobów, możesz użyć kompilatora języka, aby osadzić pliki binarne w zestawach wykonywalnych lub użyć konsolidatora zestawów (Al.exe), aby skompilować je w zestawy satelitarne.

To narzędzie jest instalowane automatycznie w programie Visual Studio. Aby uruchomić narzędzie, użyj wiersza polecenia dla deweloperów programu Visual Studio lub programu Visual Studio Developer PowerShell.

W wierszu polecenia wpisz następujące polecenie:

Składnia

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

resgen filename.extension [outputDirectory]

Parametry

Parametr lub przełącznik Description
/define: symbol1[, symbol2,...] Począwszy od programu .NET Framework 4.5, obsługuje kompilację warunkową w plikach zasobów opartych na tekście (.txt lub restext). Jeśli symbol odpowiada symbolowi zawartemu w pliku tekstowym wejściowym #ifdef w konstrukcji, skojarzony zasób ciągu jest uwzględniony w pliku resources. Jeśli wejściowy plik tekstowy zawiera instrukcję #if ! z symbolem, który nie jest zdefiniowany przez /define przełącznik, skojarzony zasób ciągu jest uwzględniony w pliku zasobów.

/define jest ignorowany, jeśli jest używany z plikami nietekstowymi. W symbolach jest rozróżniana wielkość liter.

Aby uzyskać więcej informacji na temat tej opcji, zobacz Temat Warunkowe kompilowanie zasobów w dalszej części tego tematu.
useSourcePath Określa, że bieżący katalog pliku wejściowego ma być używany do rozpoznawania względnych ścieżek plików.
/compile Umożliwia określenie wielu plików resx lub plików tekstowych w celu konwersji na wiele plików resources w ramach jednej operacji zbiorczej. Jeśli nie określisz tej opcji, możesz określić tylko jeden argument pliku wejściowego. Pliki wyjściowe mają nazwę nazwa_pliku.resources.

Tej opcji nie można użyć z opcją /str: .

Aby uzyskać więcej informacji na temat tej opcji, zobacz Kompilowanie lub konwertowanie wielu plików w dalszej części tego tematu.
/r: assembly Odwołuje się do metadanych z określonego zestawu. Jest on używany podczas konwertowania plików resx i umożliwia Resgen.exe serializacji lub deserializacji zasobów obiektów. Jest on podobny do /reference: opcji lub /r: dla kompilatorów języka C# i Visual Basic.
filename.extension Określa nazwę pliku wejściowego do przekonwertowania. Jeśli używasz pierwszej, bardziej długiej składni wiersza polecenia przedstawionej przed tą tabelą extension , musi być jedną z następujących wartości:

.txt lub .restext
Plik tekstowy do konwersji na plik resources lub resx. Pliki tekstowe mogą zawierać tylko zasoby ciągów. Aby uzyskać informacje o formacie pliku, zobacz sekcję "Zasoby w plikach tekstowych" w sekcji Tworzenie plików zasobów.

Resx
Plik zasobów oparty na formacie XML do konwersji na plik resources lub tekst (.txt lub plik restext).

.zasoby
Plik zasobu binarnego do konwersji na plik resx lub tekst (.txt lub restext).

Jeśli używasz drugiej, krótszej składni wiersza polecenia przedstawionej przed tą tabelą, extension musi być następująca:

.exe lub .dll
Zestaw .NET Framework (plik wykonywalny lub biblioteka), którego zasoby ciągów mają zostać wyodrębnione do pliku resw do użycia w programach aplikacji ze Sklepu Windows 8.x.
outputFilename.extension Określa nazwę i typ pliku zasobu do utworzenia.

Ten argument jest opcjonalny podczas konwertowania z pliku .txt, restext lub resx na plik resources. Jeśli nie określisz outputFilenameparametru , Resgen.exe dołącza rozszerzenie resources do danych wejściowych filename i zapisuje plik w katalogu zawierającym filename,extension.

Argument outputFilename.extension jest obowiązkowy podczas konwertowania z pliku resources. Określ nazwę pliku z rozszerzeniem resx podczas konwertowania pliku resources na plik zasobów oparty na formacie XML. Określ nazwę pliku z rozszerzeniem .txt lub restext podczas konwertowania pliku resources na plik tekstowy. Plik resources należy przekonwertować na plik .txt tylko wtedy, gdy plik resources zawiera tylko wartości ciągu.
outputDirectory W przypadku aplikacji ze Sklepu Windows 8.x określa katalog, w którym zostanie zapisany plik resw zawierający zasoby filename.extension ciągów. outputDirectory musi już istnieć.
/str: language[,namespace[,classname[,filename]]] Tworzy silnie typizowanego pliku klasy zasobów w języku programowania określonym w language tej opcji. language może składać się z jednego z następujących literałów:

- Dla języka C#: c#, cslub csharp.
— Dla języka Visual Basic: vb lub visualbasic.
— w przypadku języka VBScript: vbs lub vbscript.
- Dla języka C++: c++, mclub cpp.
— Dla języka JavaScript: js, jscriptlub javascript.

Opcja namespace określa domyślną przestrzeń nazw projektu, classname opcja określa nazwę wygenerowanej klasy, a filename opcja określa nazwę pliku klasy.

Opcja /str: zezwala tylko na jeden plik wejściowy, więc nie może być używana z opcją /compile .

Jeśli namespace jest określony, ale classname nie, nazwa klasy pochodzi z nazwy pliku wyjściowego (na przykład podkreślenia są zastępowane kropkami). W rezultacie silnie typizowane zasoby mogą nie działać poprawnie. Aby tego uniknąć, określ zarówno nazwę klasy, jak i nazwę pliku wyjściowego.

Aby uzyskać więcej informacji na temat tej opcji, zobacz Generowanie silnie typizowanej klasy zasobów w dalszej części tego tematu.
/publicClass Tworzy silnie typizowana klasę zasobów jako klasę publiczną. Domyślnie klasa zasobów jest internal w języku C# i Friend w Visual Basic.

Ta opcja jest ignorowana, jeśli /str: opcja nie jest używana.

typy plików Resgen.exe i zasobów

Aby Resgen.exe pomyślnie przekonwertować zasoby, pliki tekstowe i resx muszą być zgodne z poprawnym formatem.

Pliki tekstowe (.txt i restext)

Pliki tekstowe (.txt lub restext) mogą zawierać tylko zasoby ciągów. Zasoby ciągów są przydatne, jeśli piszesz aplikację, która musi mieć ciągi przetłumaczone na kilka języków. Na przykład można łatwo regionalizować ciągi menu przy użyciu odpowiedniego zasobu ciągu. Resgen.exe odczytuje pliki tekstowe zawierające pary nazwa/wartość, gdzie nazwa jest ciągiem opisujący zasób, a wartość jest samym ciągiem zasobu.

Uwaga / Notatka

Aby uzyskać informacje o formacie plików .txt i restext, zobacz sekcję "Zasoby w plikach tekstowych" w sekcji Tworzenie plików zasobów.

Plik tekstowy zawierający zasoby musi zostać zapisany przy użyciu kodowania UTF-8 lub Unicode (UTF-16), chyba że zawiera tylko znaki w zakresie łacińskim (do U+007F). Resgen.exe usuwa rozszerzone znaki ANSI podczas przetwarzania pliku tekstowego zapisanego przy użyciu kodowania ANSI.

Resgen.exe sprawdza plik tekstowy pod kątem zduplikowanych nazw zasobów. Jeśli plik tekstowy zawiera zduplikowane nazwy zasobów, Resgen.exe będzie emitować ostrzeżenie i ignorować drugą wartość.

Pliki resx

Format pliku zasobów resx składa się z wpisów XML. Zasoby ciągów można określić w tych wpisach XML, tak jak w plikach tekstowych. Główną zaletą plików resx w plikach tekstowych jest to, że można również określać lub osadzać obiekty. Podczas wyświetlania pliku resx można zobaczyć postać binarną obiektu osadzonego (na przykład obrazu), gdy te informacje binarne są częścią manifestu zasobu. Podobnie jak w przypadku plików tekstowych, można otworzyć plik resx za pomocą edytora tekstów (takiego jak Notatnik lub Microsoft Word) i zapisywać, analizować i manipulować jego zawartością. Należy pamiętać, że wymaga to dobrej wiedzy na temat tagów XML i struktury plików resx. Aby uzyskać więcej informacji na temat formatu pliku resx, zobacz sekcję "Zasoby w plikach resx" w sekcji Tworzenie plików zasobów.

Aby utworzyć plik resources zawierający osadzone obiekty nieciągające, należy użyć Resgen.exe, aby przekonwertować plik resx zawierający obiekty lub dodać zasoby obiektów do pliku bezpośrednio z kodu przez wywołanie metod dostarczonych przez klasę ResourceWriter .

Jeśli plik resx lub resources zawiera obiekty i użyjesz Resgen.exe, aby przekonwertować go na plik tekstowy, wszystkie zasoby ciągów zostaną poprawnie przekonwertowane, ale typy danych obiektów nieciągujących również zostaną zapisane w pliku jako ciągi. Obiekty osadzone zostaną utracone podczas konwersji, a Resgen.exe zgłosi błąd podczas pobierania zasobów.

Konwertowanie między typami plików zasobów

Podczas konwertowania między różnymi typami plików zasobów Resgen.exe może nie być w stanie wykonać konwersji lub utracić informacje o określonych zasobach, w zależności od typów plików źródłowych i docelowych. W poniższej tabeli przedstawiono typy konwersji, które są pomyślne podczas konwertowania z jednego typu pliku zasobu na inny.

Konwertuj z Do pliku tekstowego Do pliku resx Do pliku resw Do pliku resources
Plik tekstowy (.txt lub restext) -- Brak problemów Niewspierane Brak problemów
Plik resx Konwersja kończy się niepowodzeniem, jeśli plik zawiera zasoby inne niż ciągi (w tym linki do plików) -- Nieobsługiwane* Brak problemów
Plik resources Konwersja kończy się niepowodzeniem, jeśli plik zawiera zasoby inne niż ciągi (w tym linki do plików) Brak problemów Niewspierane --
zestaw .exe lub .dll Niewspierane Niewspierane Tylko zasoby ciągów (w tym nazwy ścieżek) są rozpoznawane jako zasoby Niewspierane

*W aplikacjach ze Sklepu Windows 8.x pliki resw służą do tworzenia zasobów. Pomimo różnicy w rozszerzeniu pliku format pliku resw jest identyczny z formatem pliku resx, z tą różnicą, że pliki resw mogą zawierać tylko ciągi i ścieżki plików. Pliki resx zawierające tylko ciągi i ścieżki plików można przekonwertować na pliki resw, zmieniając rozszerzenie pliku.

Wykonywanie określonych zadań Resgen.exe

Można użyć Resgen.exe na różne sposoby: aby skompilować plik zasobów oparty na tekście lub xml do pliku binarnego, przekonwertować między formatami plików zasobów i wygenerować klasę, która opakowuje ResourceManager funkcje i zapewnia dostęp do zasobów. Ta sekcja zawiera szczegółowe informacje o każdym zadaniu:

Kompilowanie zasobów w pliku binarnym

Najczęstszym zastosowaniem Resgen.exe jest skompilowanie pliku zasobów opartego na tekście (.txt lub pliku restext) lub pliku zasobów opartego na formacie XML (pliku resx) do binarnego pliku resources. Plik wyjściowy można następnie osadzać w zestawie głównym przez kompilator języka lub w zestawie satelitarnym przez assembly Assembly Linker (AL.exe).

Składnia do skompilowania pliku zasobu to:

resgen inputFilename [outputFilename]

gdzie parametry to:

inputFilename Nazwa pliku, w tym rozszerzenie, pliku zasobu do skompilowania. Resgen.exe kompiluje tylko pliki z rozszerzeniami .txt, .restext lub resx.

outputFilename Nazwa pliku wyjściowego. Jeśli pominięto outputFilenamepolecenie , Resgen.exe utworzy plik resources z nazwą inputFilename pliku głównego w tym samym katalogu co inputFilename. Jeśli outputFilename zawiera ścieżkę katalogu, katalog musi istnieć.

Należy podać w pełni kwalifikowaną przestrzeń nazw dla pliku resources, określając ją w nazwie pliku i oddzielając ją od nazwy pliku głównego kropką. Jeśli na przykład to MyCompany.Libraries.Strings.resources, outputFilename przestrzeń nazw to MyCompany.Libraries.

Następujące polecenie odczytuje pary nazwa/wartość w Resources.txt i zapisuje binarny plik resources o nazwie Resources.resources. Ponieważ nazwa pliku wyjściowego nie jest określona jawnie, domyślnie otrzymuje taką samą nazwę jak plik wejściowy.

resgen Resources.txt

Następujące polecenie odczytuje pary name/value w pliku Resources.restext i zapisuje plik zasobów binarnych o nazwie StringResources.resources.

resgen Resources.restext StringResources.resources

Następujące polecenie odczytuje plik wejściowy oparty na formacie XML o nazwie Resources.resx i zapisuje binarny plik resources o nazwie Resources.resources.

resgen Resources.resx Resources.resources

Konwertowanie między typami plików zasobów

Oprócz kompilowania plików zasobów opartych na tekście lub XML do binarnych plików resources, Resgen.exe może przekonwertować dowolny obsługiwany typ pliku na inny obsługiwany typ pliku. Oznacza to, że może wykonać następujące konwersje:

  • .txt i pliki restext do plików resx.

  • Pliki resx do plików .txt i restext.

  • Pliki resources do plików .txt i restext.

  • Pliki resources do plików resx.

Składnia jest taka sama jak pokazana w poprzedniej sekcji.

Ponadto można użyć Resgen.exe do konwertowania zasobów osadzonych w zestawie .NET Framework na plik resw dla aplikacji ze Sklepu Windows 8.x.

Następujące polecenie odczytuje plik zasobów binarnych Resources.resources i zapisuje plik wyjściowy oparty na formacie XML o nazwie Resources.resx.

resgen Resources.resources Resources.resx

Następujące polecenie odczytuje plik zasobów oparty na tekście o nazwie StringResources.txt i zapisuje plik zasobów opartych na formacie XML o nazwie LibraryResources.resx. Oprócz zawierania zasobów ciągów plik resx może być również używany do przechowywania zasobów innych niż ciąg.

resgen StringResources.txt LibraryResources.resx

Następujące dwa polecenia odczytują plik zasobów oparty na formacie XML o nazwie Resources.resx i zapisują pliki tekstowe o nazwach Resources.txt i Resources.restext. Należy pamiętać, że jeśli plik resx zawiera jakiekolwiek obiekty osadzone, nie zostaną dokładnie przekonwertowane na pliki tekstowe.

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

Kompilowanie lub konwertowanie wielu plików

Możesz użyć przełącznika /compile , aby przekonwertować listę plików zasobów z jednego formatu na inny w ramach jednej operacji. Składnia jest następująca:

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

Następujące polecenie kompiluje trzy pliki, StringResources.txt, TableResources.resw i ImageResources.resw, w oddzielne pliki zasobów o nazwach StringResources.resources, TableResources.resources i ImageResources.resources.

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

Eksportowanie zasobów do pliku resw

Jeśli tworzysz aplikację ze Sklepu Windows 8.x, możesz chcieć użyć zasobów z istniejącej aplikacji klasycznej. Jednak dwa rodzaje aplikacji obsługują różne formaty plików. W aplikacjach klasycznych zasoby w tekście (.txt lub restext) lub pliki resx są kompilowane w binarnych plikach resources. W aplikacjach ze Sklepu Windows 8.x pliki resw są kompilowane w plikach indeksu zasobów pakietu binarnego (PRI). Możesz użyć Resgen.exe, aby wypełnić tę lukę, wyodrębniając zasoby z pliku wykonywalnego lub zestawu satelitarnego i zapisując je do co najmniej jednego pliku resw, który może być używany podczas tworzenia aplikacji ze Sklepu Windows 8.x.

Ważne

Program Visual Studio automatycznie obsługuje wszystkie konwersje niezbędne do włączenia zasobów w bibliotece przenośnej do aplikacji ze Sklepu Windows 8.x. Używanie Resgen.exe bezpośrednio do konwertowania zasobów w zestawie na format pliku resw jest interesujące tylko dla deweloperów, którzy chcą utworzyć aplikację ze Sklepu Windows 8.x poza programem Visual Studio.

Składnia do generowania plików resw na podstawie zestawu to:

resgen filename.extension  [outputDirectory]

gdzie parametry to:

filename.extension Nazwa zestawu .NET Framework (wykonywalnego lub .DLL). Jeśli plik nie zawiera żadnych zasobów, Resgen.exe nie tworzy żadnych plików.

outputDirectory Istniejący katalog, do którego mają być zapisywane pliki resw. Jeśli outputDirectory pominięto, pliki resw są zapisywane w bieżącym katalogu. Resgen.exe tworzy jeden plik resw dla każdego pliku resources w zestawie. Główna nazwa pliku resw jest taka sama jak nazwa główna pliku resources.

Następujące polecenie tworzy plik resw w katalogu Win8Resources dla każdego pliku resources osadzonego w MyApp.exe:

resgen MyApp.exe Win8Resources

Warunkowe kompilowanie zasobów

Począwszy od programu .NET Framework 4.5, Resgen.exe obsługuje warunkową kompilację zasobów ciągów w plikach tekstowych (.txt i restext). Dzięki temu można użyć pojedynczego pliku zasobów opartego na tekście w wielu konfiguracjach kompilacji.

W pliku .txt lub restext należy użyć ...#ifdef #endif konstruować w celu uwzględnienia zasobu w pliku binary .resources, jeśli jest zdefiniowany symbol, i używasz #if !konstrukcji ... #endif do uwzględnienia zasobu, jeśli symbol nie jest zdefiniowany. W czasie kompilacji należy zdefiniować symbole przy użyciu /define: opcji, po której następuje rozdzielana przecinkami lista symboli. Porównanie uwzględnia wielkość liter. Wielkość symboli zdefiniowanych przez /define program musi odpowiadać wielkości liter symboli w plikach tekstowych do skompilowania.

Na przykład następujący plik o nazwie UIResources.text zawiera zasób ciągu o nazwie , który może przyjmować jedną z trzech wartości, w zależności od tego, czy symbole o nazwie AppTitlePRODUCTION, CONSULTlub RETAIL są zdefiniowane.

#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

Następnie plik można skompilować w binarny plik resources za pomocą następującego polecenia:

resgen /define:CONSULT UIResources.restext

Spowoduje to utworzenie pliku resources zawierającego dwa zasoby ciągów. Wartość AppTitle zasobu to "My Consulting Company Project Manager".

Generowanie silnie typizowanej klasy zasobów

Resgen.exe obsługuje silnie typizowane zasoby, które hermetyzują dostęp do zasobów, tworząc klasy zawierające zestaw statycznych właściwości tylko do odczytu. Zapewnia to alternatywę dla wywołania metod ResourceManager klasy bezpośrednio w celu pobrania zasobów. Obsługę zasobów silnie typionych można włączyć przy użyciu /str opcji w Resgen.exe, która opakowuje funkcjonalność StronglyTypedResourceBuilder klasy. Po określeniu /str opcji dane wyjściowe Resgen.exe to klasa zawierająca silnie typizowane właściwości zgodne z zasobami, do których odwołuje się parametr wejściowy. Ta klasa zapewnia silnie typizowane dostęp tylko do odczytu do zasobów, które są dostępne w przetworzonym pliku.

Składnia umożliwiająca utworzenie silnie typizowanego zasobu to:

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

Parametry i przełączniki to:

inputFilename Nazwa pliku, w tym rozszerzenie, pliku zasobu, dla którego ma być generowana silnie typizowana klasa zasobów. Plik może być plikiem tekstowym, opartym na xml lub binarnym pliku resources; może mieć rozszerzenie .txt, .restext, resw lub .resources.

outputFilename Nazwa pliku wyjściowego. Jeśli outputFilename zawiera ścieżkę katalogu, katalog musi istnieć. Jeśli pominięto outputFilenamepolecenie , Resgen.exe utworzy plik resources z nazwą inputFilename pliku głównego w tym samym katalogu co inputFilename.

outputFilename może być plikiem .resources opartym na tekście, xml lub binarnym. Jeśli rozszerzenie outputFilename pliku różni się od rozszerzenia inputFilenamepliku , Resgen.exe wykonuje konwersję pliku.

Jeśli inputFilename jest to plik resources, Resgen.exe kopiuje plik resources, jeśli outputFilename jest również plikiem resources. Jeśli outputFilename zostanie pominięty, Resgen.exe zastąpić inputFilename identyczny plik resources.

Język Język, w którym ma być generowany kod źródłowy dla silnie typizowanej klasy zasobów. Możliwe wartości to cs, C#, i csharp dla kodu vb C# oraz visualbasic dla kodu Języka Visual Basic oraz vbsvbscript dla kodu VBScript oraz c++mc, i cpp dla kodu C++.

Namespace Przestrzeń nazw zawierająca silnie typizowana klasę zasobów. Plik resources i klasa zasobów powinny mieć tę samą przestrzeń nazw. Aby uzyskać informacje na temat określania przestrzeni nazw w pliku outputFilename, zobacz Kompilowanie zasobów do pliku binarnego. Jeśli przestrzeń nazw zostanie pominięta, klasa zasobów nie jest zawarta w przestrzeni nazw.

nazwa klasy Nazwa silnie typizowanej klasy zasobów. Powinno to odpowiadać nazwie głównej pliku resources. Jeśli na przykład Resgen.exe generuje plik resources o nazwie MyCompany.Libraries.Strings.resources, nazwa silnie typizowanej klasy zasobów to Strings. Jeśli pominięto nazwę klasy , wygenerowana klasa pochodzi z nazwy głównej outputFilenameklasy . Jeśli outputFilename zostanie pominięta, wygenerowana klasa pochodzi z nazwy głównej inputFilenameklasy .

nazwa klasy nie może zawierać nieprawidłowych znaków, takich jak spacje osadzone. Jeśli nazwa klasy zawiera osadzone spacje lub jeśli nazwa klasy jest domyślnie generowana na podstawie inputFilename, a inputFilename zawiera osadzone spacje, Resgen.exe zastępuje wszystkie nieprawidłowe znaki podkreślenia (_).

Pod nazwą Nazwa pliku klasy.

/publicclass Sprawia, że silnie typizowana klasa zasobów jest publiczna, a internal nie (w języku C#) lub Friend (w Visual Basic). Umożliwia to dostęp do zasobów spoza zestawu, w którym są osadzone.

Ważne

Podczas tworzenia silnie typizowanej klasy zasobów nazwa pliku resources musi być zgodna z przestrzenią nazw i nazwą klasy wygenerowanego kodu. Jednak Resgen.exe pozwala określić opcje, które generują plik resources, który ma niezgodną nazwę. Aby obejść to zachowanie, zmień nazwę pliku wyjściowego po jego wygenerowaniu.

Silnie typizowana klasa zasobów ma następujące elementy członkowskie:

  • Konstruktor bez parametrów, który może służyć do tworzenia wystąpienia silnie typizowanej klasy zasobów.

  • Właściwość static (C#) lub Shared (Visual Basic) i tylko ResourceManager do odczytu, która zwraca ResourceManager wystąpienie, które zarządza silnie typiowanym zasobem.

  • Właściwość statyczna Culture , która umożliwia ustawienie kultury używanej do pobierania zasobów. Domyślnie jego wartość to null, co oznacza, że jest używana bieżąca kultura interfejsu użytkownika.

  • Jedna static właściwość (C#) lub Shared (Visual Basic) i tylko do odczytu dla każdego zasobu w pliku resources. Nazwa właściwości to nazwa zasobu.

Na przykład następujące polecenie kompiluje plik zasobów o nazwie StringResources.txt do pliku StringResources.resources i generuje klasę o nazwie StringResources w pliku kodu źródłowego Visual Basic o nazwie StringResources.vb, który może służyć do uzyskiwania dostępu do usługi Resource Manager.

resgen StringResources.txt /str:vb,,StringResources

Zobacz także

  • Last updated on