Verwenden von Lokalisierungsfeatures in Office 365 Beispiel-Add-In
Das Core.CreateContentTypes-Beispiel zeigt Ihnen, wie Sie die Lokalisierungsfeatures von Office 365 auf Websites, Listen, Inhaltstypen und Websitespalten verwenden. In diesem Codebeispiel wird eine Konsolenanwendung verwendet, um folgendes auszuführen:
- Erstellen Sie Inhaltstypen, Websitespalten und Listen, und ordnen Sie Websitespalten Inhaltstypen zu.
- Lokalisieren Sie den Inhaltstyp, die Websitespalte, die Liste und eine vom Benutzer bereitgestellte Website.
Hinweis
Die in diesem Artikel beschriebenen Lokalisierungsfeatures sind nur in Office 365 verfügbar. Informationen zu den Lokalisierungsfeatures, die in Office 365 Dedicated oder SharePoint Server lokal verfügbar sind, finden Sie unter Lokalisieren von SharePoint-Add-Ins und Lokalisieren von SharePoint-Lösungen.
Bevor Sie beginnen
Laden Sie zunächst das Beispiel-Add-In Core.CreateContentTypes aus dem projekt Office 365 Developer Patterns and Practices auf GitHub herunter.
Bevor Sie dieses Codebeispiel ausführen, führen Sie die folgenden Schritte aus.
Konfigurieren der Spracheinstellungen auf Ihrer Website
Wählen Sie auf Ihrer Teamwebsite Einstellungen>Websiteeinstellungen aus.
Wählen Sie unter Websiteverwaltungdie Option Spracheinstellungen aus.
Wählen Sie auf der Seite Spracheinstellungen unter Alternative Sprachen die alternativen Sprachen aus, die Ihre Website unterstützen soll. Sie können beispielsweise Finnisch und Französisch auswählen, wie in der folgenden Abbildung dargestellt.
Wählen Sie OK aus.
Festlegen der Anzeigesprache auf der Profilseite Ihres Benutzers
Wählen Sie Ihr Profilbild oben auf Ihrer Office 365-Website aus, und wählen Sie dann Über mich aus.
Wählen Sie auf der Seite Über mich die Option Profil bearbeiten aus.
Wählen Sie ... (zusätzliche Optionen) und dann Sprache und Region aus.
Wählen Sie unter Meine Anzeigesprachen eine neue Sprache aus, die der sprache ähnelt, die Sie auf der Website mithilfe der Liste Neue Sprache auswählen festgelegt haben, und wählen Sie dann Hinzufügen aus. Wählen Sie beispielsweise Finnisch und Französisch wie gezeigt aus. Sie können Ihre bevorzugte Sprache nach oben oder unten verschieben, indem Sie die NACH-OBEN- und NACH-UNTEN-TASTE auswählen.
Klicken Sie auf Alles speichern und schließen.
Hinweis
Es kann einige Minuten dauern, bis Ihre Website in den ausgewählten Sprachen gerendert wurde.
Ausführen der Core.CreateContentTypes-Beispiel-App
Wenn Sie dieses Codebeispiel ausführen, wird eine Konsolenanwendung angezeigt, wie in der folgenden Abbildung dargestellt. Sie müssen die zu lokalisierende Website und die Anmeldeinformationen Ihres Office 365 Administrators angeben.
Wenn die Konsolenanwendung ausgeführt wird, führt die Main-Methode in Program.cs die folgenden Aufgaben aus:
Ruft die CreateContentTypeIfDoesNotExist-Methode auf, um einen Inhaltstyp namens Contoso Document zu erstellen.
Ruft die CreateSiteColumn-Methode auf, um eine Websitespalte namens Contoso String zu erstellen.
Ruft die AddSiteColumnToContentType-Methode auf, um die Contoso String-Websitespalte mit dem Contoso-Dokumentinhaltstyp zu verknüpfen.
Ruft die CreateCustomList-Methode auf, um eine neue Liste namens MyList zu erstellen.
Die Main-Methode ruft dann die Methoden LocalizeSiteAndList und LocalizeContentTypeAndField auf .
Die LocalizeSiteAndList-Methode zeigt Ihnen die folgenden Schritte:
Legen Sie verschiedene lokalisierte Werte für den Titel und die Beschreibung einer Website fest, indem Sie die SetValueForUICulture-Methode für die Eigenschaften TitleResource und DescriptionResource im Webobjekt verwenden.
Legen Sie verschiedene lokalisierte Werte für den Titel und die Beschreibung einer Website fest, indem Sie die SetValueForUICulture-Methode für die Eigenschaften TitleResource und DescriptionResource im Webobjekt verwenden.
Die LocalizeContentTypeAndField-Methode zeigt Ihnen die folgenden Schritte:
Legen Sie verschiedene lokalisierte Werte für den Namen und die Beschreibung eines Inhaltstyps fest, indem Sie die SetValueForUICulture-Methode für die Eigenschaften NameResource und DescriptionResource für das ContentType-Objekt verwenden.
Legen Sie verschiedene lokalisierte Werte für den Titel und die Beschreibung einer Website fest, indem Sie die SetValueForUICulture-Methode für die Eigenschaften TitleResource und DescriptionResource für das Field-Objekt verwenden.
Hinweis
Der Code in diesem Artikel wird wie besehen und ohne jegliche Garantie zur Verfügung gestellt, gleich ob ausdrücklich oder konkludent, einschließlich jedweder stillschweigenden Gewährleistung der Eignung für einen bestimmten Zweck, Marktgängigkeit oder Nichtverletzung von Rechten.
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();
}
Wie in der folgenden Abbildung gezeigt, zeigt Ihre Website Ihren benutzerdefinierten französischen Titel Hallo Welt - Französisch an, der mithilfe der LocalizeSiteAndList-Methode festgelegt wurde.
