NavigationTermSet.GetWithNewView - Méthode

Article
05/05/2016

Renvoie une nouvelle vue d'un objet NavigationTermSet .

Espace de noms : Microsoft.SharePoint.Client.Publishing.Navigation
Assemblys : Microsoft.SharePoint.Client.Publishing.Silverlight (dans Microsoft.SharePoint.Client.Publishing.Silverlight.dll); Microsoft.SharePoint.Client.Publishing.Phone (dans Microsoft.SharePoint.Client.Publishing.Phone.dll) Microsoft.SharePoint.Client.Publishing (dans Microsoft.SharePoint.Client.Publishing.dll)

Syntaxe

'Déclaration
Public Overridable 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 virtual NavigationTermSet GetWithNewView(
    NavigationTermSetView newView
)

Paramètres

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

L'objet NavigationTermSetView s'applique à l'objet NavigationTermSet .

Valeur renvoyée

Type : Microsoft.SharePoint.Client.Publishing.Navigation.NavigationTermSet
L'objet NavigationTermSet .

Remarques

Utilisez cette méthode pour manipuler les paramètres de filtrage, telles que la méthode ExcludeTermsByPermissions() ou ExcludeTermsByProvider() .

Par exemple, considérez une hiérarchie de navigation qui contient trois éléments avec les titres des « Page publiée », « Page non publiée » et « Active uniquement ». Seul le premier terme apparaît dans le menu de navigation. L'élément « Page non publiée » est masquée car il s'agit d'une URL conviviale 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 « Active uniquement » est masquée, car il est marqué comme NavigationTerm.ExcludeFromGlobalNavigation=false. L'exemple suivant montre comment énumérer les termes 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.Client.Publishing.Navigation - Espace de noms

Partager via