(String, Int32) del método TermSetItem.CreateTerm

Artículo
03/15/2016

Crea un nuevo Term a continuación de esta instancia de TaxonomyItem .El nombre es la etiqueta predeterminada para el LCID especificado.

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

Sintaxis

'Declaración
Public Function CreateTerm ( _
    name As String, _
    lcid As Integer _
) As Term
'Uso
Dim instance As TermSetItem
Dim name As String
Dim lcid As Integer
Dim returnValue As Term

returnValue = instance.CreateTerm(name, _
    lcid)

public Term CreateTerm(
    string name,
    int lcid
)

Parámetros

name
Tipo: System.String

Etiqueta predeterminada para el lcid

lcid
Tipo: System.Int32

LCID para crear la etiqueta en

Valor devuelto

Tipo: Microsoft.SharePoint.Taxonomy.Term
El objeto recién creado Term

Excepciones

Excepción	Condición
UnauthorizedAccessException	El usuario no tiene permisos suficientes para realizar esta operación.
TermStoreOperationException	Esta operación no es válida en el conjunto de términos Términos huérfanos.Error en la operación.
TermStoreOperationException	Conjunto sólo permite una lista plana de Terms.
ArgumentException	El nombre no es válido, contiene caracteres no válidos o es demasiado largo.
ArgumentNullException	El nombre es una referencia null (Nothing en Visual Basic) o una cadena vacía.
ArgumentOutOfRangeException	El LCID no es válido.

Comentarios

Si el objeto TaxonomyTermSet para este TaxonomyItem no es un TermSet abierto el usuario actual debe tener permisos de EditTerm para poder utilizar este método.

Si el lcid especificado no es el idioma predeterminado de la TermStore, también se creará un Label con el nombre y el idioma predeterminado de la TermStore para asegurarse de que el Term tiene un valor predeterminado Label para el idioma predeterminado de la TermStore.

Si el actual TermSetItem es el conjunto de términos de palabras clave, etiqueta siempre se crea para el idioma predeterminado del término almacén.

El valor de name es normailized para recortar espacios consecutivos en uno y reemplazar el carácter & con la versión de caracteres anchos del carácter (\uFF06). Se eliminarán los espacios iniciales y finales. Debe ser no vacía y no puede superar los 255 caracteres y no puede contener ninguno de los caracteres siguientes; "<>|&tab.

El usuario actual se establecerá como el propietario de la nueva Term.