esri_attributes_get (AutoLISP)

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

Las siguientes son notas de 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, como sigue:

  Etiqueta asociada	Tipo de valor	Descripción del valor	Obligatorio u opcional
  "FLNAME"	cadena	Nombre de la capa de entidades. Se supone 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	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

Devuelva 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

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

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

Valores de retorno

Los siguientes son los valores de retorno posibles:

• Si todo va bien, la función 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" . "Feature layer not found."))

  La capa de entidades especificada no existe en el archivo.

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

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

• (nil ("Error" . "No fields found."))

  Se proporcionó un nombre de campo incorrecto.

Consulte también

esri_featurelayer_getattributes: función que devuelve una lista de listas asociadas de todos los atributos de todas las entidades de la capa de entidades especificada en el dibujo.