PersistenceParticipant.CollectValues メソッド

定義

名前空間:

System.Activities.Persistence

アセンブリ:

System.Activities.dll

ホストはカスタムの永続化参加要素に対してこのメソッドを呼び出して、永続化される読み取り/書き込み値および書き込み専用値を収集します。

protected:
 virtual void CollectValues([Runtime::InteropServices::Out] System::Collections::Generic::IDictionary<System::Xml::Linq::XName ^, System::Object ^> ^ % readWriteValues, [Runtime::InteropServices::Out] System::Collections::Generic::IDictionary<System::Xml::Linq::XName ^, System::Object ^> ^ % writeOnlyValues);

protected virtual void CollectValues (out System.Collections.Generic.IDictionary<System.Xml.Linq.XName,object> readWriteValues, out System.Collections.Generic.IDictionary<System.Xml.Linq.XName,object> writeOnlyValues);

abstract member CollectValues : IDictionary * IDictionary -> unit
override this.CollectValues : IDictionary * IDictionary -> unit

Protected Overridable Sub CollectValues (ByRef readWriteValues As IDictionary(Of XName, Object), ByRef writeOnlyValues As IDictionary(Of XName, Object))

パラメーター

readWriteValues

IDictionary<XName,Object>

永続化される読み取り/書き込み値。

writeOnlyValues

IDictionary<XName,Object>

永続化される書き込み専用値。

例

PersistenceParticipant から派生したクラスでの CollectValues の使用方法を次のコード サンプルに示します。 この例は、 永続化の参加者 のサンプルからのものです。

public class StepCountExtension : PersistenceParticipant
{
    static XNamespace stepCountNamespace = XNamespace.Get("urn:schemas-microsoft-com:Microsoft.Samples.WF/WorkflowInstances/properties");
    static XName currentCountName = stepCountNamespace.GetName("CurrentCount");

    int currentCount;

    public int CurrentCount
    {
        get
        {
            return this.currentCount;
        }
    }

    internal void IncrementStepCount()
    {
        this.currentCount += 1;
    }

    protected override void CollectValues(out IDictionary<XName, object> readWriteValues, out IDictionary<XName, object> writeOnlyValues)
    {
        readWriteValues = new Dictionary<XName, object>(1) { { currentCountName, this.currentCount } };
        writeOnlyValues = null;
    }

    protected override void PublishValues(IDictionary<XName, object> readWriteValues)
    {
        object loadedData;
        if (readWriteValues.TryGetValue(currentCountName, out loadedData))
        {
            this.currentCount = (int)loadedData;
        }
    }
}

注釈

ホストは、InstanceValue コレクションの InstanceData オブジェクトとして、読み取り/書き込み値を最初のディクショナリにパッケージ化し、InstanceValue および Optional フラグが設定された WriteOnly オブジェクトとして、書き込み専用値を 2 番目のディクショナリにパッケージ化します。 詳細については、「InstanceValueOptions」を参照してください。

重要

1 つの永続化内のすべての永続参加要素について CollectValues の実装によって形成される各値は、一意の Xname を持つ必要があります。