Clase NavigationTermSetView

Representa la información contextual que afecta al cálculo de determinadas propiedades de los objetos NavigationTerm en un objeto NavigationTermSet .

Jerarquía de la herencia

System.Object
  Microsoft.SharePoint.Publishing.FreezableObject
    Microsoft.SharePoint.Publishing.Navigation.NavigationTermSetView

Espacio de nombres:  Microsoft.SharePoint.Publishing.Navigation
Ensamblado:  Microsoft.SharePoint.Publishing (en Microsoft.SharePoint.Publishing.dll)

Sintaxis

'Declaración
<PermissionSetAttribute(SecurityAction.Demand, Name := "FullTrust")> _
Public NotInheritable Class NavigationTermSetView _
    Inherits FreezableObject
'Uso
Dim instance As NavigationTermSetView

[PermissionSetAttribute(SecurityAction.Demand, Name = "FullTrust")]
public sealed class NavigationTermSetView : FreezableObject

Comentarios

El objeto SPWeb , proveedor del mapa del sitio y políticas para recortar los nodos secundarios son ejemplos de información contextual que puede contener el objeto NavigationTermSetView .

La clase NavigationTermSetView representa la información contextual que se utiliza al representar un conjunto de términos de navegación, pero que no está almacenado en el TermStore o almacenados en caché por la caché de navegación de la taxonomía. Por lo tanto, la clase NavigationTermSetView no se considera parte del conjunto de términos. Sin embargo, esta información contextual afecta al comportamiento de NavigationTerm objetos y NavigationTermSet , similar a cómo puede cambiar la apariencia de un objeto físico cuando se ve desde diferentes ángulos.

La propiedad View es un miembro de la clase NavigationTermSet y la clase NavigationTerm y se realiza a lo largo de mientras se recorre la jerarquía. Por ejemplo, después de llamar al método GetWithNewView , el objeto devuelto se tiene la vista y a los demás objetos obtenidos de miembros como las propiedades TermSet y Parent .

La propiedad View es de sólo lectura y fijo para una instancia del objeto especificado. Por lo tanto, las operaciones de cambio de vista siempre devuelven una nueva instancia del objeto NavigationTerm o del objeto NavigationTermSet . Devuelve el objeto NavigationTerm o la NavigationTermSet facilita las optimizaciones de rendimiento interno que requieren los objetos inmutables.

Es posible que un objeto SPWeb configurar para heredar su exploración conjunto de términos desde el primario SPWeb (especificado mediante el valor de InheritFromParentWeb ). En esta situación, el objeto NavigationTermSetView del objeto primario SPWeb también se utiliza para el objeto de SPWeb secundario. En otras palabras, la propiedad WebId refleja el objeto SPWeb donde se ha configurado el conjunto de términos, en lugar del objeto SPWeb que herede la exploración.

Ejemplos

En el ejemplo siguiente se crea un nuevo conjunto de términos y permite la navegación administrada de un objeto SPWeb con /web1 como la dirección URL.

static void ConfigureNavigation(SPWeb web)
{
     // Create the taxonomy term set.
     TaxonomySession taxonomySession = new TaxonomySession(web.Site);
     TermStore termStore = taxonomySession.DefaultSiteCollectionTermStore;
     Group group = termStore.GetSiteCollectionGroup(web.Site);
     TermSet termSet = group.CreateTermSet("Navigation Term Set");

     // Create a view of the term set as it will look after the web has
     // been configured to use it.
     NavigationTermSet navTermSet = NavigationTermSet.GetAsResolvedByWeb(termSet, web,"GlobalNavigationTaxonomyProvider");

     // Set up the navigation-specific properties.
     NavigationTerm navTerm = navTermSet.CreateTerm("My Article", NavigationLinkType.FriendlyUrl);
     navTerm.TargetUrl.Value = "~site/Pages/Article.aspx";
     navTerm.ExcludeFromGlobalNavigation = true;

     // Output      //"/web1/Pages/Article.aspx?TermStoreId=...&TermSetId=...&TermId=...
     Debug.WriteLine(navTerm.GetResolvedTargetUrl(null, null));
     termStore.CommitAll();

     //Show how the term set will look when trimming is turned on.
     NavigationTermSetView newView = navTermSet.View.GetCopy();
     newView.ExcludeTermsByProvider = true;
     NavigationTermSet trimmedTermSet = navTermSet.GetWithNewView(newView);

     //Output: Terms with trimming = 0
     Debug.WriteLine("Terms with trimming = " + trimmedTermSet.Terms.Count);
     //Output: Terms without trimming = 1
     Debug.WriteLine("Terms without trimming = " + navTermSet.Terms.Count);

     // Finally, configure the web site to use the
     // term set above for its navigation
     WebNavigationSettings settings = new WebNavigationSettings(web);
     settings.GlobalNavigation.Source = StandardNavigationSource.TaxonomyProvider;
     settings.GlobalNavigation.TermStoreId = navTermSet.TermStoreId;
     settings.GlobalNavigation.TermSetId = navTermSet.Id;
settings.Update(taxonomySession);
}

Seguridad para subprocesos

Los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para subprocesos. No se garantiza que los miembros de instancias sean seguros para los subprocesos.

Vea también

Referencia

Miembros NavigationTermSetView

Espacio de nombres Microsoft.SharePoint.Publishing.Navigation