Utiliser les fonctionnalités de localisation dans Office 365 exemple de add-in
L’exemple Core.CreateContentTypes vous montre comment utiliser les fonctionnalités de localisation de Office 365 sur des sites, des listes, des types de contenu et des colonnes de site. Cet exemple de code utilise une application console pour :
- Créer des types de contenu, des colonnes de site et des listes, et associer des colonnes de site à des types de contenu.
- Localisez le type de contenu, la colonne de site, la liste et un site fourni par l’utilisateur.
Notes
Les fonctionnalités de localisation décrites dans cet article sont disponibles uniquement dans Office 365. Pour plus d’informations sur les fonctionnalités de localisation disponibles dans Office 365 Dedicated ou SharePoint Server local, voir Localize SharePoint Add-ins and Localizing SharePoint solutions.
Avant de commencer
To get started, download the Core.CreateContentTypes sample add-in from the Office 365 Developer Patterns and Practices project on GitHub.
Avant d’exécuter cet exemple de code, exécutez les étapes suivantes.
Configurer les paramètres de langue sur votre site
Sur votre site d’équipe, choisissez Paramètres > paramètres du site.
Dans l’Administration du site, choisissez les paramètres de langue.
Dans la page Langue Paramètres, dans les autres langues, choisissez les autres langues que votre site doit prendre en charge. Par exemple, vous pouvez choisir finnois et français, comme illustré dans la figure suivante.

Sélectionnez OK.
Définir la langue d’affichage sur la page de profil de votre utilisateur
Dans le haut de votre site Office 365, choisissez votre photo de profil, puis cliquez sur À mon sujet.

On the About me page, choose Edit your profile.
Choose ... (additional options), and then choose Language and Region.
Dans Mes langues d’affichage, choisissez une nouvelle langue similaire à celle que vous avez définie sur le site à l’aide de la liste Sélectionner une nouvelle langue, puis choisissez Ajouter. Par exemple, choisissez finnois et français comme indiqué. Vous pouvez déplacer votre langue préférée vers le haut ou vers le bas en choisissant les flèches vers le haut et vers le bas.

Cliquez sur Enregistrer tout et fermer.
Notes
Le rendu de votre site dans la ou les langues sélectionnées peut prendre quelques minutes.
Exécuter l’exemple d’application Core.CreateContentTypes
Lorsque vous exécutez cet exemple de code, une application console s’affiche, comme illustré dans la figure suivante. Vous devez fournir le site à localiser et les informations d’identification Office 365'administrateur.

Lorsque l’application console s’exécute, la méthode Main dans Program.cs effectue les tâches suivantes :
Appelle la méthode CreateContentTypeIfDoesNotExist pour créer un type de contenu appelé Document Contoso.
Appelle la méthode CreateSiteColumn pour créer une colonne de site appelée Chaîne Contoso.
Appelle la méthode AddSiteColumnToContentType pour lier la colonne de site chaîne Contoso au type de contenu Document Contoso.
Appelle la méthode CreateCustomList pour créer une liste appelée MyList.
La méthode Main appelle ensuite les méthodes LocalizeSiteAndList et LocalizeContentTypeAndField.
La méthode LocalizeSiteAndList vous montre comment :
Définissez différentes valeurs localisées pour le titre et la description d’un site à l’aide de la méthode SetValueForUICulture sur les propriétés TitleResource et DescriptionResource sur l’objet Web.
Définissez différentes valeurs localisées pour le titre et la description d’un site à l’aide de la méthode SetValueForUICulture sur les propriétés TitleResource et DescriptionResource sur l’objet Web.
La méthode LocalizeContentTypeAndField vous montre comment :
Définissez différentes valeurs localisées pour le nom et la description d’un type de contenu à l’aide de la méthode SetValueForUICulture sur les propriétés NameResource et DescriptionResource sur l’objet ContentType.
Définissez différentes valeurs localisées pour le titre et la description d’un site à l’aide de la méthode SetValueForUICulture sur les propriétés TitleResource et DescriptionResource sur l’objet Field.
Notes
Le code dans cet article est fourni tel quel, sans garantie d’aucune sorte, expresse ou implicite, y compris mais sans s’y limiter, aucune garantie implicite d’adéquation à un usage particulier, à une qualité marchande ou une absence de contrefaçon.
private static void LocalizeSiteAndList(ClientContext cc, Web web)
{
// Localize the site title.
web.TitleResource.SetValueForUICulture("en-US", "Hello World");
web.TitleResource.SetValueForUICulture("fi-FI", "Hello World - Finnish");
web.TitleResource.SetValueForUICulture("fr-FR", "Hello World - French");
// Localize the site description.
web.DescriptionResource.SetValueForUICulture("en-US", "Hello World site sample");
web.DescriptionResource.SetValueForUICulture("fi-FI", " Hello World site sample - Finnish");
web.DescriptionResource.SetValueForUICulture("fr-FR", " Hello World site sample - French");
web.Update();
cc.ExecuteQuery();
// Localize the custom list that was created previously.
List list = cc.Web.Lists.GetByTitle("MyList");
cc.Load(list);
cc.ExecuteQuery();
// Localize the list title.
list.TitleResource.SetValueForUICulture("en-US", "Hello World");
list.TitleResource.SetValueForUICulture("fi-FI", "Hello World - Finnish");
list.TitleResource.SetValueForUICulture("fr-FR", " Hello World - French");
// Localize the list description.
list.DescriptionResource.SetValueForUICulture("en-US", "This example localizes a list using CSOM.");
list.DescriptionResource.SetValueForUICulture("fi-FI", "This example localizes a list using CSOM - Finnish.");
list.DescriptionResource.SetValueForUICulture("fr-FR", "This example localizes a list using CSOM - French.");
list.Update();
cc.ExecuteQuery();
}
private static void LocalizeContentTypeAndField(ClientContext cc, Web web)
{
ContentTypeCollection contentTypes = web.ContentTypes;
ContentType myContentType = contentTypes.GetById("0x0101009189AB5D3D2647B580F011DA2F356FB2");
cc.Load(contentTypes);
cc.Load(myContentType);
cc.ExecuteQuery();
// Localize content type name.
myContentType.NameResource.SetValueForUICulture("en-US", "Contoso Document");
myContentType.NameResource.SetValueForUICulture("fi-FI", "Contoso Document - Finnish");
myContentType.NameResource.SetValueForUICulture("fr-FR", "Contoso Document - French");
// Localize content type description.
myContentType.DescriptionResource.SetValueForUICulture("en-US", "This is the Contoso Document.");
myContentType.DescriptionResource.SetValueForUICulture("fi-FI", " This is the Contoso Document - Finnish.");
myContentType.DescriptionResource.SetValueForUICulture("fr-FR", " This is the Contoso Document - French.");
myContentType.Update(true);
cc.ExecuteQuery();
// Localize the site column.
FieldCollection fields = web.Fields;
Field fld = fields.GetByInternalNameOrTitle("ContosoString");
// Localize site column title.
fld.TitleResource.SetValueForUICulture("en-US", "Contoso String");
fld.TitleResource.SetValueForUICulture("fi-FI", "Contoso String - Finnish");
fld.TitleResource.SetValueForUICulture("fr-FR", "Contoso String - French");
// Localize site column description.
fld.DescriptionResource.SetValueForUICulture("en-US", "Used to store Contoso specific metadata.");
fld.DescriptionResource.SetValueForUICulture("fi-FI", "Used to store Contoso specific metadata - Finnish.");
fld.DescriptionResource.SetValueForUICulture("fr-FR", "Used to store Contoso specific metadata - French.");
fld.UpdateAndPushChanges(true);
cc.ExecuteQuery();
}
Comme illustré dans la figure suivante, votre site affiche votre titre français personnalisé Hello World - Français, qui a été définie à l’aide de la méthode LocalizeSiteAndList.
