Add

Espacio de nombres: Digi21.DigiNG.IO
Ensamblado: Digi21.DigiNG

Añade entidades al final del archivo de dibujo.

Sobrecargas

Método	Descripción
`Add(Entity)`	Añade una entidad.
`Add(IEnumerable<Entity>)`	Añade varias entidades, en el orden de la enumeración.
`Add(Line), Add(Point), Add(Text), Add(Polygon), Add(Complex)`	Añaden una entidad de ese tipo y la devuelven con su tipo de solo lectura.

Después de añadir una entidad, su propiedad Owner es el archivo. Una entidad que pertenece a otro archivo (su Owner es otro archivo) no se puede añadir: añade la copia que devuelve Clone(), que no pertenece a ningún archivo.

Add(Entity)

void Add(Entity entity);

Parámetro	Descripción
`entity`	Entity que se añade al final del archivo.

Add(IEnumerable<Entity>)

void Add(IEnumerable<Entity> entities);

Parámetro	Descripción
`entities`	Entidades que se añaden al final del archivo, en el orden de la enumeración.

Si una entidad pertenece a otro archivo, el método lanza la excepción al llegar a esa entidad. Lo que pasa con las entidades anteriores depende de la implementación: en Bin ya están añadidas; lee la página de cada clase.

Add(Line), Add(Point), Add(Text), Add(Polygon), Add(Complex)

ReadOnlyLine Add(Line line);
ReadOnlyPoint Add(Point point);
ReadOnlyText Add(Text text);
ReadOnlyPolygon Add(Polygon polygon);
ReadOnlyComplex Add(Complex complex);

Parámetro	Descripción
`line`, `point`, `text`, `polygon`, `complex`	Line, Point, Text, Polygon o Complex que se añade al final del archivo.

Valor devuelto: la misma instancia que recibe el método, con el tipo de solo lectura del que deriva: ReadOnlyLine, ReadOnlyPoint, ReadOnlyText, ReadOnlyPolygon o ReadOnlyComplex. Estas sobrecargas llaman a Add(Entity).

Excepciones

Excepción	Cuándo
`ArgumentNullException`	El parámetro es `null`.
`InvalidOperationException`	La entidad pertenece a otro archivo. También, en las implementaciones que comprueban CanWrite (por ejemplo `Bin`), el archivo está abierto en solo lectura.

Ejemplo

El ejemplo de IReadOnlyDrawingFile añade a un archivo la copia de cada punto de otro archivo.