esri_attributes_get (AutoLISP)

Esta función obtiene una lista asociada de los nombres de campos y sus valores de atributos.

Uso:

• Si solo se proporciona el nombre de la entidad, se devuelven todos los campos de atributos y sus valores almacenados en la entidad.
• Si se proporciona el valor FLNAME, solo se incluyen los atributos pertenecientes a esa capa de entidad; no obstante, también se incluyen los valores predeterminados.
• Si se proporciona el valor FIELDNAME, solo se devuelve ese nombre de campo específico y su valor.
• Si se proporcionan los valores FLNAME y FIELDNAME, solo se devuelve el valor almacenado del campo o su valor predeterminado en una lista como un par de puntos y solo si pertenece a la capa de entidad.

Sintaxis

(esri_attributes_get ename [attribute_settings])

Argumentos

• ename |AutoCAD nombre de entidad | obligatorio | El nombre de entidad AutoCAD de la entidad.

• attribute_settings | lista asociada | opcional | Lista de ajustes opcionales como pares de puntos para limitar los campos y devolver valores predeterminados apropiados.

  Etiqueta asociada	Tipo de valor	Descripción del valor	Requerido/opcional
  "FLNAME"	cadena de caracteres	Nombre de la capa de entidades. Asume que la entidad es un miembro de esta capa de entidad y solo incluirá valores de campo de la capa de entidad especificada, y devolverá sus valores predeterminados.	opcional
  "FIELDNAME"	cadena de caracteres	Nombre de campo único para limitar el valor devuelto a este único campo. Si también se proporciona el valor FLNAME, el valor FIELDNAME debe existir en esa definición de clase de entidad.	opcional

Ejemplo de uso 1

Intente obtener todos los atributos de capa de entidades Centerlines para la entidad seleccionada.

(esri_attributes_get (car (entsel)) (list (cons "FLNAME" "Centerlines")))

Ejemplo de resultado de uso 1

Devuelve todos los atributos de la capa de entidades Centerlines para la entidad seleccionada como una lista asociada:

(("EntityHandle" . "252") ("EntityType" . "LWPOLYLINE") ("StreetName" . "S Roosevelt Blvd") ("Pavement" . 6) ("Rating" . 0.6259))

Ejemplo de uso 2

Intente obtener el valor de campo StreetName de la capa de entidades Centerlines correspondiente a la entidad seleccionada.

(esri_attributes_get (car (entsel)) (list (cons "FLNAME" "Centerlines") (cons "FIELDNAME" "StreetName")))

Ejemplo de resultado de uso 2

Devuelve el valor de campo StreetName para la entidad seleccionada como una lista asociada:

(("StreetName" . "White Street"))

Valores de retorno

Esta función devuelve un valor.

• Si todo va bien, devuelve una lista asociada de nombres de campos y valores como pares de puntos.
• 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 puede producir un valor de retorno fallido por cualquiera de los siguientes motivos:

• (nil ("Error" . "No attributes found on entity."))

  La entidad no tiene ninguno de los valores de campo especificados.

• (nil ("Error" . "Invalid associated list"))

  El parámetro attribute_settings se estructuró de forma incorrecta o contenía valores no válidos.

• (nil ("Error" . "Optional field value not found on entity."))

  La entidad no tiene el valor de campo especificado.

Consulte también

esri_featurelayer_getattributes | Una función para devolver una lista de listas asociadas de todos los atributos de todas las entidades de la capa de entidades especificada en el dibujo.