Localizzare VintaSoft Imaging .NET SDK in qualsiasi lingua

VintaSoft Imaging .NET SDK può può essere localizzato in qualsiasi lingua.

L'SDK include assembly VintaSoft .NET localizzati e progetti demo VintaSoft WinForms, localizzati in lingua tedesca, a dimostrazione del fatto che l'SDK può essere localizzato in qualsiasi lingua.

L'SDK include anche progetti demo VintaSoft ASP.NET Core localizzati, localizzati in 32 lingue, a dimostrazione del fatto che la soluzione SDK per il Web può essere localizzata in qualsiasi lingua.

Se si desidera localizzare le costanti stringa e i controlli dell'interfaccia utente dell'assembly VintaSoft .NET, leggere le istruzioni nella sezione "Localizzare l'assembly VintaSoft .NET" di questo articolo.

Se si desidera localizzare le costanti stringa e l'interfaccia utente del progetto demo VintaSoft WinForms, leggere le istruzioni nella sezione "Localizzare il progetto demo VintaSoft WinForms" di questo articolo.

Se desideri localizzare le costanti stringa e l'interfaccia utente del progetto demo VintaSoft ASP.NET, leggi come fare nella sezione "Localizzare il progetto demo VintaSoft ASP.NET" di questo articolo.

Localizzare l'assembly VintaSoft .NET

Tutti gli assembly VintaSoft .NET sono localizzati in lingua inglese.

Inoltre, VintaSoft Imaging .NET SDK offre la possibilità di localizzare i seguenti assembly VintaSoft .NET (utilizzando assembly di risorse satellite) in qualsiasi lingua:

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

Se desideri localizzare un assembly Vintasoft .NET non presente nell'elenco sopra, faccelo sapere e ti daremo la possibilità di localizzare l'assembly Vintasoft .NET necessario.

Il programma di installazione di VintaSoft Imaging .NET SDK fornisce assembly satellite in lingua tedesca, che possono essere trovati nella cartella "{SdkInstallPath}\Imaging .NET v12.2\Bin\DotNetX\AnyCPU\de\".

Se si desidera localizzare un assembly VintaSoft .NET dall'elenco precedente, ad esempio Vintasoft.Imaging.Pdf.dll, è necessario procedere come segue:

Estrarre il file di risorse "Vintasoft.Imaging.Pdf.Localization.Strings.resources" con stringhe costanti dall'assembly Vintasoft.Imaging.Pdf.dll.
Ecco il codice C# dell'applicazione console .NET che permette di estrarre il file di risorse "Vintasoft.Imaging.Pdf.Localization.Strings.resources" dall'assembly Vintasoft.Imaging.Pdf.dll:

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);
        }

    }
}

Converti il file di risorse "Vintasoft.Imaging.Pdf.Localization.Strings.resources" estratto in un file .resx. Questa operazione può essere eseguita utilizzando l'utilità ResGen.
Ecco la riga di comando che permette di convertire il file di risorse binario .NET in un file .resx:
```
"{Path_to_ResGen.exe_file}\ResGen.exe"  Vintasoft.Imaging.Pdf.Localization.Strings.resources  Strings.resx
```
Crea il file Strings.resx con stringhe costanti, che vengono tradotte nella lingua desiderata, ad esempio in spagnolo:
- Rinomina il file String.resx in Strings.es.resx.
- Aprire il file Strings.es.resx in un qualsiasi editor di testo e tradurre le costanti stringa (stringhe nei tag "value") dalla lingua inglese alla lingua spagnola.
Creare l'assembly satellite contenente le stringhe costanti tradotte:
- Creare la cartella "Vintasoft.Imaging.Pdf.es.resources" e accedervi.
- Creare il file "Vintasoft.Imaging.Pdf.csproj" utilizzando un qualsiasi editor di testo e aggiungere il seguente testo al file creato:
```
<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFramework>net7.0</TargetFramework>
    <ImplicitUsings>enable</ImplicitUsings>
    <Nullable>enable</Nullable>
  </PropertyGroup>
</Project>
```
- Creare la cartella "Localization" e accedervi.
- Copiare il file Strings.es.resx nella cartella "Localization".
- Andare alla cartella "Vintasoft.Imaging.Pdf.es.resources".
- Compila il progetto usando il seguente comando:
```
dotnet build Vintasoft.Imaging.Pdf.csproj
```
- L'assembly satellite "Vintasoft.Imaging.Pdf.resources.dll" verrà creato nella cartella "bin\Debug\net7.0\es\".
Utilizza l'assembly satellite con l'assembly Vintasoft.Imaging.Pdf.dll:
- Crea la cartella "es" nella cartella in cui si trova l'assembly Vintasoft.Imaging.Pdf.dll.
- Copia l'assembly satellite creato "Vintasoft.Imaging.Pdf.resources.dll" nella cartella "es".
- Esegui l'applicazione che utilizza l'assembly Vintasoft.Imaging.Pdf.dll e, se il computer utilizza impostazioni locali spagnole, verrà visualizzato del testo in spagnolo.
- Inoltre, puoi impostare le impostazioni locali dell'applicazione .NET su impostazioni locali spagnole se desideri visualizzare testo in spagnolo su un computer che utilizza impostazioni locali diverse dallo spagnolo.
  Ecco il codice C# che mostra come impostare le impostazioni locali in spagnolo per l'applicazione .NET:
```
System.Globalization.CultureInfo.CurrentCulture = new System.Globalization.CultureInfo("es");
System.Globalization.CultureInfo.CurrentUICulture = new System.Globalization.CultureInfo("es");
```

Localizzazione del progetto demo VintaSoft WinForms

Se si desidera localizzare un progetto WinForms, procedere come segue:

Localizzazione dell'interfaccia utente dei moduli WinForms, utilizzata nel progetto:
- Per ciascun modulo WinForms del progetto:
  - Aprire il modulo WinForms nella finestra di progettazione WinForms di Visual Studio.
  - Impostare la proprietà "Localizzabile" del modulo su True.
  - Impostare la proprietà "Lingua" del modulo sulla lingua desiderata, ad esempio spagnolo, => la finestra di progettazione creerà il file FormName.es.resx contenente informazioni sulla localizzazione in spagnolo del modulo.
  - Localizza gli elementi dell'interfaccia utente del modulo e le informazioni sulla localizzazione verranno salvate nel file FormName.es.resx.
Localizza le costanti stringa utilizzate nei codici sorgente del progetto:
- Crea la cartella "Localization" nel progetto.
- Aggiungi il file di risorse con nome "Strings.resx" alla cartella "Localization".
- Per ogni stringa costante nel codice del progetto:
  - Aggiungi la stringa costante al file di risorse Strings.resx.
  - Sostituisci la stringa costante nel codice del progetto con il codice che accede alla stringa costante nel file di risorse Strings.resx.

Tutti i progetti demo VintaSoft WinForms sono localizzati in lingua inglese.
Inoltre, l'SDK fornisce la localizzazione in tedesco per 3 progetti demo di VintaSoft WinForms (DicomViewerDemo, PdfEditorDemo, SpreadsheetEditorDemo) come esempio che mostra che i progetti demo di VintaSoft WinForms possono essere localizzati in qualsiasi lingua.

Se si desidera localizzare un progetto demo di VintaSoft WinForms, che è già localizzato (ad esempio ha la localizzazione in tedesco), è necessario procedere come segue:

Localizza l'interfaccia utente dei moduli WinForms,che vengono utilizzati nel progetto, come descritto sopra nelle istruzioni per la localizzazione di qualsiasi progetto WinForms.
Localizza le costanti stringa utilizzate nei codici sorgente del progetto:
- Crea una copia del file "Localization\Strings.resx" => Verranno creati i file "Strings - Copy.resx" e "Strings - Copy.Designer.cs".
- Elimina il file "Strings - Copy.Designer.cs".
- Rinomina il file "Strings - Copy.resx" in "Strings.es.resx".
- Apri il file "Strings.es.resx" in Resource Designer di Visual Studio e traduci le costanti stringa dall'inglese allo spagnolo.

Se vuoi localizzare un progetto demo VintaSoft WinForms, che al momento non è localizzato, puoi procedere in due modi.
MODO 1: Localizzare il progetto demo VintaSoft WinForms seguendo le istruzioni sopra riportate per la localizzazione di qualsiasi progetto WinForms.
MODO 2: Inviateci una richiesta per localizzare il progetto demo VintaSoft WinForms nella lingua desiderata e cercheremo di aiutarvi con la localizzazione.

Localizzare il progetto demo VintaSoft ASP.NET

Ogni progetto demo VintaSoft ASP.NET è costituito da due parti: controlli dell'interfaccia utente JavaScript, che definiscono l'interfaccia utente e la logica dell'applicazione Web, e servizi Web VintaSoft, che gestiscono le richieste dai controlli dell'interfaccia utente JavaScript e utilizzano le funzionalità di VintaSoft Imaging .NET SDK.

"VintaSoft ASP.NET Core Document Viewer Demo" fornisce dizionari di localizzazione pronti all'uso, che consentono di localizzare il visualizzatore di documenti web VintaSoft in 32 lingue (afrikaans, arabo, Bielorusso, Bulgaro, Cinese, Croato, Ceco, Danese, Olandese, Inglese, Finlandese, Francese, Tedesco, Greco, Ebraico, Hindi, Ungherese, Italiano, Giapponese, Coreano, Norvegese,Portoghese, rumeno, russo, slovacco, sloveno, spagnolo, swahili, svedese, turco, vietnamita, zulu). È possibile testare la localizzazione pronta all'uso di VintaSoft Web Document Viewer utilizzando la versione online di "VintaSoft ASP.NET Core Document Viewer Demo". Ulteriori informazioni sulla localizzazione di VintaSoft Web Document Viewer sono disponibili qui.

"VintaSoft ASP.NET Spreadsheet Editor Demo" fornisce dizionari di localizzazione pronti all'uso, che consentono di localizzare l'editor di fogli di calcolo web VintaSoft in 32 lingue (afrikaans, arabo, bielorusso, bulgaro, cinese, croato, ceco, danese, olandese, inglese, finlandese, francese, tedesco, greco, ebraico, hindi, ungherese, italiano, giapponese, coreano, norvegese, portoghese, rumeno, russo, slovacco, sloveno, spagnolo, swahili, svedese, turco, vietnamita, zulu). È possibile testare la localizzazione pronta all'uso di VintaSoft Web Document Viewer utilizzando la versione online di "VintaSoft ASP.NET Core Spreadsheet Editor Demo". Ulteriori informazioni sulla localizzazione di VintaSoft Web Spreadsheet Document Editor sono disponibili qui.

I dizionari di localizzazione pronti all'uso di "VintaSoft ASP.NET Core Document Viewer Demo" e "VintaSoft ASP.NET Spreadsheet Editor Demo" possono essere utilizzati in qualsiasi progetto demo ASP.NET, ovvero i dizionari di localizzazione possono essere utilizzati in ASP.NET Core, ASP.NET Core + Angular, ASP.NET MVC5 e ASP.NET WebForms. Ciò è possibile perché le applicazioni demo VintaSoft ASP.NET utilizzano lo stesso codice JavaScript per tutte le piattaforme ASP.NET.

Se si desidera localizzare le costanti stringa restituite dal servizio Web VintaSoft, è necessario localizzare l'assembly VintaSoft .NET come descritto nella sezione "Localizzazione dell'assembly VintaSoft .NET".