(String, String, StringMatchOption, Boolean) del método TermSet.GetTermsWithCustomProperty

Artículo
03/15/2016

Obtiene una colección de objetos Term con una propiedad personalizada a partir de o que coinciden con el nombre de propiedad proporcionado y el valor de la propiedad proporcionada.

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

Sintaxis

'Declaración
Public Function GetTermsWithCustomProperty ( _
    customPropertyName As String, _
    customPropertyValue As String, _
    stringMatchOption As StringMatchOption, _
    trimUnavailable As Boolean _
) As TermCollection
'Uso
Dim instance As TermSet
Dim customPropertyName As String
Dim customPropertyValue As String
Dim stringMatchOption As StringMatchOption
Dim trimUnavailable As Boolean
Dim returnValue As TermCollection

returnValue = instance.GetTermsWithCustomProperty(customPropertyName, _
    customPropertyValue, stringMatchOption, _
    trimUnavailable)

public TermCollection GetTermsWithCustomProperty(
    string customPropertyName,
    string customPropertyValue,
    StringMatchOption stringMatchOption,
    bool trimUnavailable
)

Parámetros

customPropertyName
Tipo: System.String

El nombre de propiedad personalizada

customPropertyValue
Tipo: System.String

El valor de la propiedad personalizada

stringMatchOption
Tipo: Microsoft.SharePoint.Taxonomy.StringMatchOption

Si desea buscar los nombres de propiedad personalizada y los valores que comienzan con las cadenas especificadas o busque aquellos que coincidan exactamente con las cadenas especificadas.

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 objetos Term con una propiedad personalizada a partir de o que coinciden con el nombre de propiedad proporcionado y el valor de la propiedad proporcionada.

Excepciones

Excepción	Condición
ArgumentNullException	El customPropertyName no puede ser una referencia null (Nothing en Visual Basic) o estar vacío.
ArgumentException	El valor de customPropertyName no es válido. Probablemente contiene caracteres no válidos o es demasiado largo.
ArgumentNullException	El customPropertyValue no puede ser una referencia null (Nothing en Visual Basic) o estar vacío.
ArgumentException	El valor de customPropertyValue no es válido. Supera la longitud máxima permitida 255.
ArgumentException	El valor de customPropertyValue no es válido. Contiene un carácter no válido de \t, \no ambos.

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án todos los términos coincidentes independientemente de su valor de la propiedad IsAvailableForTagging . El customPropertyName 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 customPropertyValue 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 caracteres no válidos de \t o \n.La búsqueda distingue entre mayúsculas y minúsculas. Se devolverá un máximo de 100 resultados de esta búsqueda. 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.