Winres.exe (Edytor lokalizacji zasobów systemu Windows)

Artykuł
05/09/2023

Edytor lokalizacji zasobów systemu Windows, Winres.exe, to narzędzie do układu wizualnego, które ułatwia ekspertom lokalizacji lokalizowanie zasobów interfejsu użytkownika (UI) Windows Forms używanych przez formularze. Możesz utworzyć pliki resx lub resources , które są używane jako dane wejściowe do Winres.exe przy użyciu środowiska projektowego wizualizacji, takiego jak Microsoft Visual Studio. Aby uzyskać informacje na temat wdrażania zasobów w aplikacjach .NET Framework, zobacz Zasoby w aplikacjach platformy .NET.

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

Ostrzeżenie

Nie otwieraj niezaufanych plików za pomocą tego narzędzia. Jeśli plik jest plikiem binarnym, będzie deserializowany przy użyciu deserializacji binarnej, która jest niebezpieczna. Aby uzyskać więcej informacji, zobacz Ryzyko deserializacji w użyciu klasy BinaryFormatter i powiązanych typów.

Składnia

winres resourceFile
winres /?

Argumenty

Argument	Opis
`resourceFile`	Plik zasobów do zlokalizowania. Ten plik musi być plikiem resx lub resources formularza Windows Forms wygenerowanym przez projektanta programu Visual Studio. Winres.exe nie może otwierać rodzajowych plików resx i resources.

Opcja	Opis
/?	Wyświetla składnię polecenia i opcje narzędzia.

Uwagi

Stan elementów interfejsu użytkownika z formularza w projekcie Windows Forms jest zwykle przechowywany w plikach zasobów, które są plikami opartymi na formacie XML z rozszerzeniem resx lub odpowiednimi skompilowanymi wersjami binarnymi z rozszerzeniem resources. Winres.exe jest narzędziem, które umożliwia ograniczone edytowanie obu typów plików poza środowiskiem projektowania programu Visual Studio. W szczególności umożliwia następujące rodzaje operacji edycji:

Plik zasobów kultury neutralnej lub określonej można edytować, aby zmienić właściwości interfejsu użytkownika formularza lub jego formantów, takich jak ich tekst, rozmiar lub położenie.
Pliki zasobów kultury neutralnej lub określonej mogą być generowane z domyślnego pliku zasobów.
Plik zasobów kultury można zapisać jako inny plik zasobów kultury. Na przykład plik zasobów Angielski (USA) można zapisać jako plik zasobów Polski. Zazwyczaj nowy plik będzie można później edytować, aby był zgodny z nową kulturą.

Zobacz również hierarchiczną organizację zasobów dla lokalizacji lub hierarchiczną organizację zasobów na potrzeby lokalizacji.

Winres.exe nie może skonwertować pliku resx na odpowiedni plik resources; użyj narzędzia Resgen.exe. Aby uzyskać więcej informacji na temat Resgen.exe, zobacz Resgen.exe (Generator plików zasobów).

Winres.exe jest aplikacją graficzną, która odtwarza wersję formularza Windows Forms czasu projektowania z samego pliku zasobów, bez dostępu do kodu źródłowego. Winres.exe hostuje okno Windows Forms Projektant formularzy i Właściwości programu Visual Studio. Te funkcje umożliwiają wizualne edytowanie pliku resources lub resx zawierającego formularz Windows Forms. Zazwyczaj lokalizatory używają Winres.exe do edytowania etykiet kontrolek i dostosowywania lokalizacji i rozmiaru kontrolek w celu dostosowania etykiet do kultury docelowej.

Jeśli Winres.exe nie może rozpoznać typu formantu, utworzy formant zastępczy formantu w zlokalizowanym pliku resources lub resx. Symbol zastępczy formantu pojawia się w formularzu Windows Forms jako okno zakreskowane. Rozmiar i położenie zakreskowanego okna są zgodne z rzeczywistym formantem. Wszystkie dostępne właściwości lokalizowalne dla kontrolki symbolu zastępczego są wyświetlane w oknie Właściwości . Wszelkie zmiany wprowadzone do symbolu zastępczego formantu są zapisywane dla rzeczywistego formantu.

Winres.exe a Visual Studio

Ogólnie rzecz biorąc, przed rozpoczęciem lokalizowania formularzy Windows Forms aplikacji należy zadecydować, czy jako narzędzia do lokalizacji używać programu Visual Studio czy Winres.exe. Zgodność wersji opisana poniżej może uniemożliwić przejście od jednego narzędzia do drugiego.

Zaletą programu Visual Studio jest to, że można za jego pomocą tworzyć i lokalizować aplikacje. Aby lokalizować formularz, po zakończeniu programowania ustaw wartość formularza LocalizableAttribute (właściwość Localizable w edytorze właściwości ) true na i zmień jej właściwość Language na żądaną kulturę docelową. Następnie należy przeprowadzić edycję ciągów i dostosować położenie i rozmiar formantów, aby pomieściły ciągi dla kultury docelowej. Podczas zapisywania zlokalizowanego pliku resx Visual Studio zapisuje w pliku tylko lokalizowalne właściwości (właściwości zmienione w docelowej kulturze). Program Visual Studio automatycznie tworzy zestaw satelicki dla zlokalizowanego pliku resx w lokalizacji odpowiedniego katalogu.

Mimo że program Visual Studio zapewnia zintegrowane środowisko programistyczne i lokalizacyjne, Winres.exe jest zalecanym narzędziem do użycia, jeśli lokalizacja jest wykonywana przez lokalizatory innych firm. Ponieważ Winres.exe jest tylko narzędziem do lokalizacji, umożliwia jaśniejsze rozdzielenie kodu aplikacji od formularzy, które mają zostać zlokalizowane, co jest praktyczniejsze w przypadku zarządzania dużymi projektami.

Korzystanie z Winres.exe

Aby lokalizować przy użyciu Winres.exe, należy najpierw opracować aplikację przy użyciu projektanta wizualnego, takiego jak projektant Windows Forms w programie Visual Studio. Po zakończeniu programowania ustaw dla formularza LocalizableAttribute (właściwość Lokalizable w edytorze właściwości ) na true, a następnie przekaż plik resx domyślnej kultury do lokalizatora innej firmy. Ten plik resx zawiera dodatkowe informacje, których Winres.exe używa do odtworzenia wersji oryginalnego formularza z czasu projektowania.

Uwaga

Programu Winres.exe nie można używać do edytowania domyślnego pliku zasobów. Winres.exe interpretuje wszystkie zmienione właściwości jako właściwości zlokalizowane i zapisuje je do pliku zasobów docelowej kultury.

Ostateczna wersja pliku zasobów kultury może zostać użyta do utworzenia zlokalizowanej wersji aplikacji. Aby uzyskać więcej informacji, zobacz Zasoby w aplikacjach .NET.

Winres.exe ma następujące funkcje i możliwości:

Winres może działać w trybie pojedynczego pliku (SFM) lub w trybie pliku Visual Studio (VSFM). SFM jest starszym trybem, w którym w pliku zasobów są zapisywane pełne informacje o formularzu i jego zawartość. W trybie VSFM w pliku zasobów zapisywane są tylko zmiany dotyczące kultury.
Okno raportowania błędów zdokowane w lewym dolnym rogu okna głównego.
Skróty można sprawdzić pod kątem duplikatów: w menu Format kliknij polecenie Check HotKeys (Sprawdź klucz dostępu).

Zgodność wersji

Należy użyć wersji Winres.exe wydanej przy użyciu .NET Framework, której używasz. W poniższej tabeli wymieniono zgodne wersje:

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

Uwaga

Chociaż tryb VSFM ma tę zaletę, że jest zgodny z programem Visual Studio, ponieważ są w nim zapisywane tylko zmienione wartości, program Winres.exe wymaga, aby w tym samym katalogu znajdował się pierwotny plik zasobów. Na przykład edytowanie TestApp.de-DE.resourcespliku zasobów w Niemczech w języku niemieckim wymaga obecności domyślnego pliku zasobu , TestApp.resxi ewentualnie pliku zasobu neutralnego dla kultury. TestApp.de.resources

Przykłady

Aby zlokalizować plik resx lub .resources skojarzony z formularzem

Aby uruchomić Winres.exe, wprowadź w winres wierszu polecenia dewelopera.
Aby otworzyć domyślne zasoby formularza do lokalizowania, wybierz pozycję Plik > Otwórz i przejdź do pliku, aby go otworzyć.

-lub-

Określ plik do otwarcia w wierszu polecenia podczas uruchamiania programu Winres.exe. Następujące polecenie uruchamia Winres.exe i ładuje formularz skojarzony z TestApp.resx programem w Projektancie formularzy.
```
winres TestApp.resx
```
Następujące polecenie uruchamia Winres.exe i ładuje formularz skojarzony z TestApp.resources programem w Projektancie formularzy.
```
winres TestApp.resources
```
Uwaga

Jeśli formularz, którego zasoby są edytowane, jest odziedziczonym formularzem, zarówno zestaw zawierający formularz, po którym został odziedziczony edytowany formularz, jak i zestaw zawierający dziedziczący formularz muszą być albo zarejestrowane w globalnej pamięci podręcznej zestawów (GAC) lub znajdować się w tym samym katalogu co plik WinRes.exe. Aby uzyskać więcej informacji na temat instalowania .NET Framework składników w pamięci podręcznej GAC, zobacz Global Assembly Cache (Global Assembly Cache).
Wybierz kontrolki w formularzu i zmień ich Text i inne właściwości, aby odzwierciedlić zlokalizowaną kulturę i język. Przenoszenie lub zmienianie rozmiaru formantów w celu dostosowania zlokalizowanego tekstu.
Aby zapisać zlokalizowaną wersję pliku resx lub resources, kliknij ikonę Zapisz lub wybierz pozycję Zapisz plik>. Narzędzie wyświetli okno Wybierz kulturę .
Wybierz odpowiednią kulturę i tryb plików, a następnie kliknij przycisk OK.

Narzędzie zapisuje plik przy użyciu konwencji nazewnictwa oczekiwanej przez środowisko uruchomieniowe dla zlokalizowanych plików zasobów. Jeśli na przykład lokalizujesz TestApp.resources język niemiecki w Niemczech, narzędzie zapisze plik jako TestApp.de-DE.resources. Jeśli lokalizujesz TestApp.resx język niemiecki w Niemczech, narzędzie zapisze plik jako TestApp.de-DE.resx. Aby uzyskać więcej informacji na temat konwencji nazewnictwa zasobów, zobacz Package and Deploy resources (Tworzenie pakietów i wdrażanie zasobów). Aby uzyskać listę wstępnie zdefiniowanych nazw kultur używanych przez środowisko uruchomieniowe, zobacz klasę CultureInfo .

Share via