Interfaces de persistencia

Los objetos que tienen un estado persistente de cualquier tipo deben implementar al menos una interfaz IPersist*, y preferiblemente varias interfaces, con el fin de proporcionar al contenedor la opción más flexible de cómo desea guardar el estado de un control.

Si un control tiene cualquier estado persistente, debe, como mínimo, implementar IPersistStream o IPersistStreamInit (los dos son mutuamente excluyentes y no deben implementarse juntos para la mayor parte). Este último se usa cuando un control desea saber cuándo se crea nuevo en lugar de volver a cargarse desde un estado persistente existente (IPersistStream no tiene la nueva funcionalidad creada). La existencia de cualquiera de las interfaces indica que el control puede guardar y cargar su estado persistente en una secuencia, es decir, una instancia de IStream.

Además de estas dos interfaces basadas en secuencias, las interfaces IPersist* enumeradas en la tabla siguiente se pueden proporcionar opcionalmente para admitir la persistencia en ubicaciones distintas de un IStream expandible.

Un conjunto de categorías de componentes se identifica para cubrir la compatibilidad con las interfaces de persistencia, consulte Categorías de componentes.

Interfaz Uso
IPersistMemory
El objeto puede guardar y cargar su estado en una matriz de bytes secuencial de longitud fija (en memoria).
IPersistStorage
El objeto puede guardar y cargar su estado en una instancia de IStorage . Los controles que deseen marcarse insertables como otros objetos de documento compuestos (para la inserción en contenedores no compatibles con control) deben admitir esta interfaz.
IPersistPropertyBag
El objeto puede guardar y cargar su estado como propiedades individuales escritas en IPropertyBag que implementa el contenedor. Esto se usa para la funcionalidad Guardar como texto en algunos contenedores.
IPersistMoniker
El objeto puede guardar y cargar su estado en una ubicación denominada por un moniker. El control llama a IMoniker::BindToStorage para recuperar la interfaz de almacenamiento que requiere, como IStorage, IStream, ILockBytes, IDataObject, etc.

Aunque la compatibilidad con IPersistPropertyBag es opcional, se recomienda encarecidamente como optimización para los contenedores con características guardar como texto, como Visual Basic.

A excepción de IPersistStream::GetSizeMax, IPersistStreamInit::GetSizeMax e IPersistMemory::GetSizeMax, todos los métodos de cada interfaz deben implementarse completamente.

Controles