Diese Funktion fügt Feature-Attribute zu einem Objekt eines Feature-Layers hinzu oder ändert sie. Wenn das Feld im Objekt vorhanden ist und der angegebene Feldtyp dem bereitgestellten Wert entspricht, wird der vorhandene Wert überschrieben.
Hinweis:
Einige Felder können schreibgeschützt sein. Weitere Informationen finden Sie im Thema Feldattribute.
Syntax
(esri_attributes_set ename flname settings_list)
Argumente
- ename | Zeichenfolge | erforderlich | Der AutoCAD-Objektname des Features.
- flname | Zeichenfolge | erforderlich | Ein vorhandener Feature-Layer-Name in der Zeichnung.
- settings_list | Assoziationsliste | erforderlich | Eine Assoziationsliste von Feldnamen und -werten in Form von Paarlisten (dotted pairs).
Assoziierte Bezeichnung Wertetyp Wertbeschreibung Erforderlich/Optional "<field name>" Variant-Datentyp
Name und Wert des Feldes.
Hinweis:
Wenn Sie mit Feldern arbeiten, die über codierte Domänenwerte verfügen, verwenden Sie den Wert der Feldbeschreibung und nicht den Code.
Erforderlich
...
...
...
Optional
Beispiel für die Verwendung
Legen Sie die Attributwerte StreetName, Pavement und Rating des zuletzt erstellten Feature-Objekts Centerlines fest.(esri_attributes_set
(entlast)
"Centerlines"
(list
(cons "StreetName" "Main")
(cons "PAVEMENT" 2)
(cons "Rating" 0.852)
))
Ergebnis des Beispiels für die Verwendung
Legt die Attributwerte StreetName, Pavement und Rating des zuletzt erstellten Feature-Objekts Centerlines fest und gibt eine Liste mit "true" zurück:
(T)
Rückgabewerte
Folgende Werte sind mögliche Rückgabewerte:
- Bei erfolgreicher Ausführung gibt die Funktion eine Liste mit "true" zurück: (T)
- 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
Rückgabewerte mit Fehlern können eine der folgenden Ursachen haben:
- (nil ("Error" . "Missing required argument."))
Eines der erforderlichen Argumente wurde nicht angegeben.
- (nil ("Error" . "No valid fields specified."))
Beim angegebenen Feld handelt es sich nicht um ein gültiges Feld des angegebenen Feature-Layers.
- (nil ("Error" . "Feature layer not found."))
Beim angegebenen Feature-Layer-Wert handelt es sich nicht um einen gültigen Feature-Layer in der Zeichnung.
- (nil ("Error" . "Invalid value for attribute."))
Der eingegebene Wert oder seine Formatierung ist für den angegebenen Feldtyp ungültig.