Метод NavigationTermSet.GetWithNewView

Статья
03/15/2016

Возвращает новое представление объекта NavigationTermSet .

Пространство имен: Microsoft.SharePoint.Publishing.Navigation
Сборка: Microsoft.SharePoint.Publishing (в Microsoft.SharePoint.Publishing.dll)

Синтаксис

'Декларация
Public MustOverride Function GetWithNewView ( _
    newView As NavigationTermSetView _
) As NavigationTermSet
'Применение
Dim instance As NavigationTermSet
Dim newView As NavigationTermSetView
Dim returnValue As NavigationTermSet

returnValue = instance.GetWithNewView(newView)

public abstract NavigationTermSet GetWithNewView(
    NavigationTermSetView newView
)

Параметры

newView
Тип: Microsoft.SharePoint.Publishing.Navigation.NavigationTermSetView

Возвращаемое значение

Тип: Microsoft.SharePoint.Publishing.Navigation.NavigationTermSet

Замечания

Этот метод можно используйте для управления параметрами фильтрации по ролям, например метод ExcludeTermByPermissions() или ExcludeTermsByProvider() .

Например рассмотрим иерархию навигации, которая содержит три элемента с названиями «Опубликованные страницы», «Неопубликованные страницы» и «Текущий только». В меню переходов отображается только первый термин. Элемент «Неопубликованные страницы» скрывается, так как он является понятным URL-Адресам для публикации страницы, которая еще не опубликованы, а роли текущего пользователя не имеет разрешений на чтение этого типа документа. Элемент «Только текущая» является скрытым, поскольку она помечена как NavigationTerm.ExcludeFromGlobalNavigation=false. В следующем примере кода показано, как перечислить условия, которые в противном случае были бы скрыты:

           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);
            }

См. также

Справочные материалы

NavigationTermSet класс

Элементы NavigationTermSet

Пространство имен Microsoft.SharePoint.Publishing.Navigation

Microsoft.SharePoint.Publishing.Navigation.NavigationTermSetView

Поделиться через