FileUpdateRequest Classe

Riferimento

Definizione

Spazio dei nomi:: Windows.Storage.Provider

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Modifica

Fornisce informazioni su un aggiornamento di file richiesto in modo che l'app possa completare la richiesta.

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

Ereditarietà: Object Platform::Object IInspectable FileUpdateRequest

Attributi: ContractVersionAttribute

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Esempio

L'esempio di contratti di selezione file illustra come rispondere a un evento FileUpdateRequested, incluso come usare Request per ottenere 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 contiene un oggetto FileUpdateRequestedEventArgs .

Commenti

Se l'app partecipa al contratto Aggiornamento file memorizzato nella cache, usare questa classe per rispondere quando Windows attiva gli eventi FileUpdateRequested per richiedere gli aggiornamenti dei file. È possibile accedere a questa classe dal gestore eventi usando FileUpdateRequestedEventArgs. Proprietà Request . Come parte della risposta a un evento FileUpdateRequested , è necessario impostare la proprietà Status di questa classe per indicare lo stato dell'aggiornamento.

Altre informazioni sulla risposta alle richieste di aggiornamento in FileUpdateRequested e FileUpdateRequestedEventArgs.

Se l'app non riesce a completare l'aggiornamento prima di restituire dal relativo gestore eventi FileUpdateRequested , è possibile usare la proprietà GetDeferral per completare l'aggiornamento in modo asincrono.

Proprietà

ContentId	Ottiene l'identificatore univoco usato per associare la versione locale di un file alla versione remota corrispondente.
File	Ottiene un oggetto StorageFile che rappresenta la copia memorizzata nella cache locale del file da aggiornare.
Status	Ottiene o imposta lo stato dell'aggiornamento. Questa proprietà viene impostata in risposta a un evento FileUpdateRequested .
UserInputNeededMessage	Ottiene o imposta un messaggio all'utente che indica che l'input dell'utente è necessario per completare FileUpdateRequest.

Metodi

GetDeferral()	Ottiene un oggetto usato per completare un aggiornamento in modo asincrono.
UpdateLocalFile(IStorageFile)	Specificare una nuova versione del file locale per rappresentare il file remoto.

Si applica a

Condividi tramite