NavigationTermSet.GetWithNewView-Methode

Artikel
03/15/2016

Gibt eine neue Ansicht eines NavigationTermSet -Objekts zurück.

Namespace: Microsoft.SharePoint.Publishing.Navigation
Assembly: Microsoft.SharePoint.Publishing (in Microsoft.SharePoint.Publishing.dll)

Syntax

'Declaration
Public MustOverride Function GetWithNewView ( _
    newView As NavigationTermSetView _
) As NavigationTermSet
'Usage
Dim instance As NavigationTermSet
Dim newView As NavigationTermSetView
Dim returnValue As NavigationTermSet

returnValue = instance.GetWithNewView(newView)

public abstract NavigationTermSet GetWithNewView(
    NavigationTermSetView newView
)

Parameter

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

Rückgabewert

Typ: Microsoft.SharePoint.Publishing.Navigation.NavigationTermSet

Hinweise

Verwenden Sie diese Methode, um die Einschränkung aus Sicherheitsgründen Einstellungen, z. B. die ExcludeTermByPermissions() -Methode oder die ExcludeTermsByProvider() -Methode bearbeiten.

Betrachten Sie beispielsweise eine Navigationshierarchie, die drei Artikel mit dem Titel "Veröffentlichte Seite", "Seite unveröffentlichten" und "Nur aktuelle" enthält. Nur der erste Begriff erscheint im Navigationsmenü. Das Element "Seite unveröffentlichten" ist ausgeblendet, da es für eine Veröffentlichungsseite auf einer benutzerfreundlichen URL ist, die noch nicht veröffentlicht wurde, und die Rolle des aktuellen Benutzers ist nicht berechtigt, diesen Typ von Dokument zu lesen. Das Element "Nur aktuelle" ist ausgeblendet, da sie als NavigationTerm.ExcludeFromGlobalNavigation=falsemarkiert ist. Im folgenden Codebeispiel wird veranschaulicht, wie Sie die Begriffe aufgelistet werden, die andernfalls ausgeblendet werden würde:

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

Siehe auch

Referenz

NavigationTermSet Klasse

NavigationTermSet-Member

Microsoft.SharePoint.Publishing.Navigation-Namespace

Microsoft.SharePoint.Publishing.Navigation.NavigationTermSetView

Freigeben über