WidgetUpdateRequestOptions Klasse

Definition

Namespace:

Microsoft.Windows.Widgets.Providers

Stellt Daten für Aufrufe an Microsoft.Windows.Widgets.Providers.WidgetManager.UpdateWidgetbereit.

public ref class WidgetUpdateRequestOptions sealed

/// [Windows.Foundation.Metadata.Activatable(Microsoft.Windows.Widgets.Providers.IWidgetUpdateRequestOptionsFactory, 65536, "Microsoft.Windows.Widgets.WidgetContract")]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.Windows.Widgets.WidgetContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class WidgetUpdateRequestOptions final

[Windows.Foundation.Metadata.Activatable(typeof(Microsoft.Windows.Widgets.Providers.IWidgetUpdateRequestOptionsFactory), 65536, "Microsoft.Windows.Widgets.WidgetContract")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.Windows.Widgets.WidgetContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class WidgetUpdateRequestOptions

function WidgetUpdateRequestOptions(widgetId)

Public NotInheritable Class WidgetUpdateRequestOptions

Vererbung

Object Platform::Object IInspectable WidgetUpdateRequestOptions

Attribute

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Hinweise

Jede Variable, die nicht in der WidgetUpdateRequestOptions Klasse festgelegt wird, wird nicht aktualisiert. Wenn Sie beispielsweise nur daran interessiert sind, die Daten des Widgets zu aktualisieren, aber die vorhandene visuelle Vorlage und den benutzerdefinierten Zustand beibehalten möchten, werden die Daten des Widgets aktualisiert, aber die Vorlage und der benutzerdefinierte Zustand werden nicht geändert, indem sie nur die Microsoft.Windows.WidgetUpdateRequestOptions.Data-Eigenschaft festlegen.

UpdateWidget- kann auch verwendet werden, um jeden gespeicherten Wert zu löschen, indem eine leere Zeichenfolge für den zu löschenden Wert festgelegt wird. Wenn Sie beispielsweise den gespeicherten benutzerdefinierten Zustand des Widgets löschen möchten, können Sie die Microsoft.Windows.Widgets.Providers.WidgetUpdateRequestOptions.CustomState-Eigenschaft auf eine leere Zeichenfolge festlegen, wodurch der gespeicherte benutzerdefinierte Zustand gelöscht wird, sobald UpdateWidget aufgerufen wird.

Konstruktoren

WidgetUpdateRequestOptions(String)

Initialisiert eine neue Instanz der WidgetRequestOptions Klasse.

Eigenschaften

CustomState	Dient zum Abrufen oder Festlegen einer Zeichenfolge, die den benutzerdefinierten Zustand für das zugeordnete Widget darstellt.
Data	Ruft die Datenvorlage für adaptive Karten für das zugeordnete Widget ab oder legt sie fest.
Template	Ruft die visuelle Vorlage für adaptive Karten für das zugeordnete Widget ab oder legt sie fest.
UnsetValue	Ruft einen Sentinelwert ab, der angibt, dass die zugeordnete Eigenschaft nicht festgelegt ist.
WidgetId	Ruft die Widget-ID des zu aktualisierenden Widgets ab.