Exemplarische Vorgehensweise: Bedarfsgerechtes Herunterladen von Satellitenassemblys mit der API für die ClickOnce-Bereitstellung

Mit Windows Forms-Anwendungen können mehrere Kulturen mithilfe von Satellitenassemblys konfiguriert werden. Eine Satellitenassembly ist eine Assembly, die Anwendungsressourcen für eine andere Kultur als die Standardkultur der Anwendung enthält.

Wie in Lokalisieren von ClickOnce-Anwendungen erläutert, können Sie mehrere Satellitenassemblys für verschiedene Kulturen in dieselbe ClickOnce-Bereitstellung einschließen. In der Standardeinstellung werden von ClickOnce alle Satellitenassemblys in Ihrer Bereitstellung auf den Clientcomputer heruntergeladen, obwohl ein einzelner Client wahrscheinlich nur eine Satellitenassembly benötigt.

Diese exemplarische Vorgehensweise beschreibt, wie Sie Ihre Satellitenassemblys als optional kennzeichnen und nur die Assembly herunterladen, die ein Clientcomputer für die eigenen aktuellen Kultureinstellungen benötigt. Im folgenden Verfahren werden die Tools im Windows SDK (Software Development Kit) verwendet. Sie können diese Aufgabe auch in Visual Studio ausführen. Siehe auch Exemplarische Vorgehensweise: Bedarfsgerechtes Herunterladen von Satellitenassemblys mit der API für die ClickOnce-Bereitstellung unter Verwendung des Designers oder Exemplarische Vorgehensweise: Bedarfsgerechtes Herunterladen von Satellitenassemblys mit der API für die ClickOnce-Bereitstellung unter Verwendung des Designers.

Hinweis

Die Klasse ApplicationDeployment und die APIs im Namespace System.Deployment.Application werden in .NET Core und .NET 5 und höheren Versionen nicht unterstützt. In .NET 7 wird eine neue Methode für den Zugriff auf Anwendungsbereitstellungseigenschaften unterstützt. Weitere Informationen finden Sie unter Zugreifen auf ClickOnce-Bereitstellungseigenschaften in .NET. .NET 7 unterstützt nicht das Äquivalent von ApplicationDeployment-Methoden.

Hinweis

In den folgenden Codebeispielen wird die Kultur zu Testzwecken programmgesteuert auf ja-JPfestgelegt. Im Abschnitt "Nächste Schritte" weiter unten in diesem Thema finden Sie Informationen zum Anpassen dieses Codes für eine Produktionsumgebung.

Voraussetzungen

In diesem Thema wird davon ausgegangen, dass Sie wissen, wie der Anwendung mit Visual Studio lokalisierte Ressourcen hinzugefügt werden können. Ausführliche Anweisungen dazu finden Sie unter Exemplarische Vorgehensweise: Lokalisieren von Windows Forms.

So laden Sie Satellitenassemblys bei Bedarf herunter

1. Fügen Sie den folgenden Code der Anwendung hinzu, um das bedarfsabhängige Herunterladen von Satellitenassemblys zu aktivieren.

   C#

   using System;
   using System.Collections.Generic;
   using System.Windows.Forms;
   using System.Threading;
   using System.Globalization;
   using System.Deployment.Application;
   using System.Reflection;
   
   namespace ClickOnce.SatelliteAssemblies
   {
       static class Program
       {
           [STAThread]
           static void Main()
           {
               Application.EnableVisualStyles();
               Application.SetCompatibleTextRenderingDefault(false);
               Thread.CurrentThread.CurrentUICulture = new CultureInfo("ja-JP");
   
               // Call this before initializing the main form, which will cause the resource manager
               // to look for the appropriate satellite assembly.
               GetSatelliteAssemblies(Thread.CurrentThread.CurrentCulture.ToString());
   
               Application.Run(new Form1());
           }
   
           static void GetSatelliteAssemblies(string groupName)
           {
               if (ApplicationDeployment.IsNetworkDeployed)
               {
                   ApplicationDeployment deploy = ApplicationDeployment.CurrentDeployment;
   
                   if (deploy.IsFirstRun)
                   {
                       try
                       {
                           deploy.DownloadFileGroup(groupName);
                       }
                       catch (DeploymentException de)
                       {
                           // Log error. Do not report error to the user, as there may not be a satellite
                           // assembly if the user's culture and the application's default culture match.
                       }
                   }
               }
           }
   
       }
   }
   

   VB

   Imports System.Deployment.Application
   Imports System.Globalization
   Imports System.Threading
   
   Public Class Form1
       Shared Sub Main(ByVal args As String())
           Application.EnableVisualStyles()
   
           Thread.CurrentThread.CurrentUICulture = New CultureInfo("ja-JP")
           GetSatelliteAssemblies(Thread.CurrentThread.CurrentUICulture.ToString())
   
           Application.Run(New Form1())
       End Sub
   
       Private Shared Sub GetSatelliteAssemblies(ByVal groupName As String)
           If (ApplicationDeployment.IsNetworkDeployed) Then
   
               Dim deploy As ApplicationDeployment = ApplicationDeployment.CurrentDeployment
   
               If (deploy.IsFirstRun) Then
                   Try
                       deploy.DownloadFileGroup(groupName)
                   Catch de As DeploymentException
                       ' Log error. Do not report error to the user, as there may not be a satellite
                       ' assembly if the user's culture and the application's default culture match.
   
                   End Try
               End If
           End If
       End Sub
   End Class
   

2. Generieren Sie mit Resgen.exe (Resource File Generator) oder Visual Studio Satellitenassemblys für Ihre Anwendung.

3. Generieren Sie ein Anwendungsmanifest, oder öffnen Sie das vorhandene Anwendungsmanifest, indem Sie MageUI.exe verwenden. Weitere Informationen zu diesem Tool finden Sie unter MageUI.exe (Tool zum Generieren und Bearbeiten von Manifesten, grafischer Client).

4. Klicken Sie auf die Registerkarte Dateien .

5. Klicken Sie auf die Schaltfläche mit den Auslassungszeichen (...), und wählen Sie das Verzeichnis aus, das alle Assemblys und Dateien der Anwendung enthält, einschließlich der Satellitenassemblys, die Sie mit Resgen.exe generiert haben. (Der Name einer Satellitenassembly besitzt folgendes Format: <ISO-Code>\Anwendungsname.resources.dll. Dabei entspricht <ISO-Code> einer Sprachen-ID im Format von RFC 1766.)

6. Klicken Sie auf Auffüllen , um die Dateien zu Ihrer Bereitstellung hinzuzufügen.

7. Aktivieren Sie für jede Satellitenassembly das Kontrollkästchen Optional .

8. Legen Sie für das Gruppenfeld jeder Satellitenassembly ihren ISO-Sprachenbezeichner fest. Für eine japanische Satellitenassembly würden Sie beispielsweise den Downloadgruppennamen ja-JPverfügbaren Tools verwendet. Damit kann der Code, den Sie in Schritt 1 hinzugefügt haben, je nach der Einstellung der CurrentUICulture -Benutzereigenschaft die entsprechende Satellitenassembly herunterladen.

Nächste Schritte

In einer Produktionsumgebung müssen Sie im Codebeispiel wahrscheinlich die Zeile entfernen, die für CurrentUICulture einen bestimmten Wert festlegt, denn auf Clientcomputern ist standardmäßig der richtige Wert festgelegt. Beim Ausführen der Anwendung auf einem japanischen Clientcomputer ist CurrentUICulture z. B. standardmäßig ja-JP . Diesen Wert programmgesteuert festzulegen bietet eine gute Möglichkeit zum Testen Ihrer Satellitenassemblys, bevor Sie Ihre Anwendung bereitstellen.

Zugehöriger Inhalt

• Lokalisieren von ClickOnce-Anwendungen