FileUpdateRequest Clase

Definición

Espacio de nombres:

Windows.Storage.Provider

Proporciona información sobre una actualización de archivos solicitada para que la aplicación pueda completar la solicitud.

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

Herencia

Object Platform::Object IInspectable FileUpdateRequest

Atributos

ContractVersionAttribute

Requisitos de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Ejemplos

El ejemplo de contratos del selector de archivos muestra cómo responder a un evento FileUpdateRequested , incluido cómo usar Request para obtener 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 objeto FileUpdateRequestedEventArgs .

Comentarios

Si la aplicación participa en el contrato del actualizador de archivos almacenados en caché, usa esta clase para responder cuando Windows desencadena eventos FileUpdateRequested para solicitar actualizaciones de archivos. Puede acceder a esta clase desde el controlador de eventos mediante FileUpdateRequestedEventArgs. Propiedad Request . Como parte de la respuesta a un evento FileUpdateRequested , debe establecer la propiedad Status de esta clase para indicar el estado de la actualización.

Obtenga más información sobre cómo responder a las solicitudes de actualización en FileUpdateRequested y FileUpdateRequestedEventArgs.

Si la aplicación no puede completar la actualización antes de volver desde su controlador de eventos FileUpdateRequested , puede usar la propiedad GetDeferral para finalizar la actualización de forma asincrónica.

Propiedades

ContentId	Obtiene el identificador único utilizado para asociar la versión local de un archivo con la versión remota correspondiente.
File	Obtiene un objeto StorageFile que representa la copia almacenada en caché local del archivo que se va a actualizar.
Status	Obtiene o establece el estado de la actualización. Esta propiedad se establece en respuesta a un evento FileUpdateRequested .
UserInputNeededMessage	Obtiene o establece un mensaje al usuario que indica que se necesita la entrada del usuario para completar FileUpdateRequest.

Métodos

GetDeferral()	Obtiene un objeto utilizado para completar una actualización de forma asincrónica.
UpdateLocalFile(IStorageFile)	Proporcione una nueva versión del archivo local para representar el archivo remoto.