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

Artículo
03/15/2016

Obtiene una colección de todos los objetos de Term desde el objeto de TermSet actual con un Label en el LCID especificado que coinciden con la cadena proporcionada.

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

Sintaxis

'Declaración
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

El Label de la Term para obtener

lcid
Tipo: System.Int32

El identificador de configuración regional de la Labels para coincidir.

trimUnavailable
Tipo: System.Boolean

Un valor booleano que indica si se va a recortar objetos Term que tienen la propiedad IsAvailableForTagging establecida en false.

Valor devuelto

Tipo: Microsoft.SharePoint.Taxonomy.TermCollection
Una colección de todos los objetos de la actual TermSetTerm con un objeto Label en el LCID proporcionado que coinciden con la cadena proporcionada.

Excepciones

Excepción	Condición
ArgumentNullException	El termLabel no puede ser una referencia null (Nothing en Visual Basic) o estar vacío.
ArgumentException	El valor de termLabel no es válido. Probablemente contiene caracteres no válidos o es demasiado largo.
ArgumentOutOfRangeException	El valor de lcid debe ser una de las lenguas de trabajo en el objeto de TermStore actual.

Comentarios

Si trimUnavailable es true, objetos Term con la propiedad IsAvailableForTagging establecida en false se eliminarán de los resultados; de lo contrario, se devolverá Term todos los objetos independientemente de su valor de la propiedad IsAvailableForTagging . Este método se buscará en todos los objetos Term.Label en el lenguaje que coinciden con el parámetro lcid .La búsqueda distingue entre mayúsculas y minúsculas. Se devolverá un máximo de 100 resultados de esta búsqueda.El termLabel no puede ser una referencia null (Nothing en Visual Basic) o vacía y no debe superar los 255 caracteres de longitud. Tampoco puede contener cualquiera de los siguientes caracteres no válidos ; "< >|&tab. El valor de lcid debe ser una de las lenguas de trabajo del objeto TermStore , especificado por la propiedad Languages() . Para obtener resultados más precisos, Microsoft recomienda utilizar el método CommitAll() para confirmar los cambios a la base de datos antes de realizar esta búsqueda.