Localizzazione di soluzioni SharePoint

Articolo
03/05/2013

Il processo di preparazione delle applicazioni in modo che possano essere utilizzate a livello mondiale è noto come localizzazione.La localizzazione consiste nella traduzione delle risorse in determinate impostazioni cultura.Per ulteriori informazioni, vedere Globalizzazione e localizzazione di applicazioni.In questo argomento sono contenuti cenni preliminari sulla localizzazione di una soluzione SharePoint.

Per localizzare una soluzione, è necessario rimuovere stringhe hardcoded dal codice ed estrarle in file di risorse.Un file di risorse è un file basato su XML con estensione resx.Il file di risorse contiene le versioni tradotte delle stringhe utilizzate nella soluzione.Per ulteriori informazioni, vedere Risorse nelle applicazioni (la pagina potrebbe essere in inglese).

[!NOTA]

Aggiungere solo risorse di tipo stringa ai file di risorse delle soluzioni SharePoint.Sebbene Editor risorse consenta di aggiungere risorse non di tipo stringa, tali risorse non vengono distribuite in SharePoint.

File di risorse

Esistono tre tipi di file di risorse: predefinito, indipendente dalla lingua e specifico della lingua.

Tipo di file di risorse	Descrizione
Predefinito	Anche noti come risorse di fallback, i file di risorse predefiniti contengono stringhe localizzate per le impostazioni cultura predefinite, ad esempio Inglese.Vengono utilizzati se non è possibile trovare file di risorse localizzati per la lingua specificata.Le risorse predefinite non presentano file separati e vengono archiviate nell'assembly dell'applicazione principale.
Indipendente dalla lingua	File di risorse contenente stringhe localizzate per una lingua, ma non per impostazioni cultura specifiche,ad esempio "fr" per il francese.
Specifico della lingua	File di risorse contenente stringhe localizzate per una lingua e per impostazioni cultura specifiche,ad esempio "fr-CA" per il francese canadese.

Per ulteriori informazioni, vedere Organizzazione gerarchica di risorse per la localizzazione.

Per specificare file di risorse predefiniti in progetti SharePoint sviluppato in Visual Studio, scegliere Lingua inglese (non associata ad alcun paese) nell'elenco delle impostazioni cultura della finestra di dialogo Aggiungi risorsa quando si aggiunge un file di risorse.

Localizzazione delle soluzioni SharePoint di Visual Studio

Quando si localizza una soluzione, è necessario considerare tutte le informazioni testuali che vengono visualizzate al suo interno per gli utenti.È necessario tradurre le stringhe dei messaggi informativi, dei messaggi di errore e dell'interfaccia utente e quindi inserire le traduzioni nei file di risorse.

Ogni stringa in un file di risorse dispone di un identificatore univoco.Utilizzare lo stesso identificatore per la stringa tradotta in ogni file di risorse.Se, ad esempio, "String1" è l'identificatore della prima stringa nel file di risorse predefinito, utilizzare lo stesso identificatore per la prima stringa nei file di risorse specifici della lingua.

Nelle applicazioni di SharePoint di Visual Studio vengono in genere localizzate tre aree: funzionalità, markup delle pagine ASPX e codice.A scopo dimostrativo, nelle sezioni seguenti si suppone di disporre di una soluzione SharePoint da localizzare in tedesco e in giapponese.La lingua predefinita è l'inglese.

Localizzazione di funzionalità

Per localizzare una funzionalità, è necessario sostituire il titolo hardcoded e la descrizione della funzionalità con un'espressione che faccia riferimento al titolo e alla stringa tradotti nel file di risorse localizzato.Per apportare questa modifica è necessario utilizzare Progettazione funzionalità in Visual Studio.Per ulteriori informazioni, vedere Procedura: localizzare una funzionalità.

Per localizzare la funzionalità inglese in tedesco e in giapponese, aggiungere tre elementi del progetto File di risorse al proprio progetto: uno per l'inglese, uno per il tedesco e uno per il giapponese.Non è possibile utilizzare file di risorse di funzionalità per localizzare codice o markup ASPX. Per questi ultimi sono infatti richiesti file di risorse separati.

Dopo avere creato i file di risorse di funzionalità, aggiungervi le stringhe tradotte.Accedere alle stringhe localizzate con un'espressione nel formato seguente:

$Resources:String ID

Le risorse di funzionalità di Visual Studio vengono sempre denominate Resources.Se si seleziona un linguaggio diverso dal linguaggio invariante, le impostazioni cultura ID vengono aggiunti al nome del file di risorse. Ad esempio, se si aggiunge un file di risorse della funzionalità (predefinito) invariante di linguaggio, viene denominato Resources.resx.Se si aggiunge una risorsa di funzionalità specifica della lingua selezionando le impostazioni cultura per la lingua giapponese (Giappone), il file viene denominato Resources.ja-JP.resx.Ai file di risorse di funzionalità viene automaticamente assegnato un nome non modificabile.

L'ambito delle risorse di funzionalità è locale rispetto alla funzionalità alla quale vengono aggiunte.Per creare risorse utilizzabili con qualsiasi file di funzionalità o elemento nella soluzione, aggiungere un elemento del progetto File di risorse globali anziché un file di risorse di funzionalità.L'elemento del progetto File di risorse globali si trova nella cartella 2010 di SharePoint nella finestra di dialogo Aggiungi nuovo elemento.I file di risorse globali vengono distribuiti nella cartella \Resources della cartella radice di SharePoint.

Per ulteriori informazioni, vedere Procedura dettagliata: localizzazione di un'applicazione di SharePoint in Visual Studio.

Localizzazione del markup della pagina ASPX

Per localizzare le pagine ASP.NET, aggiungere tre elementi del progetto file di risorse al progetto: uno per l'inglese, uno per il tedesco e uno per il giapponese. Se non è necessario localizzare codice oltre al markup, è invece possibile aggiungere file di risorse globali.

Specificare un nome per il file di risorse della lingua predefinita.Assegnare ai file di risorse localizzati lo stesso nome aggiunto all'ID delle impostazioni cultura specifico della lingua,ad esempio MyAppResources.de-DE.resx per il tedesco e MyAppResources.ja-JP.resx per il giapponese.

Impostare la proprietà Tipo distribuzione di ogni file di risorse su AppGlobalResource.In questo modo i file di risorse vengono distribuiti nella cartella App_GlobalResources, dove sono disponibili per tutte le pagine e i controlli ASPX della soluzione.La cartella App_GlobalResources si trova in C:\inetpub\wwwroot\wss\VirtualDirectories\<numero porta>\App_GlobalResources.

[!NOTA]

Se si utilizzano file di risorse non globali, spostarli nella cartella degli elementi del progetto per abilitare la proprietà Tipo distribuzione e altre proprietà specifiche di SharePoint.

È inoltre possibile utilizzare i file di risorse di markup ASPX per localizzare il codice.Se si utilizzano le risorse per localizzare codice oltre al markup ASPX, lasciare l'impostazione della proprietà Operazione di compilazione di ogni file su Risorsa incorporata per fare in modo che la risorsa venga compilata in un assembly satellite.Se invece si utilizzano i file di risorse solo per localizzare il markup, è possibile modificare l'impostazione di Operazione di compilazione in Contenuto per evitare che il file venga compilato nell'assembly dell'applicazione principale.

Sostituire tutte le stringhe delle proprietà hardcoded nel markup delle pagine e dei controlli ASPX con un'espressione che abbia il formato seguente:

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

Ad esempio:

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

Per ASPX come testo, utilizzare un'espressione nel formato seguente:

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

Ad esempio:

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

Per ulteriori informazioni, vedere Procedura: localizzare il markup ASPX e Procedura dettagliata: localizzazione di un'applicazione di SharePoint in Visual Studio.

Localizzazione del codice

Oltre a localizzare le stringhe di funzionalità e il markup ASP.NET, è anche necessario localizzare le stringhe relative a messaggi ed errori visualizzate nel codice della soluzione.I messaggi informativi e di errore localizzati sono contenuti in assembly satellite. Gli assembly sono contenute stringhe visibili a utenti, ad esempio il testo interfaccia utente messaggi di output e come le eccezioni.

In Visual Studio viene utilizzato il modello hub e spoke di .NET Framework standard.L'hub, o assembly del programma principale, contiene le risorse della lingua predefinita.Gli spoke, o assembly satellite, contengono le risorse specifiche della lingua.Per ulteriori informazioni, vedere Creazione del pacchetto e distribuzione delle risorse (la pagina potrebbe essere in inglese).Gli assembly satellite vengono compilati da file di risorse (con estensione resx).Quando si aggiungono file di risorse specifici della lingua al progetto e al pacchetto della soluzione, in Visual Studio tali file vengono compilati in assembly satellite denominati Nome progetto.resources.dll.

Come per il markup ASPX, localizzare il codice dell'applicazione di SharePoint aggiungendo elementi del progetto File di risorse separati al proprio progetto, ovvero uno per la lingua predefinita e uno per ogni lingua localizzata.Come indicato in precedenza, tuttavia, se già si dispone di file di risorse per la localizzazione del markup ASPX, è possibile riutilizzarli per localizzare il codice.Se è necessario creare file di risorse, assegnare al file di risorse della lingua predefinita un nome di propria scelta con estensione resx.Assegnare ai file di risorse localizzati lo stesso nome aggiunto all'ID delle impostazioni cultura specifico della lingua,Impostare la proprietà Operazione di compilazione di ogni file di risorse su Risorsa incorporata per consentire la creazione di assembly di risorse satellite.

Per creare gli assembly satellite, compilare il progetto, quindi aggiungere i file come assembly aggiuntivi tramite la scheda Avanzate di Progettazione pacchetti.Quando si aggiungono gli assembly, anteporre una cartella con l'ID delle impostazioni cultura al percorso, ad esempio de-DE\Nome elemento progetto.resources.dll.In questo modo nel pacchetto potranno essere contenuti file con lo stesso nome.

Nel codice sostituire le stringhe hardcoded con chiamate al metodo GetGlobalResourceObject utilizzando la sintassi seguente:

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

Per ulteriori informazioni, vedere Procedura: localizzare il codice e Procedura dettagliata: localizzazione di un'applicazione di SharePoint in Visual Studio.

Localizzazione del codice delle Web part

Le Web part offrono una funzionalità dell'editor proprietà personalizzata che include attributi di codice che utilizzano stringhe hardcoded, quali WebDisplayName, Category e WebDescription.Per sostituire i valori di stringa con tali attributi, creare una classe separata che derivi dalla classe dell'attributo.In queste classi impostare la proprietà dell'attributo.Tale proprietà dipende dalla classe base.La proprietà dell'attributo WebDisplayName è ad esempio DisplayNameValue e la proprietà dell'attributo WebDescription è DescriptionValue.

Nella classe derivata fare riferimento all'ID stringa dal file di risorse e dall'oggetto ResourceManager per ottenere il valore localizzato di tale ID stringa.Restituire questo valore all'attributo dell'editor proprietà.Per ulteriori informazioni, vedere Procedura dettagliata: localizzazione di un'applicazione di SharePoint in Visual Studio.