Partager via


SPNavigationNode.TitleResource - Propriété

Obtient un objet qui représente le SPUserResource qui peut être utilisé pour obtenir ou définir des traductions pour le titre de nœud de navigation.

Espace de noms :  Microsoft.SharePoint.Navigation
Assembly :  Microsoft.SharePoint (dans Microsoft.SharePoint.dll)

Syntaxe

'Déclaration
Public ReadOnly Property TitleResource As SPUserResource
    Get
'Utilisation
Dim instance As SPNavigationNode
Dim value As SPUserResource

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

Valeur de propriété

Type : Microsoft.SharePoint.SPUserResource
Objet qui contient la ressource de l'utilisateur qui peut être utilisé pour obtenir ou définir des traductions pour le titre de nœud de navigation.

Remarques

Cette propriété est la source de la chaîne retournée par la propriété Title , qui renvoie TitleResource.Value. La valeur qui est retournée par cette expression peut varier en fonction de la valeur de la CurrentUICulture du thread actuel. Pour plus d'informations, consultez la propriété SPUserResource.Value .

Exemples

L'exemple suivant est une application console qui crée un nouveau nœud de navigation qui est liée à la liste Annonces et ajoute le nœud à la zone de lancement rapide d'un site Web. L'application effectue une itération dans la liste des langues prises en charge par l'interface utilisateur multilingue du site Web et le code copie les valeurs localisées à partir de la propriété TitleResource de la liste annonce à la propriété du nœud TitleResource .

Conseil

Si vous avez déployé les fichiers de ressources (.resx) associées à des traductions pour prendre en charge votre application, vous n'avez pas besoin de définir la propriété TitleResource , comme dans l'exemple. Passer à la place, une expression de ressource au constructeur SPNavigationNode . Par exemple, la ligne de code suivante construit un nœud qui est liée à la liste d'annonces :

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

Dans la chaîne qui est passée comme premier argument, le caractère « $» indique une expression, « Ressources » indique le type d'expression, « core » est le nom du fichier de ressources et « announceList » est le nom de la ressource. Espaces ne sont pas autorisés dans les expressions de ressource, donc il n'y a pas d'espace après la virgule.

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

Voir aussi

Référence

SPNavigationNode classe

SPNavigationNode - Membres

Microsoft.SharePoint.Navigation - Espace de noms

Title