WidgetResourceRequestedArgs クラス

定義

名前空間:
Microsoft.Windows.Widgets.Providers
編集

ウィジェットのコンテンツが、プロバイダーのパッケージ マニフェスト ファイルの Definition 要素の WebRequestFilter 属性内のウィジェットの Web 要求フィルター文字列と一致するリソースを要求したときに発生する IWidgetResourceProvider.OnResourceRequested イベントのデータを提供します。 詳細については、「 ウィジェット プロバイダー パッケージ マニフェスト XML 形式」を参照してください。

public ref class WidgetResourceRequestedArgs sealed
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.Windows.Widgets.WidgetContract, 393216)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class WidgetResourceRequestedArgs final
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.Windows.Widgets.WidgetContract), 393216)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class WidgetResourceRequestedArgs
Public NotInheritable Class WidgetResourceRequestedArgs
継承
Object Platform::Object IInspectable WidgetResourceRequestedArgs
属性
ContractVersionAttribute MarshalingBehaviorAttribute

注釈

ウィジェット プロバイダーは WidgetResourceRequestedArgs.Request プロパティを使用してリソース要求にアクセスし、 WidgetResourceRequestedArgs.Response プロパティを、リソースへのストリームを含む WidgetResourceResponse に設定してから、返すことができます。 評価またはリソースがすぐに使用できない場合、プロバイダーは WidgetResourceRequestedArgs.GetDeferral を呼び出して遅延を要求し、バックグラウンド タスクを開始し、リソースが使用可能になったら遅延を完了する必要があります。

Provider が WidgetResourceRequestedArgs で WidgetResourceResponse を 設定せずに OnResourceRequested 呼び出しを返した場合、Web フェッチが行われます。 WidgetResourceResponse を指定せずに返す場合、プロバイダーは Headers コレクションを変更できます。このコレクションは Web フェッチで使用されます。

プロパティ

名前 説明
Request

ウィジェット リソース要求を表す WidgetResourceRequest を設定します。
Response

ウィジェット リソース要求への応答を表す WidgetResourceResponse を取得または設定します。
WidgetContext

Microsoft.Windowsに関連付けられている WidgetContext オブジェクトを取得します。Widgets.Providers.IWidgetProvider.OnWidgetContextChanged コールバック。

メソッド

名前 説明
GetDeferral()

IWidgetResourceProvider.OnResourceRequested ハンドラーが戻った後も、リソース応答タスクが引き続き作業を実行する可能性があることをシステムに通知します。

適用対象