FileUpdateRequest 類別

定義

命名空間:

Windows.Storage.Provider

提供要求檔案更新的相關資訊，讓應用程式可以完成要求。

public ref class FileUpdateRequest sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class FileUpdateRequest final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class FileUpdateRequest

Public NotInheritable Class FileUpdateRequest

繼承

Object Platform::Object IInspectable FileUpdateRequest

屬性

ContractVersionAttribute

Windows 需求

裝置系列	Windows 10 (已於 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox 引進)
API contract	Windows.Foundation.UniversalApiContract (已於 v1.0 引進)

範例

檔案選擇器合約範例示範如何回應FileUpdateRequested事件，包括如何使用Request來取得 FileUpdateRequest。

// Event handler
void CachedFileUpdaterUI_FileUpdateRequested(CachedFileUpdaterUI sender, FileUpdateRequestedEventArgs args)
{
    fileUpdateRequest = args.Request;
    fileUpdateRequestDeferral = fileUpdateRequest.GetDeferral();
    switch (cachedFileUpdaterUI.UIStatus)
    {
        case UIStatus.Hidden:
            fileUpdateRequest.Status = FileUpdateStatus.UserInputNeeded;
            fileUpdateRequestDeferral.Complete();
            break;
        case UIStatus.Visible:
            break;
        case UIStatus.Unavailable:
            fileUpdateRequest.Status = FileUpdateStatus.Failed;
            fileUpdateRequestDeferral.Complete();
            break;
    }
}

// Register for the event
cachedFileUpdaterUI.FileUpdateRequested += CachedFileUpdaterUI_FileUpdateRequested;

args 包含 FileUpdateRequestedEventArgs 物件。

備註

如果您的應用程式參與快取檔案更新程式合約，請使用這個類別在 Windows 引發 FileUpdateRequested 事件以要求檔案更新時回應。 您可以使用 FileUpdateRequestedEventArgs從事件處理常式存取此類別。Request 屬性。 在對 FileUpdateRequested 事件的回應中，您必須設定此類別的 Status 屬性，以指出更新的狀態。

深入瞭解如何回應 FileUpdateRequested 和 FileUpdateRequestedEventArgs中的更新要求。

如果您的 app 在從 FileUpdateRequested 事件處理常式傳回之前無法完成更新，您可以使用 GetDeferral 屬性以非同步方式完成更新。

屬性

ContentId	取得唯一識別碼，用來將檔案的本機版本與對應的遠端版本產生關聯。
File	取得 StorageFile 物件，表示要更新之檔案的本機快取複本。
Status	取得或設定更新的狀態。 此屬性會設定為回應 FileUpdateRequested 事件。
UserInputNeededMessage	取得或設定訊息給使用者，指出需要使用者輸入才能完成 FileUpdateRequest。

方法

GetDeferral()	取得物件，用來以非同步方式完成更新。
UpdateLocalFile(IStorageFile)	提供新版的本機檔案來表示遠端檔案。