TelemetrySessionExtensions.StartUserTask Метод

Определение

Перегрузки

StartUserTask(TelemetrySession, String)

Запустите отслеживание пользовательской задачи, отправляя в UserTaskEvent Начало работы задачу пользователя, а затем возвращая TelemetryScope<T> объект.Start tracking user task by posting a UserTaskEvent at the beginning of user task work, and then return a TelemetryScope<T> object. По завершении задачи пользователя вызовите метод End(TelemetryResult, String) для публикации другой UserTaskEvent конечной точки.When the user task finishes, call method End(TelemetryResult, String) to post another UserTaskEvent for end point. Поскольку одно и то же имя события используется как для событий начала, так и для события окончания, не следует использовать Start или End в имени события.Because the same event name is used by both start and end events, please don't use Start or End in event name.

StartUserTask(TelemetrySession, String, TelemetryScopeSettings)

Запуск отслеживания пользовательской задачи путем отправки UserTaskEvent с указанными свойствами в начале работы задачи пользователя, а затем возврата TelemetryScope<T> объекта.Start tracking user task by posting a UserTaskEvent with specified properties at the beginning of user task work, and then return a TelemetryScope<T> object. По завершении задачи пользователя вызовите метод End(TelemetryResult, String) для публикации другой UserTaskEvent конечной точки.When the user task finishes, call method End(TelemetryResult, String) to post another UserTaskEvent for end point. Поскольку одно и то же имя события используется как для событий начала, так и для события окончания, не следует использовать Start или End в имени события.Because the same event name is used by both start and end events, please don't use Start or End in event name.

StartUserTask(TelemetrySession, String, TelemetrySeverity)

Запустите отслеживание пользовательской задачи, отправляя в UserTaskEvent Начало работы задачу пользователя, а затем возвращая TelemetryScope<T> объект.Start tracking user task by posting a UserTaskEvent at the beginning of user task work, and then return a TelemetryScope<T> object. По завершении задачи пользователя вызовите метод End(TelemetryResult, String) для публикации другой UserTaskEvent конечной точки.When the user task finishes, call method End(TelemetryResult, String) to post another UserTaskEvent for end point. Поскольку одно и то же имя события используется как для событий начала, так и для события окончания, не следует использовать Start или End в имени события.Because the same event name is used by both start and end events, please don't use Start or End in event name.

StartUserTask(TelemetrySession, String, TelemetrySeverity, IDictionary<String,Object>)

Запуск отслеживания пользовательской задачи путем отправки UserTaskEvent с указанными свойствами в начале работы задачи пользователя, а затем возврата TelemetryScope<T> объекта.Start tracking user task by posting a UserTaskEvent with specified properties at the beginning of user task work, and then return a TelemetryScope<T> object. По завершении задачи пользователя вызовите метод End(TelemetryResult, String) для публикации другой UserTaskEvent конечной точки.When the user task finishes, call method End(TelemetryResult, String) to post another UserTaskEvent for end point. Поскольку одно и то же имя события используется как для событий начала, так и для события окончания, не следует использовать Start или End в имени события.Because the same event name is used by both start and end events, please don't use Start or End in event name.

StartUserTask(TelemetrySession, String, TelemetrySeverity, IDictionary<String,Object>, TelemetryEventCorrelation[])

Запуск отслеживания пользовательской задачи путем отправки UserTaskEvent с указанными свойствами в начале работы задачи пользователя, а затем возврата TelemetryScope<T> объекта.Start tracking user task by posting a UserTaskEvent with specified properties at the beginning of user task work, and then return a TelemetryScope<T> object. По завершении задачи пользователя вызовите метод End(TelemetryResult, String) для публикации другой UserTaskEvent конечной точки.When the user task finishes, call method End(TelemetryResult, String) to post another UserTaskEvent for end point. Поскольку одно и то же имя события используется как для событий начала, так и для события окончания, не следует использовать Start или End в имени события.Because the same event name is used by both start and end events, please don't use Start or End in event name.

StartUserTask(TelemetrySession, String)

Запустите отслеживание пользовательской задачи, отправляя в UserTaskEvent Начало работы задачу пользователя, а затем возвращая TelemetryScope<T> объект.Start tracking user task by posting a UserTaskEvent at the beginning of user task work, and then return a TelemetryScope<T> object. По завершении задачи пользователя вызовите метод End(TelemetryResult, String) для публикации другой UserTaskEvent конечной точки.When the user task finishes, call method End(TelemetryResult, String) to post another UserTaskEvent for end point. Поскольку одно и то же имя события используется как для событий начала, так и для события окончания, не следует использовать Start или End в имени события.Because the same event name is used by both start and end events, please don't use Start or End in event name.

public:
[System::Runtime::CompilerServices::Extension]
 static Microsoft::VisualStudio::Telemetry::TelemetryScope<Microsoft::VisualStudio::Telemetry::UserTaskEvent ^> ^ StartUserTask(Microsoft::VisualStudio::Telemetry::TelemetrySession ^ session, System::String ^ eventName);
public static Microsoft.VisualStudio.Telemetry.TelemetryScope<Microsoft.VisualStudio.Telemetry.UserTaskEvent> StartUserTask (this Microsoft.VisualStudio.Telemetry.TelemetrySession session, string eventName);
static member StartUserTask : Microsoft.VisualStudio.Telemetry.TelemetrySession * string -> Microsoft.VisualStudio.Telemetry.TelemetryScope<Microsoft.VisualStudio.Telemetry.UserTaskEvent>
<Extension()>
Public Function StartUserTask (session As TelemetrySession, eventName As String) As TelemetryScope(Of UserTaskEvent)

Параметры

session
TelemetrySession

Сеанс телеметрииTelemetry Session

eventName
String

Имя события, приведенное в схеме модели данных.An event name following data model schema. Оно требует, чтобы имя события было уникальным, а не NULL или пустой строкой.It requires that event name is a unique, not null or empty string. Он состоит из трех частей и должен иметь вид [Product]/[featureName]/[имя_объекта].It consists of 3 parts and must follows pattern [product]/[featureName]/[entityName]. FeatureName может быть одноуровневой функцией или иерархией функций, разделенных символом "/".FeatureName could be a one-level feature or feature hierarchy delimited by "/". Примеры: VS/Platform/опенсолутион; VS/Platform/редактор/лампочка/фиксеррор;For examples, vs/platform/opensolution; vs/platform/editor/lightbulb/fixerror;

Возвращаемое значение

TelemetryScope<UserTaskEvent>

TelemetryScope<T> вхождение.TelemetryScope<T> instance.

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

StartUserTask(TelemetrySession, String, TelemetryScopeSettings)

Запуск отслеживания пользовательской задачи путем отправки UserTaskEvent с указанными свойствами в начале работы задачи пользователя, а затем возврата TelemetryScope<T> объекта.Start tracking user task by posting a UserTaskEvent with specified properties at the beginning of user task work, and then return a TelemetryScope<T> object. По завершении задачи пользователя вызовите метод End(TelemetryResult, String) для публикации другой UserTaskEvent конечной точки.When the user task finishes, call method End(TelemetryResult, String) to post another UserTaskEvent for end point. Поскольку одно и то же имя события используется как для событий начала, так и для события окончания, не следует использовать Start или End в имени события.Because the same event name is used by both start and end events, please don't use Start or End in event name.

public:
[System::Runtime::CompilerServices::Extension]
 static Microsoft::VisualStudio::Telemetry::TelemetryScope<Microsoft::VisualStudio::Telemetry::UserTaskEvent ^> ^ StartUserTask(Microsoft::VisualStudio::Telemetry::TelemetrySession ^ session, System::String ^ eventName, Microsoft::VisualStudio::Telemetry::TelemetryScopeSettings ^ settings);
public static Microsoft.VisualStudio.Telemetry.TelemetryScope<Microsoft.VisualStudio.Telemetry.UserTaskEvent> StartUserTask (this Microsoft.VisualStudio.Telemetry.TelemetrySession session, string eventName, Microsoft.VisualStudio.Telemetry.TelemetryScopeSettings settings);
static member StartUserTask : Microsoft.VisualStudio.Telemetry.TelemetrySession * string * Microsoft.VisualStudio.Telemetry.TelemetryScopeSettings -> Microsoft.VisualStudio.Telemetry.TelemetryScope<Microsoft.VisualStudio.Telemetry.UserTaskEvent>
<Extension()>
Public Function StartUserTask (session As TelemetrySession, eventName As String, settings As TelemetryScopeSettings) As TelemetryScope(Of UserTaskEvent)

Параметры

session
TelemetrySession

Сеанс телеметрииTelemetry Session

eventName
String

Имя события, приведенное в схеме модели данных.An event name following data model schema. Оно требует, чтобы имя события было уникальным, а не NULL или пустой строкой.It requires that event name is a unique, not null or empty string. Он состоит из трех частей и должен иметь вид [Product]/[featureName]/[имя_объекта].It consists of 3 parts and must follows pattern [product]/[featureName]/[entityName]. FeatureName может быть одноуровневой функцией или иерархией функций, разделенных символом "/".FeatureName could be a one-level feature or feature hierarchy delimited by "/". Примеры: VS/Platform/опенсолутион; VS/Platform/редактор/лампочка/фиксеррор;For examples, vs/platform/opensolution; vs/platform/editor/lightbulb/fixerror;

settings
TelemetryScopeSettings

TelemetryScopeSettingsОбъект для управления поведением телеметрископе.A TelemetryScopeSettings object to control the TelemetryScope behavior.

Возвращаемое значение

TelemetryScope<UserTaskEvent>

TelemetryScope<T> вхождение.TelemetryScope<T> instance.

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

StartUserTask(TelemetrySession, String, TelemetrySeverity)

Запустите отслеживание пользовательской задачи, отправляя в UserTaskEvent Начало работы задачу пользователя, а затем возвращая TelemetryScope<T> объект.Start tracking user task by posting a UserTaskEvent at the beginning of user task work, and then return a TelemetryScope<T> object. По завершении задачи пользователя вызовите метод End(TelemetryResult, String) для публикации другой UserTaskEvent конечной точки.When the user task finishes, call method End(TelemetryResult, String) to post another UserTaskEvent for end point. Поскольку одно и то же имя события используется как для событий начала, так и для события окончания, не следует использовать Start или End в имени события.Because the same event name is used by both start and end events, please don't use Start or End in event name.

public:
[System::Runtime::CompilerServices::Extension]
 static Microsoft::VisualStudio::Telemetry::TelemetryScope<Microsoft::VisualStudio::Telemetry::UserTaskEvent ^> ^ StartUserTask(Microsoft::VisualStudio::Telemetry::TelemetrySession ^ session, System::String ^ eventName, Microsoft::VisualStudio::Telemetry::TelemetrySeverity severity);
public static Microsoft.VisualStudio.Telemetry.TelemetryScope<Microsoft.VisualStudio.Telemetry.UserTaskEvent> StartUserTask (this Microsoft.VisualStudio.Telemetry.TelemetrySession session, string eventName, Microsoft.VisualStudio.Telemetry.TelemetrySeverity severity);
static member StartUserTask : Microsoft.VisualStudio.Telemetry.TelemetrySession * string * Microsoft.VisualStudio.Telemetry.TelemetrySeverity -> Microsoft.VisualStudio.Telemetry.TelemetryScope<Microsoft.VisualStudio.Telemetry.UserTaskEvent>
<Extension()>
Public Function StartUserTask (session As TelemetrySession, eventName As String, severity As TelemetrySeverity) As TelemetryScope(Of UserTaskEvent)

Параметры

session
TelemetrySession

Сеанс телеметрииTelemetry Session

eventName
String

Имя события, приведенное в схеме модели данных.An event name following data model schema. Оно требует, чтобы имя события было уникальным, а не NULL или пустой строкой.It requires that event name is a unique, not null or empty string. Он состоит из трех частей и должен иметь вид [Product]/[featureName]/[имя_объекта].It consists of 3 parts and must follows pattern [product]/[featureName]/[entityName]. FeatureName может быть одноуровневой функцией или иерархией функций, разделенных символом "/".FeatureName could be a one-level feature or feature hierarchy delimited by "/". Примеры: VS/Platform/опенсолутион; VS/Platform/редактор/лампочка/фиксеррор;For examples, vs/platform/opensolution; vs/platform/editor/lightbulb/fixerror;

severity
TelemetrySeverity

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

Возвращаемое значение

TelemetryScope<UserTaskEvent>

TelemetryScope<T> вхождение.TelemetryScope<T> instance.

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

StartUserTask(TelemetrySession, String, TelemetrySeverity, IDictionary<String,Object>)

Запуск отслеживания пользовательской задачи путем отправки UserTaskEvent с указанными свойствами в начале работы задачи пользователя, а затем возврата TelemetryScope<T> объекта.Start tracking user task by posting a UserTaskEvent with specified properties at the beginning of user task work, and then return a TelemetryScope<T> object. По завершении задачи пользователя вызовите метод End(TelemetryResult, String) для публикации другой UserTaskEvent конечной точки.When the user task finishes, call method End(TelemetryResult, String) to post another UserTaskEvent for end point. Поскольку одно и то же имя события используется как для событий начала, так и для события окончания, не следует использовать Start или End в имени события.Because the same event name is used by both start and end events, please don't use Start or End in event name.

public:
[System::Runtime::CompilerServices::Extension]
 static Microsoft::VisualStudio::Telemetry::TelemetryScope<Microsoft::VisualStudio::Telemetry::UserTaskEvent ^> ^ StartUserTask(Microsoft::VisualStudio::Telemetry::TelemetrySession ^ session, System::String ^ eventName, Microsoft::VisualStudio::Telemetry::TelemetrySeverity severity, System::Collections::Generic::IDictionary<System::String ^, System::Object ^> ^ startEventProperties);
public static Microsoft.VisualStudio.Telemetry.TelemetryScope<Microsoft.VisualStudio.Telemetry.UserTaskEvent> StartUserTask (this Microsoft.VisualStudio.Telemetry.TelemetrySession session, string eventName, Microsoft.VisualStudio.Telemetry.TelemetrySeverity severity, System.Collections.Generic.IDictionary<string,object> startEventProperties);
static member StartUserTask : Microsoft.VisualStudio.Telemetry.TelemetrySession * string * Microsoft.VisualStudio.Telemetry.TelemetrySeverity * System.Collections.Generic.IDictionary<string, obj> -> Microsoft.VisualStudio.Telemetry.TelemetryScope<Microsoft.VisualStudio.Telemetry.UserTaskEvent>
<Extension()>
Public Function StartUserTask (session As TelemetrySession, eventName As String, severity As TelemetrySeverity, startEventProperties As IDictionary(Of String, Object)) As TelemetryScope(Of UserTaskEvent)

Параметры

session
TelemetrySession

Сеанс телеметрииTelemetry Session

eventName
String

Имя события, приведенное в схеме модели данных.An event name following data model schema. Оно требует, чтобы имя события было уникальным, а не NULL или пустой строкой.It requires that event name is a unique, not null or empty string. Он состоит из трех частей и должен иметь вид [Product]/[featureName]/[имя_объекта].It consists of 3 parts and must follows pattern [product]/[featureName]/[entityName]. FeatureName может быть одноуровневой функцией или иерархией функций, разделенных символом "/".FeatureName could be a one-level feature or feature hierarchy delimited by "/". Примеры: VS/Platform/опенсолутион; VS/Platform/редактор/лампочка/фиксеррор;For examples, vs/platform/opensolution; vs/platform/editor/lightbulb/fixerror;

severity
TelemetrySeverity

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

startEventProperties
IDictionary<String,Object>

Свойства события для события Start этой области.Event properties for the start event of this scope. Они также копируются в завершающее событие.They are also copied to end event.

Возвращаемое значение

TelemetryScope<UserTaskEvent>

TelemetryScope<T> вхождение.TelemetryScope<T> instance.

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

StartUserTask(TelemetrySession, String, TelemetrySeverity, IDictionary<String,Object>, TelemetryEventCorrelation[])

Запуск отслеживания пользовательской задачи путем отправки UserTaskEvent с указанными свойствами в начале работы задачи пользователя, а затем возврата TelemetryScope<T> объекта.Start tracking user task by posting a UserTaskEvent with specified properties at the beginning of user task work, and then return a TelemetryScope<T> object. По завершении задачи пользователя вызовите метод End(TelemetryResult, String) для публикации другой UserTaskEvent конечной точки.When the user task finishes, call method End(TelemetryResult, String) to post another UserTaskEvent for end point. Поскольку одно и то же имя события используется как для событий начала, так и для события окончания, не следует использовать Start или End в имени события.Because the same event name is used by both start and end events, please don't use Start or End in event name.

public:
[System::Runtime::CompilerServices::Extension]
 static Microsoft::VisualStudio::Telemetry::TelemetryScope<Microsoft::VisualStudio::Telemetry::UserTaskEvent ^> ^ StartUserTask(Microsoft::VisualStudio::Telemetry::TelemetrySession ^ session, System::String ^ eventName, Microsoft::VisualStudio::Telemetry::TelemetrySeverity severity, System::Collections::Generic::IDictionary<System::String ^, System::Object ^> ^ startEventProperties, cli::array <Microsoft::VisualStudio::Telemetry::TelemetryEventCorrelation> ^ correlations);
public static Microsoft.VisualStudio.Telemetry.TelemetryScope<Microsoft.VisualStudio.Telemetry.UserTaskEvent> StartUserTask (this Microsoft.VisualStudio.Telemetry.TelemetrySession session, string eventName, Microsoft.VisualStudio.Telemetry.TelemetrySeverity severity, System.Collections.Generic.IDictionary<string,object> startEventProperties, Microsoft.VisualStudio.Telemetry.TelemetryEventCorrelation[] correlations);
static member StartUserTask : Microsoft.VisualStudio.Telemetry.TelemetrySession * string * Microsoft.VisualStudio.Telemetry.TelemetrySeverity * System.Collections.Generic.IDictionary<string, obj> * Microsoft.VisualStudio.Telemetry.TelemetryEventCorrelation[] -> Microsoft.VisualStudio.Telemetry.TelemetryScope<Microsoft.VisualStudio.Telemetry.UserTaskEvent>
<Extension()>
Public Function StartUserTask (session As TelemetrySession, eventName As String, severity As TelemetrySeverity, startEventProperties As IDictionary(Of String, Object), correlations As TelemetryEventCorrelation()) As TelemetryScope(Of UserTaskEvent)

Параметры

session
TelemetrySession

Сеанс телеметрииTelemetry Session

eventName
String

Имя события, приведенное в схеме модели данных.An event name following data model schema. Оно требует, чтобы имя события было уникальным, а не NULL или пустой строкой.It requires that event name is a unique, not null or empty string. Он состоит из трех частей и должен иметь вид [Product]/[featureName]/[имя_объекта].It consists of 3 parts and must follows pattern [product]/[featureName]/[entityName]. FeatureName может быть одноуровневой функцией или иерархией функций, разделенных символом "/".FeatureName could be a one-level feature or feature hierarchy delimited by "/". Примеры: VS/Platform/опенсолутион; VS/Platform/редактор/лампочка/фиксеррор;For examples, vs/platform/opensolution; vs/platform/editor/lightbulb/fixerror;

severity
TelemetrySeverity

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

startEventProperties
IDictionary<String,Object>

Свойства события для события Start этой области.Event properties for the start event of this scope. Они также копируются в завершающее событие.They are also copied to end event.

correlations
TelemetryEventCorrelation[]

События, с которыми может сопоставляться эта область.Events with which this scope can correlate.

Возвращаемое значение

TelemetryScope<UserTaskEvent>

TelemetryScope<T> вхождение.TelemetryScope<T> instance.

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