Share via


SPNavigationNode.TitleResource-Eigenschaft

Ruft ein Objekt, das die SPUserResource darstellt, die zum Abrufen oder Festlegen der Übersetzungen für den Titel der Navigation Knoten verwendet werden können.

Namespace:  Microsoft.SharePoint.Navigation
Assembly:  Microsoft.SharePoint (in Microsoft.SharePoint.dll)

Syntax

'Declaration
Public ReadOnly Property TitleResource As SPUserResource
    Get
'Usage
Dim instance As SPNavigationNode
Dim value As SPUserResource

value = instance.TitleResource
public SPUserResource TitleResource { get; }

Eigenschaftswert

Typ: Microsoft.SharePoint.SPUserResource
Ein Objekt enthält, die Benutzer Ressourcen, die zum Abrufen oder Festlegen der Übersetzungen für den Navigationsbereich Knoten Titel verwendet können.

Hinweise

Diese Eigenschaft ist die Quelle für die Zeichenfolge zurückgegeben, die von der Title -Eigenschaft, die TitleResource.Valuezurückgibt. Der Wert, der von diesem Ausdruck zurückgegeben wird, kann je nach Wert der CurrentUICulture des aktuellen Threads variieren. Weitere Informationen finden Sie unter der SPUserResource.Value -Eigenschaft.

Beispiele

Das folgende Beispiel ist eine Konsolenanwendung, die erstellt eines neue Navigationsknotens, die eine Verknüpfung zur Liste Ankündigungen und den Schnellstartbereich der Website den Knoten hinzugefügt. Die Anwendung dann durchlaufen und die Liste der Sprachen, die von der Website der mehrsprachigen Benutzeroberfläche unterstützt und Code kopiert lokalisierten Werte aus der Ankündigungsliste TitleResource -Eigenschaft auf den Knoten TitleResource -Eigenschaft.

Tipp

Wenn Sie Ressourcendateien (RESX) mit Übersetzungen zur Unterstützung Ihrer Anwendung bereitgestellt haben, müssen Sie nicht die TitleResource -Eigenschaft festlegen, wie im Beispiel wird der Fall ist. Übergeben Sie stattdessen einen Ressourcenausdruck an den Konstruktor SPNavigationNode . Beispielsweise erstellt die folgende Codezeile einem Knoten, die eine Verknüpfung zur Liste Ankündigungen:

SPNavigationNode newNode = new SPNavigationNode("$Resources:core,announceList", list.DefaultViewUrl);

In der Zeichenfolge, die als erstes Argument übergeben wird, das Zeichen "$" gibt einen Ausdruck an, "Ressourcen" gibt den Typ des Ausdrucks, "Core" ist der Name einer Ressourcendatei, und "AnnounceList" ist der Name der Ressource. Leerzeichen dürfen nicht in Ressourcenausdrücke, damit nach dem Komma kein Speicherplatz vorhanden ist.

using System;
using System.Globalization;
using Microsoft.SharePoint;
using Microsoft.SharePoint.Navigation;

namespace ConsoleApp
{
    class Program
    {
        static void Main(string[] args)
        {
            using (SPSite site = new SPSite("https://localhost"))
            {
                using (SPWeb web = site.RootWeb)
                {
                    web.QuickLaunchEnabled = true;
                    web.IsMultilingual = true;

                    SPList list = web.Lists.TryGetList("Announcements");
                    if (list != null)
                    {
                        // Create a navigation node pointing to the Announcements list.
                        SPNavigationNode newNode = new SPNavigationNode(list.Title, list.DefaultViewUrl);

                        // Add the node to the Quick Launch area.
                        SPNavigationNodeCollection quickLaunch = web.Navigation.QuickLaunch;
                        quickLaunch.AddAsLast(newNode);

                        // Copy translations of the list's title to the user resource for the node's title.
                        string localizedTitle;
                        foreach (CultureInfo culture in web.SupportedUICultures)
                        {
                            localizedTitle = list.TitleResource.GetValueForUICulture(culture);
                            newNode.TitleResource.SetValueForUICulture(culture, localizedTitle);
                        }
                        newNode.Update();
                    }
                }
            }
            Console.Write("\nPress ENTER to continue....");
            Console.Read();
        }
    }
}
Imports System
Imports System.Globalization
Imports Microsoft.SharePoint
Imports Microsoft.SharePoint.Navigation

Module ConsoleApp

    Sub Main()
        Using site As New SPSite("https://localhost")
            Using web As SPWeb = site.OpenWeb()

                web.QuickLaunchEnabled = True
                web.IsMultilingual = True

                Dim list As SPList = web.Lists.TryGetList("Announcements")
                If list IsNot Nothing Then
                    ' Create a navigation node pointing to the Announcements list.
                    Dim newNode As New SPNavigationNode(list.Title, list.DefaultViewUrl)

                    ' Add the node to the Quick Launch area.
                    Dim quickLaunch As SPNavigationNodeCollection = web.Navigation.QuickLaunch
                    quickLaunch.AddAsLast(newNode)

                    ' Copy translations of the list's title to the user resource for the node's title.
                    Dim localizedTitle As String
                    For Each culture As CultureInfo In web.SupportedUICultures
                        localizedTitle = list.TitleResource.GetValueForUICulture(culture)
                        newNode.TitleResource.SetValueForUICulture(culture, localizedTitle)
                    Next
                    newNode.Update()
                End If

            End Using
        End Using
        Console.Write(vbCrLf & "Press ENTER to continue....")
        Console.Read()
    End Sub

End Module

Siehe auch

Referenz

SPNavigationNode Klasse

SPNavigationNode-Member

Microsoft.SharePoint.Navigation-Namespace

Title