Używanie zestawów z wielojęzycznym interfejsem użytkownika

Jeśli chcesz, aby użytkownicy aplikacji lub podstawowej biblioteki DLL mogli zmieniać język interfejsu użytkownika, rozważ umieszczenie zasobów językowych w oddzielnych bibliotekach DLL zasobów satelitarnych. Aby uzyskać więcej informacji na temat używania bibliotek DLL zasobów satelitarnych, zobacz wielojęzyczny interfejs użytkownika (MUI).

Każda biblioteka DLL satelitarna zawiera zasoby dla innego języka. Podstawowa biblioteka DLL może być dostarczana jako zestaw, a każda z bibliotek DLL satelity może być dostarczana jako oddzielne zestawy satelitarne. W takim przypadku każdy zestaw satelitarny powinien mieć własny manifest zestawu samoopisującego. Manifest zestawu satelitarnego nie powinien opisywać żadnej zależności od innych zestawów. Zależność zestawów satelickich od innych zestawów powinna być opisana w manifeście zestawu podstawowego.

Multilanguage User Interface (MUI) wersja systemu Windows umożliwia użytkownikom określenie języka interfejsu użytkownika zgodnie z ich preferencjami, pod warunkiem, że wymagany język został dodany do systemu. Podstawowy zestaw może obsługiwać wiele języków przy użyciu wielu zestawów MUI. W takim przypadku każdy zestaw MUI powinien mieć swój własny manifest, a wszelkie zależności od innych zestawów powinny być opisane tylko w manifeście podstawowego zestawu.

Na przykład Proseware.Sample.Pop może być podstawowym zestawem równoległym, który jest zależny od zestawu Proseware.Research.SampleAssembly. Jeśli plik Proseware.Sample.Pop używa interfejsu MUI do obsługi wielu języków, można udostępnić oddzielne zestawy MUI dla każdego języka. Każdy zestaw MUI powinien mieć własny manifest opisujący tę konkretną bibliotekę DLL zasobu satelitarnego. Manifesty zestawu MUI nie powinny zawierać żadnych odwołań do zależności od innych zestawów. Manifest opisujący podstawowy zestaw Proseware.Sample.Pop powinien opisywać zależność zestawu Proseware.Sample.Pop od zestawu Proseware.Research.SampleAssembly.

Atrybuty elementu assemblyIdentity zestawu satelitarnego są podobne do tych w manifeście zestawu podstawowego. Nazwa atrybutu powinna być taka sama jak zestaw podstawowy, z dodatkiem "Zasoby". Na przykład, jeśli nazwa w zestawie podstawowym to "Proseware.Tools.SpellCheck.Runtime-Libraries", to nazwa w zestawie zasobów będzie "Proseware.Tools.SpellCheck.Runtime-Libraries.Resources". Atrybut języka powinien identyfikować język zestawu zasobów. Atrybut pliku powinien zawierać listę plików, które są bibliotekami DLL przechowujących zasoby.

Poniżej przedstawiono przykład manifestu narzędzia Proseware.Tools.SpellCheck.Runtime-Libraries zestaw zasobów.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0">
    <assemblyIdentity
        type="win32"
        name="Proseware.Tools.SpellCheck.Runtime-Libraries.Resources"
        version="6.0.0.0"
        processorArchitecture="X86"
        language="DE"
        publicKeyToken="0000000000000000"
    />
    <file name="sample.dll"/>
</assembly>

Zestaw podstawowy opisuje opcjonalną zależność od zestawu zasobów. W tym przykładzie, jeśli użytkownik korzysta z systemu Windows z ustawieniami regionalnymi wyznaczonymi jako niemiecki, aplikacja korzystająca z zestawu Proseware.Tools.SpellCheck będzie wyświetlać tekst w języku niemieckim.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0">
    <assemblyIdentity type="win32" 
    name="Proseware.Tools.SpellCheck.Runtime-Libraries"
    version="6.0.0.0" processorArchitecture="x86"
    publicKeyToken="0000000000000000"/>
    <dependency optional="yes">
        <dependentAssembly>
            <assemblyIdentity type="win32" 
                              name="Proseware.Tools.SpellCheck.Runtime-Libraries.Resources" 
                              version="6.0.0.0" 
                              processorArchitecture="x86" 
                              publicKeyToken="0000000000000000" 
                              language="*"
            />
        </dependentAssembly>
    </dependency>