TermSet.GetTerms método (String, Int32, Boolean)

Artigo
03/15/2016

Obtém uma coleção de todos os objetos Term do objeto atual TermSet com um Label no LCID especificado correspondência de cadeia de caracteres fornecida.

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

Sintaxe

'Declaração
Public Function GetTerms ( _
    termLabel As String, _
    lcid As Integer, _
    trimUnavailable As Boolean _
) As TermCollection
'Uso
Dim instance As TermSet
Dim termLabel As String
Dim lcid As Integer
Dim trimUnavailable As Boolean
Dim returnValue As TermCollection

returnValue = instance.GetTerms(termLabel, _
    lcid, trimUnavailable)

public TermCollection GetTerms(
    string termLabel,
    int lcid,
    bool trimUnavailable
)

Parâmetros

termLabel
Tipo: System.String

Label de Term para obter

lcid
Tipo: System.Int32

O identificador de localidade de Labels a ser correspondido.

trimUnavailable
Tipo: System.Boolean

Um valor booleano indicando se aparar objetos Term com a propriedade IsAvailableForTagging definida como false.

Valor retornado

Tipo: Microsoft.SharePoint.Taxonomy.TermCollection
Uma coleção de todos os objetos Term o atual TermSet com um objeto Label o LCID fornecido correspondência de cadeia de caracteres fornecida.

Exceções

Exceção	Condição
ArgumentNullException	O termLabel não pode ser uma referência nula (Nothing no Visual Basic) ou vazio.
ArgumentException	O valor de termLabel é inválido. Provavelmente, ele contém caracteres inválidos ou é muito longo.
ArgumentOutOfRangeException	O valor de lcid deve ser um dos idiomas de trabalho no objeto de TermStore atual.

Comentários

Se trimUnavailable for true, em seguida, objetos Term com a propriedade IsAvailableForTagging definida como false serão cortados dos resultados; Caso contrário, todos os objetos de Term serão retornados independentemente de seus valores de propriedade de IsAvailableForTagging . Todos os objetos de Term.Label no idioma correspondente no parâmetro lcid serão pesquisados por esse método.A pesquisa diferencia maiúsculas de minúsculas. Será retornado um máximo de 100 resultados da pesquisa.O termLabel não pode ser uma referência nula (Nothing no Visual Basic) ou vazio e não deve exceder 255 caracteres. Ele também não pode conter os seguintes caracteres ilegais ; "< >|&tab. O valor de lcid deve ser um dos idiomas de trabalho do objeto TermStore , especificado pela propriedade Languages() . Para obter os resultados mais precisos, a Microsoft recomenda usando o método CommitAll() para confirmar as alterações para o banco de dados antes de executar a pesquisa.