Lokalisierung des VintaSoft Imaging .NET SDK in jede beliebige Sprache

Das VintaSoft Imaging .NET SDK kann in jede beliebige Sprache lokalisiert werden.

Das SDK enthält lokalisierte VintaSoft .NET-Assemblies und VintaSoft WinForms-Demoprojekte, die beispielsweise ins Deutsche lokalisiert wurden, um zu zeigen, dass das SDK in jede beliebige Sprache lokalisiert werden kann.

Das SDK enthält außerdem lokalisierte VintaSoft ASP.NET Core-Demoprojekte in 32 Sprachen, die beispielhaft zeigen, dass die SDK-Lösung für Webanwendungen in jede beliebige Sprache lokalisiert werden kann.

Informationen zur Lokalisierung von Zeichenfolgenkonstanten und UI-Steuerelementen der VintaSoft .NET-Assembly finden Sie im Abschnitt "Lokalisierung der VintaSoft .NET-Assembly" dieses Artikels.

Informationen zur Lokalisierung von Zeichenfolgenkonstanten und der Benutzeroberfläche des VintaSoft WinForms-Demoprojekts finden Sie im Abschnitt "Lokalisierung des VintaSoft WinForms-Demoprojekts" dieses Artikels.

Informationen zur Lokalisierung von Zeichenfolgenkonstanten und der Benutzeroberfläche des VintaSoft ASP.NET-Demoprojekts finden Sie im Abschnitt "Lokalisierung des VintaSoft ASP.NET-Demoprojekts" dieses Artikels.

Lokalisierung der VintaSoft .NET-Assembly

Alle VintaSoft .NET-Assemblys sind in englischer Sprache lokalisiert.

Das VintaSoft Imaging .NET SDK bietet außerdem die Möglichkeit, die folgenden VintaSoft .NET-Assemblys (mithilfe von Satellitenressourcen-Assemblys) in jede beliebige Sprache zu lokalisieren:

Vintasoft.Imaging.dll
Vintasoft.Imaging.UI.dll
Vintasoft.Imaging.Annotation.Dicom.dll
Vintasoft.Imaging.Annotation.Dicom.UI.dll
Vintasoft.Imaging.Annotation.Dicom.Wpf.UI.dll
Vintasoft.Imaging.Dicom.dll
Vintasoft.Imaging.Dicom.Mpr.dll
Vintasoft.Imaging.Dicom.Mpr.UI.dll
Vintasoft.Imaging.Dicom.Mpr.Wpf.UI.dll
Vintasoft.Imaging.Dicom.UI.dll
Vintasoft.Imaging.Dicom.Wpf.UI.dll
Vintasoft.Imaging.Pdf.dll
Vintasoft.Imaging.Pdf.JavaScript.dll
Vintasoft.Imaging.Pdf.UI.dll
Vintasoft.Imaging.Pdf.Wpf.UI.dll

Wenn Sie eine VintaSoft .NET-Assembly lokalisieren möchten, die nicht in der obigen Liste enthalten ist, kontaktieren Sie uns bitte. Wir stellen Ihnen dann die Möglichkeit zur Verfügung, die benötigte VintaSoft .NET-Assembly zu lokalisieren.

Das Installationsprogramm des VintaSoft Imaging .NET SDK liefert Satelliten-Assemblys in deutscher Sprache.Diese Datei befindet sich im Ordner "{SdkInstallPath}\Imaging .NET v12.2\Bin\DotNetX\AnyCPU\de\".

Wenn Sie eine VintaSoft .NET-Assembly aus der obigen Liste lokalisieren möchten, z. B. Vintasoft.Imaging.Pdf.dll, führen Sie die folgenden Schritte aus:

Extrahieren Sie die Ressourcendatei "Vintasoft.Imaging.Pdf.Localization.Strings.resources" mit den konstanten Zeichenfolgen aus der Assembly Vintasoft.Imaging.Pdf.dll.
Hier ist der C#-Code einer .NET-Konsolenanwendung, mit der die Ressourcendatei "Vintasoft.Imaging.Pdf.Localization.Strings.resources" aus der Assembly "Vintasoft.Imaging.Pdf.dll" extrahiert werden kann:

namespace ConsoleApp1
{
    internal class Program
    {
        static void Main(string[] args)
        {
            string dotNetAssemblyFileName = @"D:\VintaSoft\Imaging .NET v12.2\Bin\DotNet7\AnyCPU\Vintasoft.Imaging.Pdf.dll";
            string resourceFileName = "Vintasoft.Imaging.Pdf.Localization.Strings.resources";
            ExtractBinaryResourceFromDotNetAssembly(dotNetAssemblyFileName, resourceFileName);
        }

        static void ExtractBinaryResourceFromDotNetAssembly(string dotNetAssemblyFileName, string resourceFileName)
        {
            System.Reflection.Assembly assembly = System.Reflection.Assembly.LoadFile(dotNetAssemblyFileName);

            System.IO.Stream resourceStream = assembly.GetManifestResourceStream(resourceFileName);

            byte[] resourceStreamBytes = new byte[resourceStream.Length];
            resourceStream.Read(resourceStreamBytes, 0, resourceStreamBytes.Length);

            System.IO.File.WriteAllBytes(resourceFileName, resourceStreamBytes);
        }

    }
}

Konvertieren Sie die extrahierte Ressourcendatei "Vintasoft.Imaging.Pdf.Localization.Strings.resources" in eine .resx-Datei. Dies kann mit dem Dienstprogramm ResGen erfolgen.
Hier ist die Befehlszeile, mit der eine .NET-Binärressourcendatei in eine .resx-Datei konvertiert werden kann:
```
"{Path_to_ResGen.exe_file}\ResGen.exe"  Vintasoft.Imaging.Pdf.Localization.Strings.resources  Strings.resx
```
Erstellen Sie die Datei "Strings.resx" mit konstanten Zeichenfolgen, die in die gewünschte Sprache übersetzt werden, z. B. Spanisch:
- Benennen Sie die Datei "Strings.resx" in "Strings.es.resx" um.
- Öffnen Sie die Datei Strings.es.resx in einem beliebigen Texteditor und übersetzen Sie die Stringkonstanten (Strings in "value"-Tags) vom Englischen ins Spanische.
Erstellen Sie die Satellitenassembly, die die übersetzten Stringkonstanten enthält:
- Erstellen Sie den Ordner "Vintasoft.Imaging.Pdf.es.resources" und wechseln Sie in diesen Ordner.
- Erstellen Sie die Datei "Vintasoft.Imaging.Pdf.csproj" mit einem beliebigen Texteditor und fügen Sie den folgenden Text in die erstellte Datei ein:
```
<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFramework>net7.0</TargetFramework>
    <ImplicitUsings>enable</ImplicitUsings>
    <Nullable>enable</Nullable>
  </PropertyGroup>
</Project>
```
- Erstellen Sie den Ordner "Localization" und wechseln Sie in diesen Ordner.
- Kopieren Sie die Datei Strings.es.resx in den Ordner "Localization".
- Wechseln Sie zum Ordner "Vintasoft.Imaging.Pdf.es.resources".
- Kompilieren Sie das Projekt mit folgendem Befehl:
```
dotnet build Vintasoft.Imaging.Pdf.csproj
```
- Die Satellitenassembly "Vintasoft.Imaging.Pdf.resources.dll" wird im Ordner "bin\Debug\net7.0\es\" erstellt.
Verwenden Sie die Satellitenassembly mit der Assembly "Vintasoft.Imaging.Pdf.dll":
- Erstellen Sie einen Ordner "es" in dem Ordner, in dem sich die Assembly "Vintasoft.Imaging.Pdf.dll" befindet.
- Kopieren Sie die erstellte Satellitenassembly "Vintasoft.Imaging.Pdf.resources.dll" in den Ordner "es".
- Führen Sie die Anwendung aus, die die Assembly Vintasoft.Imaging.Pdf.dll verwendet. Spanischer Text wird angezeigt, wenn Ihr Computer die spanische Gebietsschemaeinstellung verwendet.
- Sie können das Gebietsschema der .NET-Anwendung auch auf Spanisch einstellen, wenn Sie spanischen Text auf einem Computer mit einem anderen Gebietsschema anzeigen möchten.
  Hier ist C#-Code, der zeigt, wie Sie das spanische Gebietsschema für eine .NET-Anwendung festlegen:
```
System.Globalization.CultureInfo.CurrentCulture = new System.Globalization.CultureInfo("es");
System.Globalization.CultureInfo.CurrentUICulture = new System.Globalization.CultureInfo("es");
```

Lokalisieren des VintaSoft WinForms-Demoprojekts

Wenn Sie ein WinForms-Projekt lokalisieren möchten, sollten Sie die folgenden Schritte ausführen:

Lokalisieren der Benutzeroberfläche der WinForms-Formulare, die im Projekt verwendet werden:
- Für jedes WinForms-Formular des Projekts:
  - Öffnen Sie das WinForms-Formular im WinForms-Designer von Visual Studio.
  - Setzen Sie die Eigenschaft "Localizable" des Formulars auf "True".
  - Setzen Sie die Eigenschaft "Language" des Formulars auf die gewünschte Sprache, z. B. Spanisch. Der Designer erstellt daraufhin die Datei "FormName.es.resx", die Informationen zur spanischen Lokalisierung des Formulars enthält.
  - Lokalisieren Sie die UI-Elemente des Formulars. Die Lokalisierungsinformationen werden in der Datei "FormName.es.resx" gespeichert.
Lokalisieren Sie die im Quellcode des Projekts verwendeten Zeichenfolgenkonstanten.
- Erstellen Sie im Projekt einen Ordner "Localization".
- Fügen Sie die Ressourcendatei "Strings.resx" dem Ordner "Localization" hinzu.
- Für jede konstante Zeichenkette im Projektcode:
  - Fügen Sie die konstante Zeichenkette zur Ressourcendatei Strings.resx hinzu.
  - Ersetzen Sie die konstante Zeichenkette im Projektcode durch Code, der auf die konstante Zeichenkette in der Ressourcendatei Strings.resx zugreift.

Alle VintaSoft WinForms-Demoprojekte sind in englischer Sprache lokalisiert.
Das SDK bietet außerdem eine deutsche Lokalisierung für drei VintaSoft WinForms-Demoprojekte (DicomViewerDemo, PdfEditorDemo, SpreadsheetEditorDemo), um zu zeigen, dass VintaSoft WinForms-Demoprojekte in jede beliebige Sprache lokalisiert werden können.

Wenn Sie ein VintaSoft WinForms-Demoprojekt lokalisieren möchten, das bereits lokalisiert ist (z. B. mit deutscher Lokalisierung), sollten Sie die folgenden Schritte ausführen:

Lokalisieren Sie die Benutzeroberfläche der im Projekt verwendeten WinForms-Formulare wie oben in der Anleitung zur Lokalisierung beliebiger WinForms-Projekte beschrieben.
Lokalisieren Sie die im Quellcode des Projekts verwendeten Zeichenfolgenkonstanten.
- Erstellen Sie eine Kopie der Datei "Localization\Strings.resx" => die Dateien "Strings - Copy.resx" und "Strings - Copy.Designer.cs" werden erstellt.
- Löschen Sie die Datei "Strings - Copy.Designer.cs".
- Benennen Sie die Datei "Strings - Copy.resx" in "Strings.es.resx" um.
- Öffnen Sie die Datei "Strings.es.resx" im Ressourcendesigner von Visual Studio und übersetzen Sie die Zeichenfolgenkonstanten vom Englischen ins Spanische.

Wenn Sie ein VintaSoft WinForms-Demoprojekt lokalisieren möchten, das derzeit nicht lokalisiert ist, haben Sie zwei Möglichkeiten.
MÖGLICHKEIT 1: Lokalisieren Sie das VintaSoft WinForms-Demoprojekt wie oben in der Anleitung zur Lokalisierung von WinForms-Projekten beschrieben.
MÖGLICHKEIT 2: Senden Sie uns eine Anfrage zur Lokalisierung des VintaSoft WinForms-Demoprojekts in die gewünschte Sprache. Wir werden versuchen, Sie bei der Lokalisierung zu unterstützen.

Lokalisierung des VintaSoft ASP.NET-Demoprojekts

Jedes VintaSoft ASP.NET-Demoprojekt besteht aus zwei Teilen: JavaScript-UI-Steuerelementen, die die Benutzeroberfläche und die Logik der Webanwendung definieren, und VintaSoft-Webdiensten, die Anfragen von JavaScript-UI-Steuerelementen bearbeiten und Funktionen des VintaSoft Imaging .NET SDK nutzen.

Die VintaSoft ASP.NET Core Document Viewer Demo bietet sofort einsatzbereite Lokalisierungswörterbücher, mit denen der VintaSoft Web-Dokumentenbetrachter in 32 Sprachen (Afrikaans, Arabisch, Belarussisch, Bulgarisch, Chinesisch, Kroatisch, Tschechisch, Dänisch, Niederländisch, Englisch, Finnisch, Französisch, Deutsch, Griechisch, Hebräisch, Hindi, Ungarisch, Italienisch, Japanisch, Koreanisch, Norwegisch, Portugiesisch, Rumänisch, Russisch, Slowakisch, Slowenisch, Spanisch, Suaheli, Schwedisch, Türkisch, Vietnamesisch, Zulu) lokalisiert werden kann. Sie können die sofort einsatzbereite Lokalisierung des VintaSoft Web Document Viewer mit der Online-Version der VintaSoft ASP.NET Core Document Viewer Demo testen. Weitere Informationen zur Lokalisierung des VintaSoft Web Document Viewer finden Sie hier: hier.

Die VintaSoft ASP.NET Spreadsheet Editor Demo bietet sofort einsatzbereite Lokalisierungswörterbücher, mit denen der VintaSoft Web-Tabellenkalkulations-Editor in 32 Sprachen (Afrikaans, Arabisch, Belarussisch, Bulgarisch, Chinesisch, Kroatisch, Tschechisch, Dänisch, Niederländisch, Englisch, Finnisch, Französisch, Deutsch, Griechisch, Hebräisch, Hindi, Ungarisch, Italienisch, Japanisch, Koreanisch, Norwegisch, Portugiesisch, Rumänisch, Russisch, Slowakisch, Slowenisch, Spanisch, Suaheli, Schwedisch, Türkisch, Vietnamesisch, Zulu) lokalisiert werden kann. Sie können die Demo testen. Die sofort einsatzbereite Lokalisierung des VintaSoft Web Document Viewers basiert auf der Online-Version der VintaSoft ASP.NET Core Spreadsheet Editor Demo. Weitere Informationen zur Lokalisierung des VintaSoft Web Spreadsheet Document Editors finden Sie hier.

Die sofort einsatzbereiten Lokalisierungswörterbücher von VintaSoft ASP.Die Demos "NET Core Document Viewer" und "VintaSoft ASP.NET Spreadsheet Editor" können in jedem ASP.NET-Demoprojekt verwendet werden, d. h. Lokalisierungswörterbücher sind in ASP.NET Core, ASP.NET Core + Angular, ASP.NET MVC5 und ASP.NET WebForms nutzbar. Dies ist möglich, da die VintaSoft ASP.NET-Demos denselben JavaScript-Code für alle ASP.NET-Plattformen verwenden.

Wenn Sie die vom VintaSoft-Webdienst zurückgegebenen Zeichenfolgenkonstanten lokalisieren möchten, müssen Sie die VintaSoft .NET-Assembly wie im Abschnitt "Lokalisieren der VintaSoft .NET-Assembly" beschrieben lokalisieren.