Localize o VintaSoft Imaging .NET SDK para qualquer idioma

O VintaSoft Imaging .NET SDK pode ser localizado para qualquer idioma.

O SDK inclui assemblies .NET do VintaSoft e projetos de demonstração do VintaSoft WinForms localizados para o idioma alemão, como exemplo, mostrando que o SDK pode ser localizado para qualquer idioma.

O SDK também inclui projetos de demonstração "VintaSoft ASP.NET Core" localizados em 32 idiomas, como exemplo de que a solução SDK para web pode ser localizada para qualquer idioma.

Se você deseja localizar constantes de string e controles de interface do usuário do assembly .NET da VintaSoft, leia como fazer isso na seção "Localizar assembly .NET da VintaSoft" deste artigo.

Se você deseja localizar constantes de string e a interface do usuário do projeto de demonstração WinForms da VintaSoft, leia como fazer isso na seção "Localizar projeto de demonstração WinForms da VintaSoft" deste artigo.

Se você deseja localizar constantes de string e a interface do usuário do projeto de demonstração ASP.NET da VintaSoft, leia como fazer isso na seção "Localizar projeto de demonstração ASP.NET da VintaSoft" deste artigo.

Localizar assembly .NET da VintaSoft

Todos os assemblies .NET da VintaSoft possuem localização em inglês.

O VintaSoft Imaging .NET SDK também oferece a capacidade de localizar os seguintes assemblies VintaSoft .NET (usando assemblies de recursos satélite) para qualquer idioma:

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 você quiser localizar um assembly Vintasoft .NET que não esteja presente na lista acima,Informe-nos e providenciaremos a localização do assembly .NET da Vintasoft necessário.

O instalador do VintaSoft Imaging .NET SDK fornece assemblies auxiliares em alemão, que podem ser encontrados na pasta "{SdkInstallPath}\Imaging .NET v12.2\Bin\DotNetX\AnyCPU\de\".

Se você deseja localizar um assembly .NET da VintaSoft da lista acima, por exemplo, Vintasoft.Imaging.Pdf.dll, siga os passos abaixo:

Extraia o arquivo de recursos "Vintasoft.Imaging.Pdf.Localization.Strings.resources" com as strings constantes do assembly Vintasoft.Imaging.Pdf.dll.
Aqui está o código C# de um aplicativo de console .NET que permite extrair o arquivo de recursos "Vintasoft.Imaging.Pdf.Localization.Strings.resources" do 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);
        }

    }
}

Converta o arquivo de recursos "Vintasoft.Imaging.Pdf.Localization.Strings.resources" extraído em um arquivo .resx. Isso pode ser feito usando o utilitário ResGen.
Aqui está a linha de comando que permite converter um arquivo de recurso binário .NET em um arquivo .resx:
```
"{Path_to_ResGen.exe_file}\ResGen.exe"  Vintasoft.Imaging.Pdf.Localization.Strings.resources  Strings.resx
```
Crie um arquivo Strings.resx com strings constantes, que são traduzidas para o idioma necessário, por exemplo, espanhol:
- Renomeie o arquivo Strings.resx para Strings.es.resx.
- Abra o arquivo Strings.es.resx em qualquer editor de texto e traduza as constantes de string (strings em tags "value") do inglês para o espanhol.
Crie o conjunto satélite que contém as strings constantes traduzidas:
- Crie a pasta "Vintasoft.Imaging.Pdf.es.resources" e acesse-a.
- Crie o arquivo "Vintasoft.Imaging.Pdf.csproj" usando qualquer editor de texto e adicione o seguinte texto ao arquivo criado:
```
<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFramework>net7.0</TargetFramework>
    <ImplicitUsings>enable</ImplicitUsings>
    <Nullable>enable</Nullable>
  </PropertyGroup>
</Project>
```
- Crie a pasta "Localization" e acesse-a.
- Copie o arquivo Strings.es.resx para a pasta "Localization".
- Acesse a pasta "Vintasoft.Imaging.Pdf.es.resources".
- Compile o projeto usando o seguinte comando:
```
dotnet build Vintasoft.Imaging.Pdf.csproj
```
- O assembly satélite "Vintasoft.Imaging.Pdf.resources.dll" será criado na pasta "bin\Debug\net7.0\es\".
Use o assembly satélite com o assembly Vintasoft.Imaging.Pdf.dll:
- Crie a pasta "es" na pasta onde o assembly Vintasoft.Imaging.Pdf.dll está localizado.
- Copie o arquivo de montagem do satélite criado, "Vintasoft.Imaging.Pdf.resources.dll", para a pasta "pt".
- Execute o aplicativo, que usa o assembly Vintasoft.Imaging.Pdf.dll, e você verá o texto em espanhol se o seu computador estiver configurado para o idioma espanhol.
- Você também pode definir a configuração regional do aplicativo .NET para o espanhol se quiser ver o texto em espanhol em um computador que não esteja configurado para o espanhol.
  Aqui está o código C# que mostra como definir a configuração regional para o espanhol em um aplicativo .NET:
```
System.Globalization.CultureInfo.CurrentCulture = new System.Globalization.CultureInfo("es");
System.Globalization.CultureInfo.CurrentUICulture = new System.Globalization.CultureInfo("es");
```

Localizar o projeto de demonstração WinForms da VintaSoft

Se você deseja localizar um projeto WinForms, siga estas etapas:

Localizar a interface do usuário dos formulários WinForms usados no projeto:
- Para cada formulário WinForms do projeto:
  - Abra o formulário WinForms no designer WinForms do Visual Studio.
  - Defina a propriedade "Localizable" do formulário como True.
  - Defina a propriedade "Language" do formulário para o idioma desejado, por exemplo, espanhol, => o designer criará o arquivo FormName.es.resx que contém informações sobre a localização do formulário em espanhol.
  - Localizar os elementos da interface do usuário do formulário. As informações sobre a localização serão salvas no arquivo FormName.es.resx.
Localizar as constantes de string usadas nos códigos-fonte do projeto:
- Criar a pasta "Localization" no projeto.
- Adicionar o arquivo de recursos com o nome "Strings.resx" à pasta "Localization".
- Para cada constante de string no código do projeto:
  - Adicionar a constante de string ao arquivo de recursos Strings.resx.
  - Substituir a constante de string no código do projeto pelo código que acessa a constante de string no arquivo de recursos Strings.resx.

Todos os projetos de demonstração do VintaSoft WinForms possuem localização em inglês.
O SDK também fornece localização em alemão para 3 projetos de demonstração do VintaSoft WinForms (DicomViewerDemo, PdfEditorDemo, SpreadsheetEditorDemo) como exemplo, mostrando que os projetos de demonstração do VintaSoft WinForms podem ser localizados para qualquer idioma.

Se você deseja localizar um projeto de demonstração do VintaSoft WinForms que já esteja localizado (por exemplo, com localização em alemão), siga os passos abaixo:

Localize a interface do usuário dos formulários WinForms usados no projeto, conforme descrito acima nas instruções para localização de qualquer projeto WinForms.
Localizar as constantes de string usadas nos códigos-fonte do projeto:
- Crie uma cópia do arquivo "Localization\Strings.resx" => Os arquivos "Strings - Copy.resx" e "Strings - Copy.Designer.cs" serão criados.
- Exclua o arquivo "Strings - Copy.Designer.cs".
- Renomeie o arquivo "Strings - Copy.resx" para "Strings.es.resx".
- Abra o arquivo "Strings.es.resx" no designer de recursos do Visual Studio e traduza as constantes de string do inglês para o espanhol.

Se você deseja localizar um projeto de demonstração WinForms da VintaSoft que ainda não está localizado, você pode seguir dois caminhos.
MÉTODO 1: Localize o projeto de demonstração WinForms da VintaSoft conforme as instruções acima para localização de qualquer projeto WinForms.
MÉTODO 2: Envie-nos uma solicitação para localizar o projeto de demonstração WinForms da VintaSoft para o idioma desejado e tentaremos ajudá-lo com a localização.

Localizar o projeto de demonstração ASP.NET da VintaSoft

Cada projeto de demonstração ASP.NET da VintaSoft consiste em duas partes: controles de interface do usuário JavaScript, que definem a interface e a lógica do aplicativo web, e serviços web da VintaSoft, que atendem às solicitações dos controles de interface do usuário JavaScript e utilizam a funcionalidade do VintaSoft Imaging .NET SDK.

O VintaSoft ASP.NET Core Document Viewer Demo fornece dicionários de localização prontos para uso, que permitem localizar o visualizador de documentos web VintaSoft em 32 idiomas (africâner, árabe, bielorrusso, búlgaro, chinês, croata, tcheco, dinamarquês, holandês, inglês, finlandês, francês, alemão, grego, hebraico, hindi, húngaro, italiano, japonês, coreano, norueguês, português, romeno, russo, eslovaco, esloveno, espanhol, suaíli, sueco, turco, vietnamita, zulu). Você pode testar a localização pronta para uso do VintaSoft Web Document Viewer usando a versão online do VintaSoft ASP.NET Core Document Viewer Demo. Mais informações sobre a localização do VintaSoft Web Document Viewer podem ser encontradas aqui.

O aplicativo de demonstração "VintaSoft ASP.NET Spreadsheet Editor Demo" fornece dicionários de localização prontos para uso, que permitem localizar o VintaSoft web spreadsheet document editor em 32 idiomas (africâner, árabe, bielorrusso, búlgaro, chinês, croata, tcheco, dinamarquês, holandês, inglês, finlandês, francês, alemão, grego, hebraico, hindi, húngaro, italiano, japonês, coreano, norueguês, português, romeno, russo, eslovaco, esloveno, espanhol, suaíli, sueco, turco, vietnamita, zulu). Você pode testar a localização pronta para uso do VintaSoft Web Document Viewer usando a versão online do VintaSoft ASP.NET Core Spreadsheet Editor Demo. Mais informações sobre a localização do VintaSoft Web Spreadsheet Document Editor podem ser encontradas aqui.

Os dicionários de localização prontos para uso do VintaSoft ASP.NET Core Document Viewer Demo e do VintaSoft ASP.NET Spreadsheet Editor Demo podem ser usados em qualquer projeto de demonstração ASP.NET, ou seja, os dicionários de localização podem ser usados em ASP.NET Core, ASP.NET Core + Angular, ASP.NET MVC5 e ASP.NET WebForms. Isso é possível porque as demonstrações ASP.NET da VintaSoft usam o mesmo código JavaScript para todas as plataformas ASP.NET.

Se você quiser localizar as constantes de string retornadas pelo serviço web da VintaSoft, você deve localizar o assembly .NET da VintaSoft conforme descrito na seção "Localizar o assembly .NET da VintaSoft".