Zarządzanie zasobami aplikacji
Pliki zasobów to pliki, które są częścią aplikacji, ale nie są kompilowane, na przykład pliki ikony lub pliki audio. Ponieważ te pliki nie są częścią procesu kompilacji, można je zmienić bez konieczności ponownego kompilowania plików binarnych. Jeśli planujesz lokalizowanie aplikacji, należy użyć plików zasobów dla wszystkich ciągów i innych zasobów, które należy zmienić podczas lokalizowania aplikacji.
Uwaga
Zasoby w .resx plikach mogą być serializowane przy użyciu metody BinaryFormatter, która nie jest bezpieczna. Uwzględnij tylko te .resx pliki w procesie kompilacji, którym ufasz.
Aby uzyskać więcej informacji na temat zasobów w aplikacjach platformy .NET, zobacz Zasoby w aplikacjach platformy .NET.
Praca z zasobami
W projekcie kodu zarządzanego otwórz okno właściwości projektu. Okno właściwości można otworzyć, wykonując jedną z następujących czynności:
- Kliknięcie prawym przyciskiem myszy węzła projektu w Eksplorator rozwiązań i wybranie pozycji Właściwości
- Wpisywanie właściwości projektu w polu wyszukiwania Ctrl+Q
- Naciśnięcie Alt+Enter w Eksplorator rozwiązań
Wybierz kartę Zasoby. Jeśli projekt nie zawiera jeszcze pliku resx, możesz dodać i usunąć różne rodzaje zasobów oraz zmodyfikować istniejące zasoby.
Ulepszenia Eksploratora zasobów w programie Visual Studio 2022 lub nowszym
Począwszy od programu Visual Studio 2022 w wersji 17.11, eksplorator zasobów został znacznie ulepszony. Zobacz Wprowadzenie do odnowionego Eksploratora zasobów programu Visual Studio.
Aby użyć nowego Eksploratora zasobów, musisz mieć projekt platformy .NET zawierający co najmniej jeden plik zasobów (.resx). Aby otworzyć Eksploratora zasobów, kliknij prawym przyciskiem myszy dowolny plik zasobów w Eksplorator rozwiązań i wybierz polecenie Otwórz za pomocą>Eksploratora zasobów. Alternatywnie można użyć skrótu klawiaturowego Ctrl+Alt+R.
Po otwarciu nowego Eksploratora zasobów po lewej stronie zostanie wyświetlone omówienie wszystkich zasobów przechowywanych obok ustawień regionalnych dla każdego pliku. Możesz skonfigurować ustawienia regionalne widoczne w usłudze datagrid. Ten interfejs umożliwia porównywanie tłumaczeń obok siebie i edytowanie ich na miejscu.
Wyszukiwanie ciągów zasobów
W lewym górnym rogu siatki możesz użyć pola wyszukiwania, aby wykonać tekst przeszukiwania wszystkich plików zasobów. Aby wyszukać zasób, wpisz pole wyszukiwania na pasku narzędzi i naciśnij Enter. Siatka danych będzie wyświetlać tylko zasoby pasujące do zapytania w ich nazwie, wartości lub komentarzu. Symbole wieloznaczne (*) umożliwiają wykonywanie częściowych dopasowań i cudzysłowów (") w celu wykonania dokładnych dopasowań.
Dodawanie komentarzy do określonych tłumaczeń zasobu
Komentarze są przydatnym sposobem udostępnienia większej ilości informacji lub kontekstu dla zasobu, takiego jak znaczenie, użycie lub ton ciągu. W Eksploratorze zasobów można dodawać komentarze do każdego tłumaczenia zasobu i wyświetlać je wszystkie jednocześnie w siatce danych.
Aby dodać komentarz do zasobu, wybierz komórkę odpowiadającą tłumaczeniu, na którym chcesz dodać komentarz, a następnie kliknij przycisk Edytuj komentarz na pasku narzędzi lub naciśnij Shift+Enter. Poniżej komórki zostanie wyświetlone pole komentarza, w którym można wpisać komentarz. Naciśnij Enter , aby zapisać komentarz lub Esc , aby go odrzucić.
Istniejące komentarze można edytować lub usuwać, klikając pole komentarza lub używając tego samego skrótu klawiaturowego. Aby wyświetlić wszystkie komentarze dla zasobu, wyszukaj małą ikonę trójkąta w rogu każdej komórki, która ma komentarz. Możesz umieścić kursor nad ikoną, aby wyświetlić etykietkę narzędzia z tekstem komentarza lub kliknąć go, aby otworzyć pole komentarza.
Komentarze są dostępne dla wielu użytkowników plików zasobów. Tłumacz, deweloper lub menedżer zasobów może pozostawić notatki, pytania, wyjaśnienia lub zastrzeżenia obok tłumaczeń. Mała ikona w rogu każdej komórki wskazuje obecność komentarza.
Filtrowanie zasobów
Aby filtrować zasoby, kliknij ikonę filtru na pasku narzędzi i wybierz kryteria, które chcesz zastosować. Zasoby można filtrować według nazwy, wartości, komentarza, typu lub pliku.
| Filtr | opis |
|---|---|
| Nazwa/nazwisko | Pokaż tylko zasoby, które mają określoną nazwę lub prefiks. |
| Wartość | Pokaż tylko zasoby, które mają określoną wartość lub zawierają określony ciąg. |
| Komentarz | Pokaż tylko zasoby, które mają komentarz lub zawierają określony ciąg w komentarzu. |
| Typ | Pokaż tylko zasoby, które mają określony typ, taki jak ciąg, obraz lub ikona. |
| Plik | Pokaż tylko zasoby należące do określonego pliku lub kultury. |
Możesz połączyć wiele filtrów, aby zawęzić wyniki i wyczyścić je, klikając przycisk Wyczyść filtr.
Walidacja i ostrzeżenia
Symbole zastępcze to specjalne tokeny, które są zastępowane wartościami dynamicznymi w czasie wykonywania, takimi jak {0}, {1}lub {name}. Jeśli używasz symboli zastępczych w zasobach, musisz upewnić się, że są one spójne we wszystkich lokalizacjach, w przeciwnym razie w aplikacji mogą wystąpić błędy lub nieoczekiwane zachowanie.
Nowy Eksplorator zasobów automatycznie weryfikuje symbole zastępcze dla każdego zasobu i wyświetla ikonę ostrzeżenia, jeśli istnieje niezgodność między kulturą domyślną a dowolną inną lokalizacją. Jeśli na przykład domyślną wartością zasobu jest "Hello, {name}!", a wartość hiszpańska to "Hola, {nombre}!", zostanie wyświetlona ikona ostrzeżenia przedstawiająca, że nazwa symbolu zastępczego jest inna. Możesz umieścić kursor nad ikoną, aby wyświetlić etykietkę narzędzia ze szczegółami niezgodności i kliknąć ją, aby ją naprawić.
Brakujące tłumaczenia to inny typowy problem, który może mieć wpływ na środowisko użytkownika aplikacji. Jeśli nie podasz tłumaczenia zasobu w określonej kulturze, aplikacja wróci do kultury domyślnej, co może nie być właściwe lub pożądane dla niektórych użytkowników. Eksplorator zasobów pomaga uniknąć tego problemu, wyświetlając ikonę ostrzeżenia, jeśli nie ma wartości zasobu w określonej kulturze. Jeśli na przykład> masz zasób z wartością File domyślną i nie ma wartości dla kultury francuskiej, zostanie wyświetlona ikona ostrzeżenia pokazująca, że brakuje tłumaczenia. Możesz umieścić kursor nad ikoną, aby wyświetlić etykietkę narzędzia z komunikatem Brak wartości i wybrać ją, aby dodać wartość.
Opcje dostosowywania
Eksplorator zasobów w programie Visual Studio 2022 lub nowszym jest zgodny z czytnikami zawartości ekranu i technologią pomocną, aby był bardziej dostępny dla deweloperów z wadami wzrokowymi lub niepełnosprawnościami. Skróty klawiaturowe umożliwiają nawigowanie po siatce danych, edytowanie wartości i komentarzy oraz wykonywanie typowych akcji. Narrator może również odczytywać zawartość każdej komórki, a także etykietki narzędzi i ostrzeżenia.
Aby dostosować poziom powiększenia, użyj suwaka powiększenia na pasku narzędzi lub skrótów klawiaturowych Ctrl i Ctrl-+=+, aby powiększać lub powiększać. Użyj Ctrl+0, aby zresetować poziom powiększenia domyślnie.
Motyw Eksploratora zasobów jest zgodny z resztą środowiska programu Visual Studio. Możesz wybrać między jasnymi, ciemnymi lub niebieskimi motywami, a Eksplorator zasobów odpowiednio dostosuje się. Możesz również zmienić czcionkę i kolory siatki danych, używając okna dialogowego Narzędzia>Opcje>>czcionek środowiskowych i kolorów.
Zasoby w innych typach projektów
Zasoby są zarządzane inaczej w projektach .NET niż w innych typach projektów. Aby uzyskać więcej informacji na temat zasobów w:
- platforma uniwersalna systemu Windows (UWP), zobacz Zasoby aplikacji i system zarządzania zasobami
- Projekty C++/CLI (zarządzane) — zobacz Zasoby w aplikacjach klasycznych
- Projekty języka C++, zobacz Praca z plikami zasobów i Instrukcje: tworzenie zasobu
- Użyj okna Widok zasobów (Wyświetl>inny widok zasobów systemu Windows>), aby wyświetlić pliki zasobów zawarte w projektach.
Opcje pomocy technicznej
Jeśli wystąpi problem z zarządzaniem zasobami aplikacji, zobacz Rozwiązywanie problemów z błędami w Edytorze zasobów.