TrackingProfileSerializer.Serialize(TextWriter, TrackingProfile) Метод

Определение

Пространство имен:

System.Workflow.Runtime.Tracking

Сборка:

System.Workflow.Runtime.dll

Сериализует профиль отслеживания в документ XML при помощи определения XML-схемы (XSD) профиля отслеживания.

public:
 void Serialize(System::IO::TextWriter ^ writer, System::Workflow::Runtime::Tracking::TrackingProfile ^ profile);

public void Serialize (System.IO.TextWriter writer, System.Workflow.Runtime.Tracking.TrackingProfile profile);

member this.Serialize : System.IO.TextWriter * System.Workflow.Runtime.Tracking.TrackingProfile -> unit

Public Sub Serialize (writer As TextWriter, profile As TrackingProfile)

Параметры

writer

TextWriter

Допустимый класс TrackingProfile.

profile

TrackingProfile

При возврате этого метода он содержит класс TextWriter, в котором содержится документ XML. Этот параметр передается неинициализированным.

Исключения

ArgumentNullException

profile имеет значение null.

-или-

writer имеет значение null.

ArgumentException

Параметр profile является недопустимым профилем отслеживания.

Примеры

В следующем образце кода показывается, как создавать класс TrackingProfileSerializer, используя метод TrackingProfileSerializer конструктора для сериализации класса TrackingProfile. Данный код также использует метод Serialize.

Данный пример кода является частью образца пакета SDK "Query using SQLTrackingService" из файла Program.cs. Дополнительные сведения см. в статье Запрос с помощью SQLTrackingService.

private static void CreateAndInsertTrackingProfile()
{
    TrackingProfile profile = new TrackingProfile();
    ActivityTrackPoint activityTrack = new ActivityTrackPoint();
    ActivityTrackingLocation activityLocation = new ActivityTrackingLocation(typeof(Activity));
    activityLocation.MatchDerivedTypes = true;
    IEnumerable<ActivityExecutionStatus> statuses = Enum.GetValues(typeof(ActivityExecutionStatus)) as IEnumerable<ActivityExecutionStatus>;
    foreach (ActivityExecutionStatus status in statuses)
    {
        activityLocation.ExecutionStatusEvents.Add(status);
    }

    activityTrack.MatchingLocations.Add(activityLocation);
    profile.ActivityTrackPoints.Add(activityTrack);
    profile.Version = version;

    WorkflowTrackPoint workflowTrack = new WorkflowTrackPoint();
    WorkflowTrackingLocation workflowLocation = new WorkflowTrackingLocation();
    IEnumerable<TrackingWorkflowEvent> eventStatuses = Enum.GetValues(typeof(TrackingWorkflowEvent)) as IEnumerable<TrackingWorkflowEvent>;
    foreach (TrackingWorkflowEvent status in eventStatuses)
    {
        workflowLocation.Events.Add(status);
    }

    workflowTrack.MatchingLocation = workflowLocation;
    profile.WorkflowTrackPoints.Add(workflowTrack);

    TrackingProfileSerializer serializer = new TrackingProfileSerializer();
    StringWriter writer = new StringWriter(new StringBuilder(), CultureInfo.InvariantCulture);
    serializer.Serialize(writer, profile);
    string trackingprofile = writer.ToString();
    InsertTrackingProfile(trackingprofile);
}

Shared Sub CreateAndInsertTrackingProfile()
    Dim profile As TrackingProfile = New TrackingProfile()

    Dim activityTrack As ActivityTrackPoint = New ActivityTrackPoint()
    Dim activityLocation As ActivityTrackingLocation = New ActivityTrackingLocation(GetType(Activity))
    activityLocation.MatchDerivedTypes = True
    Dim statuses As IEnumerable(Of ActivityExecutionStatus) = CType(System.Enum.GetValues(GetType(ActivityExecutionStatus)), IEnumerable(Of ActivityExecutionStatus))
    For Each status As ActivityExecutionStatus In statuses
        activityLocation.ExecutionStatusEvents.Add(status)
    Next

    activityTrack.MatchingLocations.Add(activityLocation)
    profile.ActivityTrackPoints.Add(activityTrack)
    profile.Version = version

    Dim workflowTrack As WorkflowTrackPoint = New WorkflowTrackPoint()
    Dim workflowLocation As WorkflowTrackingLocation = New WorkflowTrackingLocation()
    Dim eventStatuses As IEnumerable(Of TrackingWorkflowEvent) = CType(System.Enum.GetValues(GetType(TrackingWorkflowEvent)), IEnumerable(Of TrackingWorkflowEvent))
    For Each status As TrackingWorkflowEvent In eventStatuses
        workflowLocation.Events.Add(status)
    Next

    workflowTrack.MatchingLocation = workflowLocation
    profile.WorkflowTrackPoints.Add(workflowTrack)

    Dim serializer As TrackingProfileSerializer = New TrackingProfileSerializer()
    Dim writer As StringWriter = New StringWriter(New StringBuilder(), CultureInfo.InvariantCulture)
    serializer.Serialize(writer, profile)
    Dim trackingProfile As String = writer.ToString()
    InsertTrackingProfile(trackingProfile)
End Sub

Комментарии

Сериализация относится к процессу создания документа XML с правильным форматом из допустимого класса TrackingProfile. Serialize использует профиль отслеживания Schema для сериализации профиля отслеживания. profile должен быть допустимым профилем TrackingProfile, который содержит хотя бы одну допустимую точку отслеживания. Проверка профиля отслеживания производится во время сериализации и, если профиль отслеживания оказывается недопустимым, то выдается класс ArgumentException. Это исключение можно взять и изучить свойство сообщения, чтобы определить причину возникновения ошибки проверки. Если при сериализации профиля отслеживания остаются необработанные исключения, то экземпляр рабочего процесса, для которого был запрошен профиль отслеживания, будет завершен.

См. также раздел

• Запрос с помощью SQLTrackingService