FileUpdateRequest Kelas
Definisi
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.
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
- Atribut
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. |