NavigationTermSet-Klasse
Gibt an, Verhalten und Eigenschaften für ein TermSet -Objekt, das verwendet wird, um den Navigationsbereich drive und freundliche URLs für eine Website.
Vererbungshierarchie
System.Object
Microsoft.SharePoint.Publishing.Navigation.NavigationTermSetItem
Microsoft.SharePoint.Publishing.Navigation.NavigationTermSet
Namespace: Microsoft.SharePoint.Publishing.Navigation
Assembly: Microsoft.SharePoint.Publishing (in Microsoft.SharePoint.Publishing.dll)
Syntax
'Declaration
<PermissionSetAttribute(SecurityAction.Demand, Name := "FullTrust")> _
Public MustInherit Class NavigationTermSet _
Inherits NavigationTermSetItem
'Usage
Dim instance As NavigationTermSet
[PermissionSetAttribute(SecurityAction.Demand, Name = "FullTrust")]
public abstract class NavigationTermSet : NavigationTermSetItem
Hinweise
Diese Klasse fügt zusätzliche Eigenschaften und Operationen, die für verwaltete Navigation spezifisch sind.
Das NavigationTermSet -Objekt verfügt über zwei Modi: einen bearbeitbaren Modus, der als ein einfacher Wrapper für ein TermSet -Objekt fungiert und eine optimierte schreibgeschützten Modus, mit dem Sie die Speichergröße in der Taxonomie Navigation Cache gespeicherten NavigationTermSet Objekte reduzieren.
Verwenden Sie die Methode GetAsResolvedByWeb , bearbeitbare Instanz erstellt werden. Verwenden Sie die Methoden TaxonomyNavigation , nur-Lese Instanzen aus dem Cache der Taxonomie Navigation abzurufen.
Hinweis
Die NavigationTermSet -Klasse unterstützt mehrere Ansichten über die GetWithNewView -Methode.
Finden Sie weitere Informationen NavigationTermSetView Dokumentation.
Beispiele
Das folgende Beispiel veranschaulicht das Erstellen eines Ausdruckssatzes.
using System;
using Microsoft.SharePoint;
using Microsoft.SharePoint.Taxonomy;
using Microsoft.SharePoint.Publishing.Navigation;
namespace NavigationDemos
{
public class Class1
{
public static readonly Guid NavTermSetId = new Guid("<GUID>");
public static readonly Guid TaggingTermSetId = new Guid("<GUID>");
public const string ServerUrl = "http:// <ServerURL>";
public void CreateNavigationTermSet()
{
using (SPSite site = new SPSite(ServerUrl))
{
using (SPWeb web = site.OpenWeb())
{
TaxonomySession taxonomySession = new TaxonomySession(site, updateCache: true);
// Use the first TermStore in the list
if (taxonomySession.TermStores.Count == 0)
throw new InvalidOperationException("The Taxonomy Service is offline or missing");
TermStore termStore = taxonomySession.TermStores[0];
// Does the TermSet already exist?
TermSet existingTermSet = termStore.GetTermSet(NavTermSetId);
if (existingTermSet != null)
{
existingTermSet.Delete();
termStore.CommitAll();
}
// Create a new TermSet
Group siteCollectionGroup = termStore.GetSiteCollectionGroup(site);
TermSet termSet = siteCollectionGroup.CreateTermSet("Navigation Demo", NavTermSetId);
NavigationTermSet navTermSet = NavigationTermSet.GetAsResolvedByWeb(termSet, web,
StandardNavigationProviderNames.GlobalNavigationTaxonomyProvider);
navTermSet.IsNavigationTermSet = true;
navTermSet.TargetUrlForChildTerms.Value = "~site/Pages/Topics/Topic.aspx";
NavigationTerm term1 = navTermSet.CreateTerm("Term 1", NavigationLinkType.SimpleLink);
term1.SimpleLinkUrl = "https://www.bing.com/";
Guid term2Guid = new Guid("87FAA433-4E3E-4500-AA5B-E04330B12ACD");
NavigationTerm term2 = navTermSet.CreateTerm("Term 2", NavigationLinkType.FriendlyUrl,
term2Guid);
// Verify that the NavigationTermSetView is being applied correctly
string expectedTargetUrl = web.ServerRelativeUrl
+ "/Pages/Topics/Topic.aspx?TermStoreId=" + termStore.Id.ToString()
+ "&TermSetId=" + NavTermSetId.ToString()
+ "&TermId=" + term2Guid.ToString();
NavigationTerm childTerm = term2.CreateTerm("Term 2 child", NavigationLinkType.FriendlyUrl);
// Commit the Taxonomy changes
childTerm.GetTaxonomyTerm().TermStore.CommitAll();
}
}
}
}
}
Threadsicherheit
Alle öffentlichen static (Shared in Visual Basic) Member dieses Typs sind threadsicher. Die Threadsicherheit von Instanzmembern ist nicht gewährleistet.