Volharding

Een besturingselement implementeert een of meer van meerdere persistentieinterfaces ter ondersteuning van persistentie van de status. De IPersistStreamInit-interface ondersteunt bijvoorbeeld op stream gebaseerde persistentie van de status van het besturingselement. IPersistStreamInit is een vervanging voor IPersistStream- en voegt een initialisatiemethode toe, InitNew-. De andere methoden zijn hetzelfde in beide interfaces. IPersistStreamInit is niet afgeleid van IPersistStream; een object ondersteunt slechts één van de twee interfaces op basis van of het de mogelijkheid vereist om nieuwe exemplaren van zichzelf te initialiseren.

Andere persistentie-interfaces die een besturingselement kan bieden zijn: IPersistStorage, IPersistMemory, IPersistPropertyBag, IPersistMoniker. De controle-implementeerfunctie moet bepalen welke soorten persistentie het belangrijkst zijn en de juiste persistentieinterfaces implementeren. De besturingselement-implementeerfunctie bepaalt ook wat u wilt opslaan. Een besturingselement kan bijvoorbeeld de huidige waarden van de eigenschappen of de locatie en grootte ervan in de container opslaan. De client bepaalt welke interface het liever gebruikt.

Voordat u een besturingselement laadt vanuit de permanente status, kan een client de OLEMISC_SETCLIENTSITEFIRST vlag controleren om te bepalen of het besturingselement ondersteuning biedt voor het ophalen van de clientsite en omgevingseigenschappen voordat de permanente status wordt geladen. Deze optimalisatie kan tijd besparen bij het instantiëren van een besturingselement, omdat het besturingselement vervolgens vrij is om de permanente waarden te negeren in plaats van ze alleen te laden zodat ze alleen worden overschreven door omgevingseigenschappen die door de client worden geleverd.

Een besturingselement kan ook ondersteuning bieden voor het opslaan en herstellen van de status in een OLE-eigenschappenset, een set id's en waarden in een opgegeven indeling. Deze functie kan handig zijn voor containers zoals Visual Basic, waarmee de programma's in een tekstvorm worden opgeslagen. Een besturingselement dat deze functie wil ondersteunen, implementeert IDataObject::GetData en IDataObject::SetData respectievelijk de eigenschapswaarden door te geven aan en van de container. Het is de taak van de container om deze informatie naar tekst te converteren en op te slaan. De id's die door het besturingselement worden gebruikt, komen overeen met de eigenschapsnamen en de waarden van het besturingselement. Zie de OLE CDK voor de definitie van deze eigenschappenset.

Verwante onderwerpen

ActiveX-besturingselementen