TaxonomySession.GetTerms Method (String, Boolean, StringMatchOption, Int32, Boolean)

Searches Label objects in all working languages, and returns Term objects from all TermSet objects, which are not scoped to a SPSite object, from all TermStore objects with a Label object matching the provided string.

Namespace:  Microsoft.SharePoint.Taxonomy
Assembly:  Microsoft.SharePoint.Taxonomy (in Microsoft.SharePoint.Taxonomy.dll)

Syntax

'Declaration
Public Function GetTerms ( _
    termLabel As String, _
    defaultLabelOnly As Boolean, _
    stringMatchOption As StringMatchOption, _
    resultCollectionSize As Integer, _
    trimUnavailable As Boolean _
) As TermCollection
'Usage
Dim instance As TaxonomySession
Dim termLabel As String
Dim defaultLabelOnly As Boolean
Dim stringMatchOption As StringMatchOption
Dim resultCollectionSize As Integer
Dim trimUnavailable As Boolean
Dim returnValue As TermCollection

returnValue = instance.GetTerms(termLabel, _
    defaultLabelOnly, stringMatchOption, _
    resultCollectionSize, trimUnavailable)

public TermCollection GetTerms(
    string termLabel,
    bool defaultLabelOnly,
    StringMatchOption stringMatchOption,
    int resultCollectionSize,
    bool trimUnavailable
)

Parameters

• termLabel
  Type: System.String

  String to search

• defaultLabelOnly
  Type: System.Boolean

  yes if it only searches default Label objects; no if it searches all Label objects.

• stringMatchOption
  Type: Microsoft.SharePoint.Taxonomy.StringMatchOption

  How the string is matched

• resultCollectionSize
  Type: System.Int32

  The maximum number of Term objects to return from each TermStore object.

• trimUnavailable
  Type: System.Boolean

  yes if it trims away the unavailable Term objects from the result collection; no if it includes the unavailable Term objects in the result collection.

Return Value

Type: Microsoft.SharePoint.Taxonomy.TermCollection
A sorted collection of Term objects

Remarks

The search results are directly from the TermStore object. It may not be synchronized with changes that have been made but not committed. For best results, call the CommitAll method or call the RollbackAll method before calling this method.

See Also

Reference

TaxonomySession Class

TaxonomySession Members

GetTerms Overload

Microsoft.SharePoint.Taxonomy Namespace

Term

Labels