FileUpdateRequest Classe

Definição

Namespace:

Windows.Storage.Provider

Fornece informações sobre uma atualização de arquivo solicitada para que o aplicativo possa concluir a solicitação.

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

Herança

Object Platform::Object IInspectable FileUpdateRequest

Atributos

ContractVersionAttribute

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Exemplos

O exemplo de contratos do seletor de arquivos demonstra como responder a um evento FileUpdateRequested , incluindo como usar Request para obter o 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 contém um objeto FileUpdateRequestedEventArgs .

Comentários

Se seu aplicativo participar do contrato do Atualizador de Arquivos Armazenados em Cache, use essa classe para responder quando o Windows disparar eventos FileUpdateRequested para solicitar atualizações de arquivo. Você pode acessar essa classe do manipulador de eventos usando o FileUpdateRequestedEventArgs. Propriedade Request . Como parte da resposta a um evento FileUpdateRequested, você deve definir a propriedade Status dessa classe para indicar o status da atualização.

Saiba mais sobre como responder a solicitações de atualização em FileUpdateRequested e FileUpdateRequestedEventArgs.

Se o aplicativo não puder concluir a atualização antes de retornar de seu manipulador de eventos FileUpdateRequested , você poderá usar a propriedade GetDeferral para concluir a atualização de forma assíncrona.

Propriedades

ContentId	Obtém o identificador exclusivo usado para associar a versão local de um arquivo à versão remota correspondente.
File	Obtém um objeto StorageFile que representa a cópia armazenada em cache localmente do arquivo a ser atualizado.
Status	Obtém ou define o status da atualização. Essa propriedade é definida em resposta a um evento FileUpdateRequested .
UserInputNeededMessage	Obtém ou define uma mensagem para o usuário indicando que a entrada do usuário é necessária para concluir o FileUpdateRequest.

Métodos

GetDeferral()	Obtém um objeto usado para concluir uma atualização de forma assíncrona.
UpdateLocalFile(IStorageFile)	Forneça uma nova versão do arquivo local para representar o arquivo remoto.