NavigationTermSetItem.CreateTerm-Methode (String, NavigationLinkType, Guid)

Artikel
03/15/2016

Erstellt ein neues NavigationTerm -Objekt mit dem angegebenen termName.

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

Syntax

'Declaration
Public Function CreateTerm ( _
    termName As String, _
    linkType As NavigationLinkType, _
    termId As Guid _
) As NavigationTerm
'Usage
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
)

Parameter

termName
Typ: System.String

Der anfängliche Wert für die Eigenschaft TaxonomyName .

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

Der anfängliche Wert für die Eigenschaft LinkType .

termId
Typ: System.Guid

Der anfängliche Wert für die Eigenschaft Id .

Rückgabewert

Typ: Microsoft.SharePoint.Publishing.Navigation.NavigationTerm
Das neu erstellte Objekt.

Hinweise

Konzept der CreateTerm(String, Int32) -Methode ähnlich, erstellt diese Methode einen neuen Begriff für die Navigation mit dem angegebenen Namen, Link-Typ und Taxonomiekennung aus. Der neue Begriff ist ein untergeordnetes Element des aktuellen Objekts.

Der bereitgestellte termName -Parameter wird verwendet, den Namen des zugrunde liegenden Objekts Term ermitteln, die einen lokalisierten Wert ist. Die Gebietsschema-ID wird von der aktuellen WorkingLanguage -Eigenschaft bestimmt die mehrsprachiger Websites mithilfe der GetNavigationLcidForWeb(SPWeb) -Methode vor der konfiguriert werden soll. Wenn der angegebene Name bereits von einem nebengeordneten Begriff verwendet wird, wird automatisch ein Suffix angefügt werden, um diesen Konflikt zu vermeiden. Eine geeignete FriendlyUrlSegment wird auch aus dieser Name generiert werden, und auf die gleiche Weise ein Suffix angefügt wird, ggf. zur Vermeidung eines Konflikts gleichgeordnetes Element. Wenn Bedingungen mit den CreateTerm() erstellt alphabetisch sortiert sind, aktualisiert der CreateTerm() automatisch die CustomSortOrder -Eigenschaft, um sicherzustellen, dass dieser Begriff nach anderen Bedingungen Benutzerdefiniert sortiert wird.

Diese Methode wird nicht unterstützt, wenn die Eigenschaft IsReadOnly gleich trueist.