BinDouble

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

Archivo de dibujo en el formato binario de doble precisión de Digi3D.AI (.bind). Lee y escribe líneas, puntos, textos, polígonos y complejos, sus atributos, los archivos de referencia que guarda el archivo y, si se indica una base de datos, los atributos de base de datos de sus códigos.

public class BinDouble : IDrawingFile, IDisposable

Implementa: IDrawingFile, que a su vez implementa IReadOnlyDrawingFile, IEnumerable<Entity> e IWindow3D.

El archivo .bind empieza por una cabecera que guarda el WKT del sistema de referencia de coordenadas y las coordenadas mínimas y máximas del archivo. El formato no usa archivo .prj.

Al crear un BinDouble no se carga el archivo en memoria: las entidades se leen del disco a medida que se recorren con foreach.

Llama a Dispose (o usa using) para cerrar el archivo. Mientras un BinDouble abierto en escritura no se cierra, otros procesos pueden leer el archivo pero no escribir en él.

Constructores

public BinDouble(string path)
public BinDouble(string path, bool readOnly)
public BinDouble(string path, DelegateGetWkt GetWkt)
public BinDouble(string path, DelegateGetWkt GetWkt, bool readOnly)
public BinDouble(string path, DigiTab digiTab)
public BinDouble(string path, DigiTab digiTab, bool readOnly)
public BinDouble(string path, DigiTab digiTab, DelegateGetWkt GetWkt)
public BinDouble(string path, DigiTab digiTab, DelegateGetWkt GetWkt, bool readOnly)
public BinDouble(string path, DatabaseConnectionProperties databaseProperties)
public BinDouble(string path, DatabaseConnectionProperties databaseProperties, bool readOnly)
public BinDouble(string path, DatabaseConnectionProperties databaseProperties, DelegateGetWkt GetWkt)
public BinDouble(string path, DatabaseConnectionProperties databaseProperties, DelegateGetWkt GetWkt, bool readOnly)
public BinDouble(string path, DatabaseConnectionProperties databaseProperties, DigiTab digiTab)
public BinDouble(string path, DatabaseConnectionProperties databaseProperties, DigiTab digiTab, bool readOnly)
public BinDouble(string path, DatabaseConnectionProperties databaseProperties, DigiTab digiTab, DelegateGetWkt GetWkt)
public BinDouble(string path, DatabaseConnectionProperties databaseProperties, DigiTab digiTab, DelegateGetWkt GetWkt, bool readOnly)

Abre el archivo path. Si readOnly es false (el valor de las sobrecargas sin readOnly) y el archivo no existe, lo crea.

Sistema de referencia de coordenadas:

• Si el archivo existe, se lee de su cabecera. Los archivos de la versión 1 del formato no lo guardan y se abren con un sistema local (desconocido).
• Si el archivo no existe, se usa el WKT que devuelve GetWkt o, sin delegado, un sistema local, y se escribe en la cabecera del archivo nuevo.

Base de datos:

• Sin el parámetro databaseProperties, el archivo se abre sin base de datos.
• La base de datos se abre en solo lectura si readOnly es true, y en lectura y escritura si es false.
• Al conectar con una base de datos, el constructor notifica con ResultsAdded el modelo de datos, la cadena de conexión y el final de la conexión.

Si readOnly es false y el archivo existe pero no se puede abrir en escritura (por ejemplo, porque otro proceso lo tiene abierto o porque tiene el atributo de solo lectura), el archivo se abre en solo lectura y CanWrite vale false. El constructor no lanza ninguna excepción en ese caso.

Los constructores lanzan Exception, con el mensaje del error, en estos casos:

• no se puede abrir ni crear el archivo;
• el archivo no empieza por la cabecera del formato .bind, o es de una versión del formato posterior a la 5;
• el modelo de datos de DataModel no existe, o no se puede conectar con la base de datos.

Los avisos que se producen dentro del constructor se notifican con el evento TaskAdded antes de que el constructor termine. Un manejador que se suscribe después de crear el BinDouble no recibe esos avisos.

Propiedades

Métodos

Excepciones de Add y Delete:

Si la entidad ya está guardada en este archivo, Add y Delete no la vuelven a escribir: solo actualizan en el archivo la marca de eliminada.

Eventos

DatabaseConnectionProperties

public struct DatabaseConnectionProperties

Base de datos con la que se conecta un BinDouble.

Con ConnectionString vacía o null (el valor de new DatabaseConnectionProperties()), el archivo se abre sin base de datos.

Ejemplo

Este programa abre un archivo .bind sin base de datos, muestra cuántas entidades de cada tipo tiene y lista sus archivos de referencia:

using Digi21.DigiNG.IO.BinDouble;

if (args.Length != 1)
{
    Console.WriteLine("Uso: InfoBind <archivo.bind>");
    return 1;
}

// Sin base de datos y en solo lectura.
using var archivo = new BinDouble(args[0], true);
archivo.TaskAdded += (sender, e) => Console.WriteLine($"{e.Task.Severity}: {e.Task.Title}");

var porTipo = new Dictionary<string, int>();
foreach (var entidad in archivo)
{
    if (entidad.Deleted)
        continue;

    var tipo = entidad.GetType().Name;
    porTipo[tipo] = porTipo.GetValueOrDefault(tipo) + 1;
}

foreach (var (tipo, número) in porTipo)
    Console.WriteLine($"{tipo}: {número}");

// Las entidades ya están leídas: ReferenceFiles no vuelve a recorrer el archivo.
foreach (var referencia in archivo.ReferenceFiles)
    Console.WriteLine($"Referencia: {referencia}");

return 0;

Los ejemplos Bind2Shape y MuestraAtributosBBDDGeometriasArchivoBinD abren un archivo .bind con una base de datos Access.