La función esri_fielddef_set establece la definición de campo para un campo de atributo de una capa de entidades de documento. No es posible actualizar el campo TYPE de un campo existente ni modificar la definición de campo de una capa de entidades web.
Sintaxis
(esri_fielddef_set flname field_properties)
Argumentos
- flname | cadena de caracteres | obligatorio | El nombre de una capa de entidades existente en el dibujo.
- field_properties| lista asociada | obligatorio | lista asociada de las propiedades de campo de la capa de entidades en forma de pares con punto, como sigue:
Etiqueta asociada Tipo de valor Descripción del valor Obligatorio u opcional "NAME" cadena
Nombre del campo.
Requerido
"LENGTH" entero
Longitud de campo de los campos de texto solamente.
Opcional (definidos en predeterminados de UI)
"VALUE" variante
Valor de campo predeterminado.
Opcional (definidos en predeterminados de UI)
"SUBTYPE" cadena
Nombre de subtipo de capa de entidades existente en el dibujo. Cuando se configura la definición de campo de una subcapa, establezca el valor predeterminado solamente.
Opcional
Uso de ejemplo
Intente actualizar la definición del campo Location de la capa de entidades Parks.(esri_fielddef_set "Parks"
(list
(cons "NAME" "Location")
(cons "LENGTH" 254)
(cons "VALUE" "CA")
))
Uso de ejemplo de resultado
Actualiza la definición del campo Location de la capa de entidades Parks y devuelve una lista true:
(T)Valores de retorno
Los siguientes son los valores de retorno posibles:
- Si todo va bien, la función devuelve una lista de true: (T).
- Si se produce un error, devuelve una lista con el primer valor de nil y, a continuación, se devuelve una lista asociada que contiene el valor de clave "Error" y un mensaje de error asociado como cadena de caracteres: (nil ( "Error" . "<message>")).
Valores de retorno fallido
Se pueden producir valores de retorno fallido por cualquiera de los siguientes motivos:
- (nil ("Error" . "Field is not editable"))
No es posible actualizar el tipo de campo de un campo existente ni modificar la definición de campo de una capa de entidades web.
- (nil ("Error" . "Input string was not in a correct format."))
El valor especificado era del tipo incorrecto.
- (nil ("Error" . "Document feature layer not found."))
El valor de la capa de entidades especificada no es una capa de entidades válida en el dibujo.
- (nil ("Error" . "No edits made"))
No se realizaron ediciones porque hubo un problema con la rutina tal como estaba escrita.