FileUpdateRequest Classe

  • Referência

Definição

Namespace:
Windows.Storage.Provider
Editar

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.

Aplica-se a