UserTaskEvent Класс

Определение

Класс, хранящий сведения о событии модели данных задачи пользователя.A class that stores information for user task data model event. Пользовательская задача — это операция приложения, которая ВЫЗЫВАЕТся пользователем напрямую и поставляется с результатом (например, успех, сбой).A user task is an application operation that is INVOKED BY USER directly and comes with result (e.g., Success, Failure). Он используется для анализа поведения пользователя/намерения.It is used for user behavior/intent analysis. Пользователь знает об операции и может выполнить.User is aware of the operation and be able to execute. Например, открытие проекта и отображение окон инструментов являются пользовательскими задачами. Вместо этого выполняется загрузка пакета VS и времени разработки.e.g. Open project and Show tool windows are user tasks; instead load VS package and Design time build are operations.

Для длительного выполнения или асинхронной задачи пользователя, чтобы понять, что остальное произошло во время или отслеживать, если она была частично завершена из-за ошибки, используйте метод StartUserTask(TelemetrySession, String) , который отслеживает начальную и конечную точки.For long-time running or async user task, in order to understand what else happened during the time or track if it partially completes because of an error, use method StartUserTask(TelemetrySession, String) which tracks both start and end points.

public ref class UserTaskEvent sealed : Microsoft::VisualStudio::Telemetry::OperationEvent
public sealed class UserTaskEvent : Microsoft.VisualStudio.Telemetry.OperationEvent
type UserTaskEvent = class
    inherit OperationEvent
Public NotInheritable Class UserTaskEvent
Inherits OperationEvent
Наследование

Конструкторы

UserTaskEvent(String, TelemetryResult, String)

Инициализирует новый экземпляр класса UserTaskEvent.Initializes a new instance of the UserTaskEvent class.

Свойства

Correlation

Возвращает корреляцию этого события.Gets correlation of this event. Он представляет это событие при взаимосвязи с другими событиями.It represents this event when correlated with other events.

(Унаследовано от TelemetryEvent)
DataSource

Возвращает источник данных.Gets data source.

(Унаследовано от TelemetryEvent)
Duration

Возвращает длительность операции, если тип этапа — End.Gets duration of the operation if the stage type is End. Возвращает значение NULL для других типов этапов.Return null for other stage types.

(Унаследовано от OperationEvent)
EndTime

Возвращает время окончания (в тактах) текущей операции с типом этапа "конец".Gets end time (in ticks) of current operation which stage type is End. Возвращает значение NULL для других типов этапов.Return null for other stage types.

(Унаследовано от OperationEvent)
EntityName

Возвращает имя сущностиGets entity name

(Унаследовано от OperationEvent)
EventSchemaVersion

Возвращает версию схемы для этого события.Gets schema version for this event.

(Унаследовано от TelemetryEvent)
EventType

Возвращает тип события для этого событияGets event type for this event

(Унаследовано от TelemetryEvent)
FeatureName

Возвращает имя функцииGets feature name

(Унаследовано от OperationEvent)
HasProperties

Возвращает значение, указывающее, созданы ли уже свойства.Gets a value indicating whether properties already created.

(Унаследовано от TelemetryEvent)
IsOptOutFriendly

Возвращает или задает значение, указывающее, является ли событие понятным для сеанса optOut.Gets or sets a value indicating whether event is friendly for the optOut session. По умолчанию используется значение false.By default it is false. Если он является понятным, он проходит только со свойствами события.If it is OptOut friendly it passes through with the event specific properties only. Это поведение можно изменить с помощью правил манифеста.This behaviour can be changed by manifest rules.

(Унаследовано от TelemetryEvent)
Name

Возвращает имя текущего событияGets current event name

(Унаследовано от TelemetryEvent)
ProductName

Возвращает название продуктаGets product name

(Унаследовано от OperationEvent)
Properties

Возвращает словарь свойств события.Gets a dictionary of event properties. Свойства — это измерения, по которым могут быть разделены агрегированные данные.Properties are dimensions that aggregated data can be sliced by. Ключ — это имя свойства, которое является уникальным, а не NULL и не пусто.The key is a property name that is unique, not null and not empty. Значением является любой объект, представляющий значение свойства.The value is any object that represents a property value. Каналы телеметрии должны использовать значение. ToString (CultureInfo. InvariantCulture) для отправки значения на сервер в виде строки.Telemetry channels must use value.ToString(CultureInfo.InvariantCulture) to send the value to a server as a string.

(Унаследовано от TelemetryEvent)
Result

Возвращает результат этой операции.Gets result from this operation.

(Унаследовано от OperationEvent)
ResultSummary

Возвращает сводку результатов из этой операции.Gets result summary from this operation.

(Унаследовано от OperationEvent)
Severity

Возвращает или задает уровень серьезности события.Gets or sets a severity level of the event. Уровень используется для потребителей событий (например, поставщик ETW, серверные отчеты) для упрощения организации данных.The level is used for event consumer (e.g., ETW provider, backend reporting) to organize data easier.

(Унаследовано от TelemetryEvent)
SharedPropertyBags

Получение контейнеров общих свойствGets shared property bags

(Унаследовано от TelemetryEvent)
StageType

Возвращает тип этапа из этой операции.Gets stage type from this operation.

(Унаследовано от OperationEvent)
StartEndPairId

Возвращает идентификатор пары для событий операции запуска.Gets pair id for start-end operation events. Это то же значение, что и CorrelationId.It is the same value as CorrelationId. Возвращает NULL для события атомарной операции.return null for atomic operation event.

(Унаследовано от OperationEvent)
StartTime

Возвращает время начала (в тактах) текущей операции, тип этапа в конце.Gets start time (in ticks) of current operation which stage type is End. Возвращает значение NULL для других типов этапов.Return null for other stage types.

(Унаследовано от OperationEvent)

Методы

Correlate(TelemetryEventCorrelation, String)

Сопоставьте это событие с другим событием через TelemetryEventCorrelation со сведениями о описании.Correlate this event with other event via TelemetryEventCorrelation with description information.

(Унаследовано от OperationEvent)
Correlate(TelemetryEventCorrelation[])

Сопоставьте это событие с другими событиями через TelemetryEventCorrelation .Correlate this event with other events via TelemetryEventCorrelation.

(Унаследовано от TelemetryEvent)
CorrelateWithDescription(TelemetryEventCorrelation, String)

Сопоставьте это событие с другим событием через TelemetryEventCorrelation со сведениями о описании.Correlate this event with other event via TelemetryEventCorrelation with description information.

(Унаследовано от TelemetryEvent)
GetDefaultEventProperties(Int64, Int64, String)

Возвращает свойства по умолчанию, которые должны быть в каждом ТелеметревентReturns default properties that should be on each TelemetryEvent

(Унаследовано от TelemetryEvent)
ToString()

ToString, чтобы упростить отладку: показывать в окне контрольных значений отладкиToString to make debugging easier: show in debug watch window

(Унаследовано от TelemetryEvent)

Применяется к