Cómo: Crear un participante de persistencia personalizado
Este tema es aplicable a Windows Workflow Foundation 4.
El siguiente procedimiento describe los pasos para crear un participante de persistencia. Vea el ejemplo sobre la participación en la persistencia y el tema Extensibilidad de almacén para ver implementaciones de ejemplo de participantes de persistencia.
Cree una clase que derive de la clase PersistenceParticipant o PersistenceIOParticipant. La clase PersistenceIOParticipant proporciona los mismos puntos de extensibilidad que la clase PersistenceParticipant además de poder participar en operaciones de E/S. Siga uno o varios de los pasos siguientes:
Implemente el método CollectValues. El método CollectValues tiene dos parámetros de diccionario, uno para almacenar los valores de lectura y escritura, y el otro para almacenar los valores de sólo escritura (se usa después en consultas). En este método, debería rellenar estos diccionarios con datos que sean específicos de un participante de persistencia. Cada diccionario contiene el nombre del valor como clave y el propio valor como un objeto InstanceValue.
Los valores en el diccionario de readWriteValues se empaquetan como objetos InstanceValue. Los valores en el diccionario de sólo escritura se empaquetan como objetos InstanceValue con InstanceValueOptions.Optional y el conjunto de InstanceValueOption.WriteOnly. Cada InstanceValue proporcionado por las implementaciones de CollectValues en todos los participantes de persistencia debe tener un nombre único.
protected virtual void CollectValues (out IDictionary<XName,Object> readWriteValues, out IDictionary<XName,Object> writeOnlyValues)Implemente el método MapValues. El método MapValues toma dos parámetros que son similares a los parámetros que el método CollectValues recibe. Todos los valores recogidos en la fase CollectValues se pasan a través de estos parámetros de diccionario. Los nuevos valores agregados por la fase MapValues se agregan a los valores de sólo escritura. Cada valor proporcionado por implementaciones del método MapValues en todos los participantes de persistencia debe tener un nombre único.
protected virtual IDictionary<XName,Object> MapValues (IDictionary<XName,Object> readWriteValues,IDictionary<XName,Object> writeOnlyValues)Implemente el método PublishValues. El método PublishValues recibe un diccionario que contiene todos los valores cargados desde el almacén de persistencia.
protected virtual void PublishValues (IDictionary<XName,Object> readWriteValues)Implemente el método BeginOnSave si el participante es un participante de E/S de persistencia. A este método se llama durante una operación de almacenamiento. En este método, debería realizar al adjunto de E/S en las instancias de flujo de trabajo de persistencia (almacenamiento). Si el host está usando una transacción para el comando de persistencia correspondiente, se proporciona la misma transacción en Transaction.Current. Además, PersistenceIOParticipants puede anunciar un requisito de coherencia transaccional, en cuyo caso el host crea una transacción para el episodio de persistencia si, por el contrario, no se usara uno.
protected virtual IAsyncResult BeginOnSave (IDictionary<XName,Object> readWriteValues, IDictionary<XName,Object> writeOnlyValues, TimeSpan timeout, AsyncCallback callback, Object state)Implemente el método BeginOnLoad si el participante es un participante de E/S de persistencia. A este método se llama durante una operación de carga. En este método, debería realizar al adjunto de E/S en la carga de instancias de flujo de trabajo. Si el host está usando una transacción para el comando de persistencia correspondiente, se proporciona la misma transacción en Transaction.Current. Además, los participantes de E/S de persistencia pueden anunciar un requisito de coherencia transaccional, en cuyo caso el host crea una transacción para el episodio de persistencia si, de lo contrario, no se usara uno.
protected virtual IAsyncResult BeginOnLoad (IDictionary<XName,Object> readWriteValues, TimeSpan timeout, AsyncCallback callback, Object state)