Skip To Content

FieldDefinition.Add (.NET)

La méthode FieldDefinition.Add ajoute une nouvelle définition de champ à une couche d’entités de document existante.

Remarque :

Vous ne pouvez pas modifier les définitions de champs d’une couche d’entités Web.

Déclaration

public string Esri.ArcGISForAutoCAD.FieldDefinition.Add(Document doc, string flName, string name, string type = "String", int length = 254, IConvertible value = null, bool readOnly = false)

Paramètres

TypeNomDescriptionRequis

Document

doc

Document AutoCAD sur lequel intervenir.

required

chaîne

flName

Nom d’une couche d’entités de document existante dans le dessin.

required

chaîne

name

Nouveau nom de champ.

required

chaîne

type

Valeur du type de champ : "Double", "Short", "GUID", "Integer", "String", "Float" ou "Date".

facultatif ("String" par défaut)

entier

length

Longueur du champ.

facultatif

IConvertible

value

Valeur par défaut du champ.

Remarque :

Lorsque vous utilisez des champs contenant des valeurs de domaine codées, value est la description et non le code.

facultatif

bool

readOnly

Indique si le nouveau champ est en lecture seule.

facultatif (false par défaut)

Retours

TypeDescription

chaîne

Nom du nouveau champ.

Remarques sur les conditions d’erreur

Si un paramètre n’est pas valide, cette méthode peut générer une exception, ou renvoyer une chaîne vide ou null.

Exemple

Ajouter un champ d’entier court nommé YearPurchased à la couche d’entités Parks (Parcs) et afficher le nom du nouveau champ.

// Initialize
var doc = Application.DocumentManager.MdiActiveDocument;

// Add field definition
var addedField = Esri.ArcGISForAutoCAD.FieldDefinition.Add(doc, "Parks", "YearPurchased", "Short", 254, 1954);

// Print new field name
doc.Editor.WriteMessage("New field: " + addedField);

/* Example output
New field: YearPurchased
*/

Voir aussi

esri_fielddef_add : fonction AutoLISP qui ajoute une définition de champ.