Udostępnij przez

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

Edytor lokalizacji zasobów systemu Windows, Winres.exe, jest narzędziem układu wizualnego, które ułatwia ekspertom lokalizacji lokalizację zasobów interfejsu użytkownika (UI) formularzy systemu Windows. Możesz utworzyć pliki resx lub resources , które są używane jako dane wejściowe do Winres.exe przy użyciu wizualnego środowiska projektowego, 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 z programem 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, zostanie zdeserializowany przy użyciu deserializacji binarnej, która jest niebezpieczna. Aby uzyskać więcej informacji, zobacz Ryzyko deserializacji w użyciu elementu BinaryFormatter i powiązanych typów.

Składnia

winres resourceFile
winres /?

Arguments

Argument Description
resourceFile Plik zasobu do lokalizowania. Ten plik musi być plikiem resx lub resources formularzy systemu Windows wygenerowanym przez projektanta programu Visual Studio. Winres.exe nie można otworzyć ogólnych plików resx lub resources.
Option Description
/? Wyświetla składnię poleceń 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 to narzędzie, które umożliwia ograniczoną edycję dowolnego typu pliku poza środowiskiem projektowym programu Visual Studio. W szczególności umożliwia ona następujące typy operacji edycji:

  • Plik zasobu neutralnej lub określonej kultury można edytować, aby zmienić właściwości interfejsu użytkownika formularza lub jego kontrolek, takie jak tekst, rozmiar lub położenie.
  • Pliki zasobów kultury neutralnej lub określonej można wygenerować na podstawie domyślnego pliku zasobu.
  • Plik zasobu kultury można zapisać jako inny plik zasobu kultury. Na przykład plik zasobu w języku angielskim (USA) może zostać zapisany jako polski plik zasobu. Zazwyczaj nowy plik będzie następnie edytowany, 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 przekonwertować pliku resx na odpowiedni plik resources; Zamiast tego 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 to aplikacja graficzna, która odtwarza wersję w czasie projektowania formularza Windows Forms tylko z pliku zasobu bez dostępu do kodu źródłowego. Winres.exe hostuje projektanta formularzy windows forms i Properties okna 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, aby dopasować etykiety do kultury docelowej.

Jeśli Winres.exe nie może rozpoznać typu kontrolki, tworzy kontrolkę symbolu zastępczego w zlokalizowanym pliku resx lub resources. Kontrolka symbolu zastępczego jest wyświetlana w formularzu Windows Forms jako okno kreskowane. Rozmiar i położenie okna kreskowanego są zgodne z rozmiarem rzeczywistej kontrolki. Wszystkie dostępne właściwości lokalizowalne dla kontrolki symbolu zastępczego Properties są wyświetlane w oknie. Wszelkie zmiany wprowadzone w kontrolce symbolu zastępczego są zapisywane dla rzeczywistej kontrolki.

Winres.exe a Visual Studio

Ogólnie rzecz biorąc, przed rozpoczęciem lokalizowania formularzy Windows Forms aplikacji należy zdecydować, czy chcesz użyć programu Visual Studio, czy Winres.exe jako narzędzia lokalizacji. Zgodność wersji, jak opisano w dalszej części, może uniemożliwić przejście z jednego narzędzia na drugie.

Zaletą programu Visual Studio jest to, że można jej używać do tworzenia i lokalizowania aplikacji. Aby zlokalizować formularz, po zakończeniu opracowywania ustaw wartość formularza LocalizableAttribute (właściwość w Properties edytorze) true i zmień jej Language właściwość na żądaną kulturę Localizable docelową. Następnie zmodyfikuj ciągi i dostosuj lokalizację i rozmiar kontrolek, aby uwzględnić ciągi dla kultury docelowej. Po zapisaniu zlokalizowanego pliku resx program Visual Studio zapisuje tylko właściwości lokalizowalne (właściwości zmienione w kulturze docelowej) do pliku. Program Visual Studio automatycznie tworzy zestaw satelitarny dla zlokalizowanego pliku resx w prawidłowej lokalizacji 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 lokalizacji, umożliwia bardziej czytelne oddzielenie kodu aplikacji od formularzy do lokalizacji, co jest bardziej praktyczne 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 Windows Forms Designer w programie Visual Studio. Po zakończeniu programowania ustaw wartość formularza LocalizableAttribute ( Localizable właściwość w Properties edytorze), truea 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 ponownego utworzenia wersji oryginalnej formularza w czasie projektowania.

Uwaga / Notatka

Winres.exe nie można użyć do edycji domyślnego pliku zasobu. Winres.exe interpretuje wszystkie zmienione właściwości jako zlokalizowane właściwości i zapisuje je w pliku zasobu kultury docelowej.

Ostateczne wersje plików zasobów kultury mogą służyć do tworzenia zlokalizowanych wersji aplikacji. Aby uzyskać więcej informacji, zobacz Zasoby w aplikacjach platformy .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 plików programu Visual Studio (VSFM). SfM to starszy tryb, w którym pełne informacje o formularzu i jego zawartości są przechowywane w pliku zasobu. Program VSFM przechowuje tylko zmiany kulturowe w pliku zasobów.

  • Okno raportowania błędów zadokowane do lewej dolnej części okna głównego.

  • Skróty można sprawdzić pod kątem duplikatów: w Format menu kliknij polecenie Sprawdź dostępu .

Zgodność wersji

Należy użyć wersji Winres.exe, która została wydana przy użyciu używanego programu .NET Framework. 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 / Notatka

Mimo że program VSFM ma zaletę zgodności z programem Visual Studio, ponieważ przechowuje tylko zmienione wartości w pliku zasobów, Winres.exe wymaga, aby elementy nadrzędne bieżącego pliku zasobu znajdowały się w tym samym katalogu. Na przykład edytowanie TestApp.de-DE.resourcespliku zasobów języka niemieckiego w Niemczech wymaga obecności domyślnego pliku zasobu , TestApp.resxi prawdopodobnie pliku zasobu neutralnego pod względem kultury. TestApp.de.resources

Przykłady

Aby zlokalizować plik resx lub resources skojarzony z formularzem

  1. Aby uruchomić Winres.exe, wprowadź polecenie winres w wierszu polecenia dewelopera.

  2. Aby otworzyć domyślne zasoby formularza do lokalizowania, wybierz pozycję Otwórz plik > i przejdź do pliku, aby go otworzyć.

    — lub —

    Określ plik do otwarcia w wierszu polecenia po uruchomieniu 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 / Notatka

    Jeśli formularz, którego edytowane zasoby jest formularzem dziedziczony, zarówno zestaw zawierał formularz dziedziczony, jak i zestaw zawierający formularz dziedziczący (pochodny) musi być zarejestrowany w globalnej pamięci podręcznej zestawów (GAC) lub musi znajdować się w tym samym katalogu co WinRes.exe. Aby uzyskać więcej informacji na temat instalowania składników programu .NET Framework w usłudze GAC, zobacz Global Assembly Cache (Global Assembly Cache).

  3. Wybierz kontrolki w formularzu i zmień ich Text i inne właściwości, aby odzwierciedlić zlokalizowaną kulturę i język. Przenieś lub zmień rozmiar kontrolek w razie potrzeby, aby uwzględnić zlokalizowany tekst.

  4. Aby zapisać zlokalizowaną wersję pliku resx lub resources, kliknij ikonę Save lub wybierz pozycję Zapisz plik>. Narzędzie wyświetla okno Wybierz kulturę .

  5. 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 zapisuje plik jako TestApp.de-DE.resources. Jeśli lokalizujesz TestApp.resx język niemiecki w Niemczech, narzędzie zapisuje plik jako TestApp.de-DE.resx. Aby uzyskać więcej informacji na temat konwencji nazewnictwa zasobów, zobacz Package and Deploy resources (Pakowanie i wdrażanie zasobów). Aby uzyskać listę wstępnie zdefiniowanych nazw kultury używanych przez środowisko uruchomieniowe, zobacz klasę CultureInfo .

Zobacz także

  • Last updated on