CachedFileManager Clase

Definición

Espacio de nombres:

Windows.Storage

Permite a las aplicaciones administrar las actualizaciones en tiempo real de los archivos.

public ref class CachedFileManager abstract sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class CachedFileManager final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public static class CachedFileManager

Public Class CachedFileManager

Herencia

Object Platform::Object IInspectable CachedFileManager

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute

Requisitos de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Ejemplos

En el ejemplo del selector de archivos se muestra cómo usar cachedFileManager para aplazar las actualizaciones de un archivo hasta que la aplicación termine de modificar el archivo.

if (file != null)
{
    // Prevent updates to the remote version of the file until we finish making changes and call CompleteUpdatesAsync.
    CachedFileManager.DeferUpdates(file);

    // Write to file
    await FileIO.AppendTextAsync(file, "Swift as a shadow");
    // Let Windows know that we're finished changing the file so the server app can update the remote version of the file.

    // Complete updates. (May require Windows to ask for user input.)
    FileUpdateStatus status = await CachedFileManager.CompleteUpdatesAsync(file);
    switch (status)
    {
        case FileUpdateStatus.Complete:
            // Perform additional tasks like notifying user of status
            break;

        case FileUpdateStatus.CompleteAndRenamed:
            // Perform additional tasks like notifying user of status, or storing the renamed file for future use
            break;

        default:
            // Perform additional tasks like notifying user of status
            break;
    }
}

En el ejemplo, file es una variable local que contiene un storageFile que representa el archivo para el que aplazar las actualizaciones.

Comentarios

Esta clase es estática y no se puede crear una instancia de ella. Llame directamente a los métodos.

Normalmente, Windows inicia implícitamente las actualizaciones de los archivos proporcionados por otras aplicaciones cuando cambian esos archivos.  Sin embargo, puede controlar cuándo se inician las actualizaciones mediante una llamada a DeferUpdates. Si usa este método se aplaza hasta que llame a CompleteUpdatesAsync para iniciarlos.

Métodos

CompleteUpdatesAsync(IStorageFile)	Inicia actualizaciones para el archivo especificado. Este método se pone en contacto con la aplicación que proporcionó el archivo para realizar las actualizaciones.
DeferUpdates(IStorageFile)	Permite a las aplicaciones aplazar las actualizaciones en tiempo real para un archivo especificado.

Consulte también

• Ejemplo del selector de archivos (Windows 10)