FileUpdateRequest Kelas

Referensi

Definisi

Ruang nama:: Windows.Storage.Provider

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Edit

Menyediakan informasi tentang pembaruan file yang diminta sehingga aplikasi dapat menyelesaikan permintaan.

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

Warisan: Object Platform::Object IInspectable FileUpdateRequest

Atribut: ContractVersionAttribute

Persyaratan Windows

Rangkaian perangkat	Windows 10 (diperkenalkan dalam 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)

Contoh

Sampel Kontrak pemilih file menunjukkan cara merespons peristiwa FileUpdateRequested, termasuk cara menggunakan Permintaan untuk mendapatkan 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 berisi objek FileUpdateRequestedEventArgs .

Keterangan

Jika aplikasi Anda berpartisipasi dalam kontrak Cache File Updater, gunakan kelas ini untuk merespons saat Windows mengaktifkan peristiwa FileUpdateRequested untuk meminta pembaruan file. Anda dapat mengakses kelas ini dari penanganan aktivitas Anda menggunakan FileUpdateRequestedEventArgs. Properti permintaan . Sebagai bagian dari respons Anda terhadap peristiwa FileUpdateRequested , Anda harus mengatur properti Status kelas ini untuk menunjukkan status pembaruan.

Pelajari selengkapnya tentang merespons permintaan pembaruan di FileUpdateRequested dan FileUpdateRequestedEventArgs.

Jika aplikasi Anda tidak dapat menyelesaikan pembaruan sebelum kembali dari penanganan aktivitas FileUpdateRequested , Anda dapat menggunakan properti GetDeferral untuk menyelesaikan pembaruan secara asinkron.

Properti

ContentId	Mendapatkan pengidentifikasi unik yang digunakan untuk mengaitkan versi lokal file dengan versi jarak jauh yang sesuai.
File	Mendapatkan objek StorageFile yang mewakili salinan file yang di-cache secara lokal untuk diperbarui.
Status	Mendapatkan atau mengatur status pembaruan. Properti ini diatur sebagai respons terhadap peristiwa FileUpdateRequested .
UserInputNeededMessage	Mendapatkan atau mengatur pesan ke pengguna yang menunjukkan bahwa input pengguna diperlukan untuk menyelesaikan FileUpdateRequest.

Metode

GetDeferral()	Mendapatkan objek yang digunakan untuk menyelesaikan pembaruan secara asinkron.
UpdateLocalFile(IStorageFile)	Berikan versi baru file lokal untuk mewakili file jarak jauh.

Berlaku untuk

Bagikan melalui