IReducedFunctionalityReportingService.ReportReducedFunctionalityAsync 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
重载
| ReportReducedFunctionalityAsync(String, String, ServiceMoniker, CancellationToken) |
向用户显示无模式 UI，说明功能禁用或使用功能缩减的操作。 |
| ReportReducedFunctionalityAsync(String, String, ServiceMoniker, Guid, UInt32, CancellationToken) |
向用户显示无模式 UI，说明功能禁用或使用功能缩减的操作。 |
ReportReducedFunctionalityAsync(String, String, ServiceMoniker, CancellationToken)
向用户显示无模式 UI，说明功能禁用或使用功能缩减的操作。
public System.Threading.Tasks.Task ReportReducedFunctionalityAsync (string reducedFeatureId, string reducedFeature, Microsoft.ServiceHub.Framework.ServiceMoniker serviceMoniker, System.Threading.CancellationToken cancellationToken = default);abstract member ReportReducedFunctionalityAsync : string * string * Microsoft.ServiceHub.Framework.ServiceMoniker * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Function ReportReducedFunctionalityAsync (reducedFeatureId As String, reducedFeature As String, serviceMoniker As ServiceMoniker, Optional cancellationToken As CancellationToken = Nothing) As Task参数
- reducedFeatureId
- String
一个非本地化字符串，用于标识已禁用或操作的功能降低的功能。 此字符串应相对静态，因为当同一功能多次报告故障时，此字符串用作密钥来识别和阻止冗余 UI。 它还可以在遥测事件中用于识别缺少的服务的影响。
- reducedFeature
- String
功能的本地化显示名称，该功能已禁用或操作，功能降低。 此字符串插入到 单数 语法上下文中较大字符串的占位符中 (例如 "{您的功能} 已断开" ) 。 尽管此值可能会对功能名称使用标题大小写，但它不应包含标点。
- serviceMoniker
- ServiceMoniker
不可用的中转服务的名字对象。
- cancellationToken
- CancellationToken
取消标记。
返回
表示向用户呈现 UI 的任务的任务。
适用于
ReportReducedFunctionalityAsync(String, String, ServiceMoniker, Guid, UInt32, CancellationToken)
向用户显示无模式 UI，说明功能禁用或使用功能缩减的操作。
public System.Threading.Tasks.Task ReportReducedFunctionalityAsync (string reducedFeatureId, string reducedFeature, Microsoft.ServiceHub.Framework.ServiceMoniker serviceMoniker, Guid toolWindowGuid, uint toolWindowInstanceId = 0, System.Threading.CancellationToken cancellationToken = default);abstract member ReportReducedFunctionalityAsync : string * string * Microsoft.ServiceHub.Framework.ServiceMoniker * Guid * uint32 * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Function ReportReducedFunctionalityAsync (reducedFeatureId As String, reducedFeature As String, serviceMoniker As ServiceMoniker, toolWindowGuid As Guid, Optional toolWindowInstanceId As UInteger = 0, Optional cancellationToken As CancellationToken = Nothing) As Task参数
- reducedFeatureId
- String
一个非本地化字符串，用于标识已禁用或操作的功能降低的功能。 此字符串应相对静态，因为当同一功能多次报告故障时，此字符串用作密钥来识别和阻止冗余 UI。 它还可以在遥测事件中用于识别缺少的服务的影响。
- reducedFeature
- String
功能的本地化显示名称，该功能已禁用或操作，功能降低。 此字符串插入到 单数 语法上下文中较大字符串的占位符中 (例如 "{您的功能} 已断开" ) 。 尽管此值可能会对功能名称使用标题大小写，但它不应包含标点。
- serviceMoniker
- ServiceMoniker
不可用的中转服务的名字对象。
- toolWindowGuid
- Guid
承载功能 UI 的工具窗口的 GUID （如果有）。 可以将信息栏添加到此工具窗口。
- toolWindowInstanceId
- UInt32
由 toolWindowGuid 用户与之交互或以其他方式显示的多实例工具窗口的 ID （如果适用）。
- cancellationToken
- CancellationToken
取消标记。
返回
表示向用户呈现 UI 的任务的任务。
注解
此方法提供 UI，通知用户有关功能的功能被缩减或禁用的原因。 此 UI 是无模式的，不会盗取用户的输入焦点。 此方法还可以记录详细信息和/或发布遥测事件。