Progress

Progress

Bu kılavuz, uzun süren belge yükleme ve kaydetme işlemlerinin ilerlemesini nasıl izleyebileceğinizi gösterir.

Uzun süren yükleme ve kaydetme işlemleri, IDocumentLoadingCallback (yükleme için) ve IDocumentSavingCallback (kaydetme için) adlı küçük bir geri çağırma çifti aracılığıyla artımlı ilerlemeyi raporlayabilir. Her iki arabirim de aynı yapıyı izler — Aspose.Words FOSS tarafından .NET sırasında çağrılan tek bir Notify(args) yöntemi.

Belge Yüklemesini İzleme

Bir belge yüklemeden önce IDocumentLoadingCallback uygulayın ve uygulamayı LoadOptions.ProgressCallback’e atayın. Yükleme sırasında, Notify(args) bir DocumentLoadingArgs örneği ile çağrılır; bu örneğin EstimatedProgress özelliği (bir double) yüklemenin ne kadar ilerlediğini rapor eder.

Belge Kaydetmesini İzleme

Bir belge kaydetmeden önce IDocumentSavingCallback uygulayın ve bunu SaveOptions.ProgressCallback’e atayın, ardından Document.Save(fileName, saveOptions)’yi (veya akış aşırı yüklemesini) çağırın. Kaydetme sırasında, Notify(args) bir DocumentSavingArgs örneği alır; bu örnek de EstimatedProgress’i bir double olarak sunar.

İpuçları ve En İyi Uygulamalar

• DocumentLoadingArgs ve DocumentSavingArgs, tek üyesi EstimatedProgress olan mühürlü sınıflardır — ilerleme raporlamasını, ayrıntılı bir işlem kaydı yerine UI geri bildirimi için hafif bir yüzde-stili sinyal olarak ele alın.
• ProgressCallback‘ı LoadOptions veya SaveOptions örneği üzerine, Document(fileName, loadOptions) veya Document.Save(fileName, saveOptions)‘e geçirmeden önce ayarlayın — sonradan atamak, hâlihazırda devam eden bir işleme etkisi olmaz.
• Yükleme ile kaydetme için ayrı bir geri çağırma uygulaması kullanın; IDocumentLoadingCallback ve IDocumentSavingCallback ayrı arayüzlerdir, ancak ikisi de tek bir Notify(args) yöntemini sunar.

Sık Karşılaşılan Sorunlar

FAQ

EstimatedProgress neyi temsil eder?

Bu, DocumentLoadingArgs üzerindeki bir double özelliğidir (yükleme sırasında) veya DocumentSavingArgs üzerindeki (kaydetme sırasında) ve işlemin tahmini tamamlanma ilerlemesini rapor eder.

İlerleme geri çağrısından bir yükleme veya kaydetme işlemini iptal edebilir miyim?

Notify(args) her iki arabirimde yalnızca argümanlar nesnesini (DocumentLoadingArgs veya DocumentSavingArgs) alır; hiçbiri bu API yüzeyinde bir iptal bayrağı sunmaz.

Veri yükleme ve veri kaydetme için ayrı geri çağırma sınıfları gerekiyor mu?

Bu iki farklı arabirim olduğundan, IDocumentLoadingCallback ve IDocumentSavingCallback için ayrı uygulamalara ihtiyacınız var; ancak tek bir sınıf her ikisini de uygulayabilir.

API Reference Özeti

Ayrıca Bakınız

• Aspose.Words for .NET — Enterprise Documentation