Diese Funktion ruft eine Assoziationsliste der Feldnamen und ihrer Attributwerte ab.
Verwendung:
- Wenn nur der Objektname bereitgestellt wird, werden alle im Objekt gespeicherten Attributfelder und deren Werte zurückgegeben.
- Bei Angabe des Werts für FLNAME werden nur Attribute zurückgegeben, die zu diesem Feature-Layer gehören. Allerdings werden die Standardwerte ebenfalls zurückgegeben.
- Bei Angabe des Wertes für FIELDNAME werden nur dieser Feldname und dessen Wert zurückgegeben.
- Wenn sowohl der FLNAME als auch der FIELDNAME angegeben werden, werden nur der gespeicherte Wert des Feldes oder dessen Standardwert in einer Liste bestehend aus einer Paarliste (dotted pair) zurückgegeben, und dies auch nur dann, wenn das Feld zum Feature-Layer gehört.
Syntax
(esri_attributes_get ename [attribute_settings])
Argumente
- ename | AutoCAD-Objektname | erforderlich | Der AutoCAD-Objektname des Features.
- attribute_settings | Assoziationsliste | optional | Liste der optionalen Einstellungen in Form von Paarlisten (dotted pairs), um die Felder zu begrenzen und geeignete Standardwerte zurückzugeben.
Assoziierte Bezeichnung Wertetyp Wertbeschreibung Erforderlich/Optional "FLNAME" Zeichenfolge
Feature-Layer-Name Setzt voraus, dass das Objekt ein Member dieses Feature-Layers ist, schließt nur Feldwerte für den angegebenen Feature-Layer ein und gibt dessen Standardwerte zurück.
Optional
"FIELDNAME" Zeichenfolge
Einzelner Feldname zur Begrenzung der Rückgabe auf dieses eine Feld. Wenn der Wert für FLNAME ebenfalls angegeben ist, muss der Wert für FIELDNAME in der Feature-Class-Definition enthalten sein.
Optional
Beispiel 1 für die Verwendung
Versuchen Sie, alle Attribute des Feature-Layers Centerlines für das ausgewählte Objekt abzurufen.(esri_attributes_get (car (entsel)) (list (cons "FLNAME" "Centerlines")))
Ergebnis des Beispiels 1 für die Verwendung
Gibt alle Attribute des Feature-Layers Centerlines für das ausgewählte Objekt als Assoziationsliste zurück:
(("EntityHandle" . "252") ("EntityType" . "LWPOLYLINE") ("StreetName" . "S Roosevelt Blvd") ("Pavement" . 6) ("Rating" . 0.6259))Beispiel 2 für die Verwendung
Versuchen Sie, den Steetname-Feldwert aus einem der Feature-Layer für das ausgewählte Objekt abzurufen.(esri_attributes_get (car (entsel)) (list (cons "FLNAME" "Centerlines") (cons "FIELDNAME" "StreetName")))
Ergebnis des Beispiels 2 für die Verwendung
Gibt die StreetName-Feldwerte für das ausgewählte Objekt als Assoziationsliste zurück:
(("StreetName" . "White Street"))Rückgabewerte
Von dieser Funktion wird ein Wert zurückgegeben.
- Falls erfolgreich: Gibt eine Assoziationsliste von Feldnamen und -werten in Form von Paarlisten (dotted pairs) zurück.
- Wenn bei dem Vorgang ein Fehler auftritt, wird eine Liste zurückgegeben, in der der erste Wert nil lautet. Anschließend wird eine Assoziationsliste mit dem Schlüsselwert Error sowie eine entsprechende Fehlermeldung in Form einer Zeichenfolge zurückgegeben: (nil ("Error" . "<message>")).
Rückgabewerte mit Fehlern
Ein Rückgabewert mit einem Fehler kann eine der folgenden Ursachen haben:
- (nil ("Error" . "No attributes found on entity."))
Das Objekt enthält keinen der angegebenen Feldwerte.
- (nil ("Error" . "Invalid associated list"))
Der Parameter attribute_settings wurde nicht ordnungsgemäß strukturiert oder enthielt ungültige Werte.
- (nil ("Error" . "Optional field value not found on entity."))
Dsa Objekt enthält den angegebenen Feldwert nicht.
Weitere Informationen
esri_featurelayer_getattributes | Eine Funktion zur Rückgabe einer Liste von Assoziationslisten aller Attribute aller Features des angegebenen Feature-Layers in der Zeichnung.