Localização de soluções do SharePoint

Artigo
02/25/2013

O processo de preparar seus aplicativos da web para que eles possam ser usados em todo o mundo é conhecido como a localização.A localização estiver convertendo recursos para uma cultura específica.Para obter mais informações, consulte Globalizando e Localizando aplicativos.Este tópico fornece uma visão geral sobre como localizar uma solução do SharePoint.

Para localizar uma solução, você remove as cadeias de caracteres pré-programadas de código e abstrai-as em arquivos de recurso.Um arquivo de recursos é um arquivo com base em XMLcom uma extensão .resx.O arquivo de recurso contém as versões traduzidas de cadeias de caracteres usadas na solução.Para obter mais informações, consulte Recursos em aplicativos.

Observação
Adicione somente recursos de cadeia de caracteres em arquivos de recurso de solução do SharePoint.Embora o editor de recursos permite a você adicionar recursos não-cadeia de caracteres, recursos não-cadeia de caracteres não a implantação do SharePoint.

Arquivos de recursos

Existem três tipos de arquivos de recurso: opção, neutra, e específicos de linguagem.

Tipo de arquivo de recursos	Descrição
Padrão	Também conhecido como um recurso de retorno, arquivos de recurso padrão contêm cadeias de caracteres localizadas para a cultura padrão, como inglês.São usados se nenhum arquivo de recurso localizado para o idioma especificado pode ser encontrado.Os recursos padrão não têm arquivos separados, eles são armazenados no assembly principal do aplicativo.
neutro	Um arquivo de recurso que contém cadeias de caracteres localizados para um idioma, mas não uma cultura específica.Por exemplo, “fr” para francês.
Específico de linguagem	Um arquivo de recurso que contém cadeias de caracteres localizados para um idioma e cultura.Por exemplo, “fr-ca” para o francês canadense.

Para obter mais informações, consulte Organização hierárquica de recursos para localização.

Para especificar arquivos de recurso padrão no SharePoint projetos que você desenvolve em Visual Studio, escolha Idioma Invariável (País Invariável) na lista de cultura da caixa de diálogo de Adicionar Recurso quando você adiciona um arquivo de recurso.

Localizando soluções do Visual Studio SharePoint

Quando você localiza uma solução, você deve considerar todas as informações textuais que sua solução exibe aos usuários.As mensagens informativas, as mensagens de erro, e as cadeias de caracteres de UI devem ser traduzidas e as traduções ser colocadas nos arquivos de recurso.

Cada cadeia de caracteres em um arquivo de recurso possui um identificador exclusivo.Use o mesmo identificador para a cadeia de caracteres convertida em cada arquivo de recurso.Por exemplo, se String1 “” é o identificador para a primeira cadeia de caracteres no arquivo de recurso padrão, use o mesmo identificador para a primeira cadeia de caracteres nos arquivos de recursos específicos da linguagem.

Há três áreas que você localiza normalmente em aplicativos de Visual Studio o SharePoint: recursos, de página ASPX marcação, e código.Para fins da ilustração, as seções a seguir pressupõe que têm uma solução do SharePoint que você deseja localizar em alemão e em japonês.o idioma padrão é inglês.

localizando recursos

Para localizar um recurso, você precisa substituir o título e a descrição embutida de recursos com uma expressão que referencia o título e a cadeia de caracteres traduzidas no arquivo de recursos localizado.Fazer essa alteração em Designer de recursos em Visual Studio.Para obter mais informações, consulte Como: localizar um recurso.

Para localizar seu recurso inglês em alemão e em japonês, você adiciona três itens de projeto Arquivo de recurso ao seu projeto: um para inglês, um para alemão, e um para japonês.Arquivos de recurso de recursos não podem ser usados para localizar a marcação ou código ASPX; arquivos de recurso separados são necessários para eles.

Depois de criar arquivos de recurso de recursos, adicionar-lhes cadeias de caracteres traduzidas.Acessar as cadeias de caracteres localizados com uma expressão no seguinte formato:

$Resources:String ID

Os recursos de recursos em Visual Studio são nomeados sempre Recurso.Se você selecionar um idioma diferente do idioma invariável, uma cultura ID é adicionada ao nome do arquivo de recurso. Por exemplo, se você adicionar um arquivo de recurso (padrão) invariável de recursos de linguagem, é denominado Resources.resx.Se você adicionar um recurso específico de linguagem de recurso selecionando uma cultura do Japão japonês (), o arquivo é chamado Resources.ja-JP.resx.Os nomes de arquivo de recurso são atribuídos automaticamente e não podem ser alterados.

O escopo de recursos de recurso é local para o recurso que são adicionados ao.Para criar recursos que podem ser usados por qualquer arquivo de recurso ou de elemento na solução, adicione um item de projeto de Recursos globais Arquivo em vez de um recurso Arquivo de recurso.O item de projeto de Recursos globais Arquivo está localizado na pasta de 2010 em SharePoint na caixa de diálogo de Adicionar novo item .Arquivos de recursos globais implanta a pasta \ os recursos da pasta raiz do SharePoint.

Para obter mais informações, consulte Passo a passo: Localizando um aplicativo do SharePoint Visual Studio.

Localizando a marcação da página ASPX

Para localizar páginas de ASP.NET , você adiciona três itens de projeto Arquivo de recursos para seu projeto: um para inglês, um para alemão, e um para japonês. Se você não precisa encontrar o código além do que a marcação em vez de isso, você pode adicionar arquivos de recursos globais.

Forneça um nome para o arquivo de recursos de linguagem padrão.Dê a arquivos de recurso localizado o mesmo nome concatenado com a cultura específica da linguagem ID.Por exemplo, MyAppResources.de-DE.resx para alemão e MyAppResources.ja-JP.resx para japonês.

Defina a propriedade de Tipo de implantação de cada arquivo de recurso a AppGlobalResource.Isso faz com que os arquivos de recurso implantem a pasta App_GlobalResources, onde estão disponíveis para todas as páginas e a controles ASPX na solução.A pasta App_GlobalResources está localizada no C:\inetpub\wwwroot\wss\VirtualDirectories\<port number>\ App_GlobalResources.

Observação
Se você usa arquivos de recurso globais, não movê-los na pasta do item de projeto para ativar a propriedade do tipo de implantação e outras propriedades SharePoint- específicas.

Arquivos de recurso de marcação ASPX também podem ser usados para localizar o código.Se você estiver usando recursos para localizar o código além do que a marcação ASPX, deixe a configuração da propriedade de ação de compilação de cada arquivo como o recurso inserido para fazer com que o recurso compila em um assembly satélite.Em o entanto, se você estiver usando arquivos de recurso para localizar apenas a marcação, você pode opcionalmente alterar a ação de compilação satisfazer para impedir que o arquivo é compilado no assembly principal do aplicativo.

Substitua todas as cadeias de caracteres pré-programadas de propriedade em suas páginas ASPX controle e a marcação com uma expressão no seguinte formato:

<asp:<class> runat="server" Text="<%$Resources:<Resource File Name>, <String ID>%>" />

Por exemplo:

<asp:Button ID="btn1" runat="server" onclick="btn1_Click" Text="<%$Resources:Resource1,String7%>"></asp:Button>

Para ASPX como texto, use uma expressão no seguinte formato:

<asp:literal ID="<ID>" runat="server" Text="<%$Resources:<Resource File Name>, <String ID>%>" />

Por exemplo:

<asp:literal ID="Literal1" runat="server" Text="<%$Resources:Resource1, String9%>" />

Para obter mais informações, consulte Como: localizar ASPX marcação e Passo a passo: Localizando um aplicativo do SharePoint Visual Studio.

localizando o código

Além da localização de cadeias de caracteres de recurso e de marcação de ASP.NET , você também precisará localizar as cadeias de mensagem e cadeias de erro que aparecem no seu código de solução.Informativos localizados e mensagens de erro estão contidos em assemblies satélite. Módulos satélite contêm cadeias de caracteres que são visíveis aos usuários, como mensagens de texto de UI e saída como exceções.

Visual Studio usa o modelo padrão do hub e spoke do .NET Framework.O hub, ou o assembly principal do programa, contêm os recursos de linguagem padrão.Os raios, ou assemblies satélite, contêm os recursos específicos da linguagem.Para obter mais informações, consulte empacotando e implantando recursos.Módulos satélite são compilados dos arquivos de recurso (.resx).Quando você adiciona arquivos de recursos específicos do idioma para o seu projeto e o pacote de solução, Visual Studio compila os arquivos de recurso assemblies satélite nomeados Nome do Projeto.resources.dll.

Como com marcação ASPX, localize o código do aplicativo do SharePoint adicionando itens separados do Arquivo de recursos para seu projeto; um para o idioma padrão e um para cada idioma localizado.Em o entanto, como mencionado anteriormente, se você já tiver arquivos de recurso para localizar a marcação ASPX, você pode reutilizá-los para localizar o código.Se você precisará criar arquivos de recurso, dê o arquivo de recurso de linguagem padrão um nome de sua escolha acrescentado com uma extensão .resx.Nomeie os arquivos de recurso localizado o mesmo nome concatenado com a cultura específica da linguagem ID.Defina a propriedade da ação de compilação de cada arquivo de recurso para o recurso inserido para permitir a criação de conjuntos de recursos de satélite.

Para criar assemblies satélite, compilar o projeto e então adicione os arquivos como conjuntos adicionais através da guia de Avançado de Designer de pacote.A o adicionar conjuntos, preceda de ID uma pasta de cultura para o caminho local, como de-de \Projeta o nome do item.resources.dll.Isso permite que o pacote contém os arquivos que têm o mesmo nome.

Em seu código, substitua cadeias de caracteres pré-programadas com chamadas para o método de GetGlobalResourceObject usando a seguinte sintaxe:

HttpContext.GetGlobalResourceObject("<Resource File Name>", "<String ID>")

Para obter mais informações, consulte Como: Localize o código e Passo a passo: Localizando um aplicativo do SharePoint Visual Studio.

Localização de código de Web parts

As partes Web incluem um recurso editor personalizado de propriedade que inclui os atributos de código usando cadeias de caracteres pré-programadas, como WebDisplayName, categoria, e o WebDescription.Para substituir os valores da cadeia de caracteres para esses atributos, crie uma classe separada que deriva da classe de atributos.Em essas classes, defina a propriedade do atributo.A propriedade do atributo depende da classe base.Por exemplo, a propriedade do atributo de WebDisplayName é DisplayNameValue e a propriedade do atributo de WebDescription é DescriptionValue.

Em a classe derivada, fazer referência a identificação de cadeia de caracteres do arquivo de recurso e do objeto de ResourceManager para obter o valor localizado para a identificação de cadeia de caracteresRetornar esse valor para o atributo do editor de propriedades.Para obter mais informações, consulte Passo a passo: Localizando um aplicativo do SharePoint Visual Studio.