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