NavigationTermSet.GetWithNewView - Méthode

Article
03/15/2016

Retourne une nouvelle vue d'un objet NavigationTermSet .

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

Syntaxe

'Déclaration
Public MustOverride Function GetWithNewView ( _
    newView As NavigationTermSetView _
) As NavigationTermSet
'Utilisation
Dim instance As NavigationTermSet
Dim newView As NavigationTermSetView
Dim returnValue As NavigationTermSet

returnValue = instance.GetWithNewView(newView)

public abstract NavigationTermSet GetWithNewView(
    NavigationTermSetView newView
)

Paramètres

newView
Type : Microsoft.SharePoint.Publishing.Navigation.NavigationTermSetView

Valeur renvoyée

Type : Microsoft.SharePoint.Publishing.Navigation.NavigationTermSet

Remarques

Cette méthode permet de manipuler les paramètres de suppression, la méthode ExcludeTermByPermissions() ou ExcludeTermsByProvider() .

Par exemple, considérez une hiérarchie de navigation qui contient trois éléments avec les titres « Page publiée », « Page non publiée » et « En cours uniquement ». Seul le premier terme s'affiche dans le menu de navigation. L'élément « Page non publiée » est masqué parce qu'il s'agit d'une URL simplifiée pour une page de publication qui n'a pas encore été publiée, et le rôle de l'utilisateur actuel n'a pas les autorisations nécessaires pour lire ce type de document. L'élément « En cours uniquement » est masquée car elle est marquée en tant que NavigationTerm.ExcludeFromGlobalNavigation=false. L'exemple de code suivant montre comment énumérer les conditions qui seraient masquées sinon :

           static void Example(SPWeb web)
            {
                // Retrieve the active navigation term set from the Taxonomy Navigation Cache.
                NavigationTermSet termSet = TaxonomyNavigation.GetTermSetForWeb(web,
                    "GlobalNavigationTaxonomyProvider", includeInheritedSettings: false);
            
                // Output is one term: "Published Page".
                foreach (NavigationTerm term in termSet.Terms)
                    Debug.WriteLine(term.Title.Value);
            
                // Disable all exclusions.
                NavigationTermSetView newView = termSet.View.GetCopy();
                newView.ExcludeDeprecatedTerms = false;
                newView.ExcludeTermsByPermissions = false;
                newView.ExcludeTermsByProvider = false;
                termSet = termSet.GetWithNewView(newView);
            
                // Output is three terms: "Published Page", "Unpublished Page", "Current Only".
                foreach (NavigationTerm term in termSet.Terms)
                    Debug.WriteLine(term.Title.Value);
            }

Voir aussi

Référence

NavigationTermSet classe

NavigationTermSet - Membres

Microsoft.SharePoint.Publishing.Navigation - Espace de noms

Microsoft.SharePoint.Publishing.Navigation.NavigationTermSetView

Partager via