SecondaryTile.UpdateAsync 方法

定義

命名空間:

Windows.UI.StartScreen

更新該磚釘選到 [開始] 畫面之後的次要磚。

在 Windows Phone 8.1 上，您的應用程式會暫停，並在釘選次要磚時，將使用者移至 \[開始\] 畫面。 因此請注意，在 App 暫停之前，不保證在 RequestCreateAsync 之後呼叫的任何程式碼都會執行。 若要避免此潛在問題，您應該使用應用程式的 OnSuspended 事件來執行任何程式碼，例如更新釘選的磚，應該在應用程式暫停之前執行。 若要查看此模式的範例，請下載並執行 暫止範例上的磚更新。

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)

傳回

IAsyncOperation<Boolean>

IAsyncOperation<bool>

用來啟動非同步建立作業的物件，以及擷取其相關資訊的物件。

屬性

RemoteAsyncAttribute

備註

此方法會更新次要磚的下列屬性：

• 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

在 Windows 8 和 Windows 8.1 上，此方法不會更新這些屬性：

• DisplayName
• SecondaryTileVisualElements.Square30x30Logo
• TileId

如果在呼叫此方法之前未設定 TileId 屬性，呼叫將會引發例外狀況。