NavigationTermSetItem.CreateTerm - Méthode (String, NavigationLinkType, Guid)

Article
03/15/2016

Crée un nouvel objet NavigationTerm avec la termNamede spécifié.

Espace de noms : Microsoft.SharePoint.Publishing.Navigation
Assembly : Microsoft.SharePoint.Publishing (dans Microsoft.SharePoint.Publishing.dll)

Syntaxe

'Déclaration
Public Function CreateTerm ( _
    termName As String, _
    linkType As NavigationLinkType, _
    termId As Guid _
) As NavigationTerm
'Utilisation
Dim instance As NavigationTermSetItem
Dim termName As String
Dim linkType As NavigationLinkType
Dim termId As Guid
Dim returnValue As NavigationTerm

returnValue = instance.CreateTerm(termName, _
    linkType, termId)

public NavigationTerm CreateTerm(
    string termName,
    NavigationLinkType linkType,
    Guid termId
)

Paramètres

termName
Type : System.String

La valeur initiale de la propriété TaxonomyName .

linkType
Type : Microsoft.SharePoint.Publishing.Navigation.NavigationLinkType

La valeur initiale de la propriété LinkType .

termId
Type : System.Guid

La valeur initiale de la propriété Id .

Valeur renvoyée

Type : Microsoft.SharePoint.Publishing.Navigation.NavigationTerm
L'objet nouvellement créé.

Remarques

Un concept similaire à la méthode CreateTerm(String, Int32) , cette méthode crée un nouveau terme de navigation avec le nom spécifié, le type de lien et l'ID taxonomie. La nouvelle entrée du glossaire est un enfant de l'objet en cours.

Le paramètre fourni termName est utilisé pour déterminer le nom de l'objet sous-jacent Term , qui est une valeur localisée. L'ID de paramètres régionaux est déterminé par la propriété WorkingLanguage en cours, qui doit être configurée avant à l'aide de la méthode GetNavigationLcidForWeb(SPWeb) pour les sites multilingues. Si le nom spécifié est déjà en cours d'utilisation par un terme frère, un suffixe sera automatiquement ajouté pour éviter ce conflit. Un approprié FriendlyUrlSegment sera également générée à partir de ce nom et de la même façon, un suffixe est ajouté si nécessaire pour éviter un conflit de frère. En cas de conditions créées à l'aide de la CreateTerm() sont triées par ordre alphabétique, la CreateTerm() met automatiquement à jour la propriété CustomSortOrder pour vous assurer que ce terme apparaît après les autres termes triée personnalisé.

Cette méthode n'est pas pris en charge si la propriété IsReadOnly est égal à true.