SecondaryTile.UpdateAsync Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Updates eine sekundäre Kachel, nachdem diese Kachel an den Startbildschirm angeheftet ist.
Bei Windows Phone 8.1 wird Ihre App angehalten, und der Benutzer wird zum Startbildschirm weitergeleitet, wenn eine sekundäre Kachel angeheftet ist. Beachten Sie daher, dass code, der nach RequestCreateAsync aufgerufen wird, nicht garantiert wird, dass er ausgeführt wird, bevor die App angehalten wird. Um dieses potenzielle Problem zu vermeiden, sollten Sie das OnSuspended-Ereignis Ihrer App verwenden, um Code auszuführen, z. B. das Aktualisieren der angehefteten Kachel, der ausgeführt werden sollte, bevor die App angehalten wird. Um ein Beispiel für dieses Muster anzuzeigen, laden Sie das Beispiel Kachelupdate beim Anhalten herunter, und führen Sie es aus.
public:
virtual IAsyncOperation<bool> ^ UpdateAsync() = UpdateAsync;/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<bool> UpdateAsync();[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<bool> UpdateAsync();function updateAsync()Public Function UpdateAsync () As IAsyncOperation(Of Boolean)Gibt zurück
Ein Objekt, das zum Starten des asynchronen Erstellungsvorgangs und zum Abrufen von Informationen dazu verwendet wird.
- Attribute
Hinweise
Diese Methode aktualisiert die folgenden Eigenschaften der sekundären Kachel:
- DisplayName
- SecondaryTile.Arguments
- SecondaryTile.LockScreenBadgeLogo
- SecondaryTile.LockScreenDisplayBadgeAndTileText
- SecondaryTile.RoamingEnabled
- SecondaryTileVisualElements.BackgroundColor
- SecondaryTileVisualElements.ForegroundText
- SecondaryTileVisualElements.ShowNameOnSquare150x150Logo
- SecondaryTileVisualElements.ShowNameOnSquare310x310Logo
- SecondaryTileVisualElements.ShowNameOnWide310x150Logo
- SecondaryTileVisualElements.Square30x30Logo
- SecondaryTileVisualElements.Square70x70Logo
- SecondaryTileVisualElements.Square150x150Logo
- SecondaryTileVisualElements.Square310x310Logo
- SecondaryTileVisualElements.Wide310x150Logo
- TileId
Unter Windows 8 und Windows 8.1 aktualisiert diese Methode diese Eigenschaften nicht:
Wenn die TileId-Eigenschaft nicht festgelegt ist, bevor Sie diese Methode aufrufen, löst der Aufruf eine Ausnahme aus.