A localização de soluções do SharePoint

Artigo
08/08/2011

O processo de preparação de seus aplicativos para que possa ser usados em todo o mundo é conhecido como localização. Localização está convertendo os recursos para uma cultura específica. Para obter mais informações, consulte Globalizando e Localizando Aplicativos. Este tópico fornece uma visão geral de como localizar uma solução do SharePoint.

Para localizar uma solução, você pode remove strings codificadas do código e abstrai-los em arquivos de recursos. Um arquivo de recurso é um XML-com base em arquivo com uma extensão. resx. O arquivo de recurso contém as versões traduzidas as seqüências de caracteres usados na sua solução. Para obter mais informações, consulte recursos em aplicativos.

Observação
Adicione somente os recursos de seqüência de caracteres para arquivos de recurso de solução do SharePoint. Embora o Editor de recursos permite que você adicione recursos de seqüência de caracteres não, os recursos de seqüência de caracteres não não implantar no SharePoint.

Arquivos de recursos

Existem três tipos de arquivos de recurso: padrão, idioma neutro e específico do idioma.

Tipo de arquivo de recurso	Descrição
Padrão	Também conhecido como um recurso de fallback, arquivos de recurso padrão contêm seqüências de caracteres localizadas para a cultura padrão, como o inglês. Eles são usados se nenhum arquivo de recurso localizado para o idioma especificado pode ser encontrado. Recursos padrão não tem arquivos separados, eles são armazenados no aplicativo assembly principal.
Neutralidade de idioma	Um arquivo de recurso contém seqüências de caracteres localizadas para um idioma, mas não uma cultura específica. Por exemplo, "fr" para o francês.
Específicos do idioma	Um arquivo de recurso contém seqüências de caracteres localizadas para um idioma e uma 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 os arquivos de recursos padrão em Visual Studio projetos do SharePoint, selecione Idioma invariável (País Invariável) na lista de cultura do Add Resource caixa de diálogo quando você adicionar um arquivo de recurso.

Localizando Visual Studio soluções do SharePoint

Quando você localizar uma solução, você deve considerar todas as informações textuais que sua solução exibe aos usuários. Mensagens informativas, mensagens de erro, e UI cadeias de caracteres devem ser convertidas e essas traduções são colocados em arquivos de recurso.

Cada seqüência em um arquivo de recurso tem um identificador exclusivo. Use o mesmo identificador de seqüência de caracteres traduzidas em cada arquivo de recurso. Por exemplo, se "string1" é o identificador para o primeiro string no arquivo de recurso padrão, use o mesmo identificador para a primeira seqüência de arquivos de recursos de idioma específico.

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

Localizando recursos

Para localizar um recurso, que você tem que substituir o embutido de título e descrição do recurso com uma expressão que faz referência o título traduzido e a seqüência de caracteres no arquivo de recursos localizados. Essa alteração no Recurso Designer na Visual Studio. Para obter mais informações, consulte Como: Localizar um recurso..

Para localizar o recurso de inglês em alemão e japonês, você pode adicionar três itens de projeto do arquivo de recurso ao seu projeto: uma para o inglês, uma para o alemão e outra para japonês. Arquivos de recurso do recurso não podem ser usados para localizar a marcação ASPX ou código; arquivos de recurso separado são necessários para eles.

Depois de criar o recurso de arquivos de recurso, adicione cadeias de caracteres traduzidas para eles. Acesse as strings localizadas com uma expressão no seguinte formato:

$Resources:String ID

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

O escopo dos recursos do recurso é local para o recurso que são adicionados ao. Para criar os recursos que podem ser usados por qualquer arquivo de recurso ou elemento na solução, adicione um Arquivo de recursos Global item de projeto em vez de um arquivo de recurso do recurso. O Arquivo de recursos globais item de projeto está localizado na 2010 pasta sob SharePoint no Add New Item caixa de diálogo. Os arquivos de recursos globais implantar na pasta \Resources na pasta raiz do SharePoint.

Para obter mais informações, consulte Demonstra Passo a passo: A localização de um aplicativo do SharePoint de Visual Studio.

Localizando a marcação da página ASPX

Para localizar ASP.NET páginas, você adicionar três itens de projeto de arquivo de recursos ao seu projeto: uma para o inglês, uma para o alemão e outra para japonês. Se você não tem de localizar o código, além de marcação, você pode adicionar arquivos de recursos globais.

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

Definir o O tipo de implantação a propriedade de cada arquivo de recurso para AppGlobalResource. Isso faz com que os arquivos de recursos implantar na pasta App_GlobalResources, onde eles estão disponíveis para todas as páginas ASPX e controles na solução. A pasta App_GlobalResources está localizada em \App_GlobalResources do C:\inetpub\wwwroot\wss\VirtualDirectories\ < número da porta >.

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

Arquivos de recurso de marcação ASPX também podem ser usados para localizar o código. Se você estiver usando os recursos para localizar o código, além de marcação ASPX, deixe a Build Action configuração da propriedade de cada arquivo como recurso incorporado para fazer com que o recurso compilar em um assembly satélite. No entanto, se você estiver usando os arquivos de recursos somente para localizar a marcação, você pode alterar opcionalmente Build Action ao conteúdo para impedir que o arquivo que está sendo compilado no assembly principal do aplicativo.

Substitua todas as strings de propriedade embutidos na sua marcação de controles e páginas ASPX 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: Localize a marcação ASPX e Demonstra Passo a passo: A localização de um aplicativo do SharePoint de Visual Studio.

A localização de código

Além de para a localização de cadeias de caracteres do recurso e ASP.NET a marcação, você também tem que traduzir as strings de mensagem e strings de erro que aparecem em seu código da solução. Localizadas informativos e mensagens de erro estão contidas em assemblies satélites. Assemblies satélites contêm seqüências de caracteres são visíveis aos usuários, como UI mensagens de texto e de saída como exceções.

Visual Studiousa o padrão.Modelo hub e spoke NET Framework. O hub ou um assembly principal do programa, contém os recursos de idioma padrão. Os raios ou assemblies satélites, contêm os recursos específicos do idioma. Para obter mais informações, consulte empacotamento e implantação de recursos. Assemblies satélites serão compilados dos arquivos de recurso (. resx). Quando você adiciona arquivos de recursos específicos do idioma para seu projeto e o pacote de solução Visual Studio compila os arquivos de recursos em assemblies de satélite chamados Nome do projeto. resources.dll.

Como com marcação ASPX, localizar o código do aplicativo SharePoint adicionando itens de projeto do arquivo de recursos separados para o projeto. uma para o idioma padrão e para cada uma localizada idioma. No entanto, como mencionado anteriormente, se você já tiver arquivos de recursos para localização de marcação ASPX, reutilizá-los para a localização de código. Se você precisar criar arquivos de recursos, nomeie o arquivo de recursos de idioma padrão de sua escolha anexada com uma extensão. resx. Nomeie os arquivos de recurso localizado o mesmo nome anexado com a cultura específica do idioma ID. Defina a propriedade Build Action de cada arquivo de recurso para Embedded Resource para habilitar a criação de satélite de recurso.

Para criar os assemblies satélites, compile o projeto e, em seguida, adicionar os arquivos como assemblies adicionais por meio de Avançado guia da Designer do pacote. Ao adicionar os assemblies, prepend uma cultura ID a pasta para o caminho do local, de DE\Nome do Item de projeto. resources.dll. Isso permite que o pacote conter os arquivos que tenham o mesmo nome.

No seu código, substitua strings codificadas com chamadas para o GetGlobalResourceObject método usando a seguinte sintaxe:

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

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

Localização de código do Web Part

Web parts incluem um recurso de editor de propriedade personalizada que inclui os atributos de código que usam seqüências de caracteres codificadas, como, por exemplo, WebDisplayName, categoria e WebDescription. Para substituir os valores de seqüência de caracteres para esses atributos, crie uma classe separada que deriva de classe do atributo. Nessas classes, defina a propriedade do atributo. A propriedade de atributo depende da classe base. Por exemplo, a propriedade do atributo WebDisplayName é DisplayNameValue e a propriedade do atributo WebDescription é DescriptionValue.

Na classe derivada, fazer referência a seqüência de caracteres de identificação do arquivo de recurso e o objeto ResourceManager para obter o valor localizado para o ID de string. Retorne esse valor para o atributo do editor de propriedade. Para obter mais informações, consulte Demonstra Passo a passo: A localização de um aplicativo do SharePoint de Visual Studio.