Como: Localizar códigoHow to: Localize code

O código não local usa valores de cadeia de caracteres embutidos em código.Unlocalized code uses hard-coded string values. Para localizar cadeias de caracteres de código, substitua-as por chamadas para GetGlobalResourceObject , que é um método que faz referência a recursos localizados.To localize code strings, replace them with calls to GetGlobalResourceObject, which is a method that references localized resources.

Código de localizaçãoLocalize code

Para localizar o códigoTo localize code

  1. No Gerenciador de soluções, abra o menu de atalho para um item de projeto e escolha Adicionar > módulo.In Solution Explorer, open the shortcut menu for a project item, and then choose Add > Module.

    Escolha o modelo de arquivo de recursos .Choose the Resources File template.

    Observação

    Certifique-se de adicionar o arquivo de recurso a um item de projeto do SharePoint para que a propriedade do tipo de implantação esteja disponível.Be sure to add the resource file to a SharePoint project item so that the Deployment Type property is available. Essa propriedade é necessária posteriormente neste procedimento.This property is required later in this procedure.

  2. Dê ao arquivo de recurso de idioma padrão um nome de sua escolha anexado com uma extensão . resx , como MyAppResources. resx.Give the default language resource file a name of your choice appended with a .resx extension, such as MyAppResources.resx.

  3. Repita as etapas 1 e 2 para adicionar arquivos de recurso separados ao item de projeto do SharePoint: um para cada idioma localizado.Repeat steps 1 and 2 to add separate resource files to the SharePoint project item: one for each localized language.

    Use o mesmo nome base para cada arquivo de recurso localizado, mas adicione a ID de cultura.Use the same base name for each localized resource file, but add the culture ID. Por exemplo, nomeie um recurso localizado em alemão MyAppResources.de-de. resx.For example, name a German localized resource MyAppResources.de-DE.resx.

  4. Abra cada arquivo de recurso e adicione cadeias de caracteres localizadas.Open each resource file and add localized strings. Use as mesmas IDs de cadeia de caracteres em cada arquivo.Use the same string IDs in each file.

  5. Altere o valor da propriedade tipo de implantação de cada arquivo de recurso para AppGlobalResource para fazer com que cada arquivo seja implantado na pasta App_GlobalResources do servidor.Change the value of the Deployment Type property of each resource file to AppGlobalResource to cause each file to deploy to the server's App_GlobalResources folder.

  6. Deixe o valor da propriedade criar ação de cada arquivo como recurso incorporado.Leave the value of the Build Action property of each file as Embedded Resource.

    Os recursos inseridos são compilados na DLL do projeto.Embedded resources are compiled into the project's DLL.

  7. Compile o projeto para criar as DLLs de satélite de recurso.Build the project to create the resource satellite DLLs.

  8. No Designer de pacotes, escolha a guia avançado e, em seguida, adicione o assembly satélite.In the Package Designer, choose the Advanced tab, and then add the satellite assembly.

  9. Na caixa local , preceda uma pasta de ID de cultura para o caminho do local, como de \ <Project Item Name>.resources.dll.In the Location box, prepend a culture ID folder to the Location path, such as de-DE\<Project Item Name>.resources.dll.

  10. Se sua solução ainda não fizer referência ao assembly System. Web, adicione uma referência a ele e adicione uma diretiva em seu código para System.Web .If your solution does not already reference the System.Web assembly, add a reference to it, and add a directive in your code to System.Web.

  11. Localize todas as cadeias de caracteres embutidas em código em seu código que são visíveis para os usuários, como texto da interface do usuário, erros e texto da mensagem.Locate all hard-coded strings in your code that are visible to users, such as UI text, errors, and message text. Substitua-os por uma chamada para o GetGlobalResourceObject método usando a seguinte sintaxe:Replace them with a call to the GetGlobalResourceObject method using the following syntax:

    HttpContext.GetGlobalResourceObject("Resource File Name", "String ID")
    
  12. Escolha a tecla F5 para compilar e executar o aplicativo.Choose the F5 key to build and run the application.

  13. No SharePoint, altere o idioma de exibição do padrão.In SharePoint, change the display language from the default.

    As cadeias de caracteres localizadas aparecem no aplicativo.The localized strings appear in the application. Para exibir recursos localizados, o servidor do SharePoint deve ter um pacote de idiomas instalado que corresponda à cultura do arquivo de recurso.To display localized resources, the SharePoint server must have a language pack installed that matches the resource file's culture.

Confira tambémSee also