Ακύρωση απόδοσης με διακριτικό ακύρωσης

Εισαγωγή

Το Groupdocs.Viewer για .NET είναι ένα ισχυρό εργαλείο που έχει σχεδιαστεί για να απλοποιεί την προβολή και την επεξεργασία εγγράφων σε εφαρμογές .NET. Είτε ασχολείστε με PDF, έγγραφα του Microsoft Office ή άλλες κοινές μορφές, αυτή η βιβλιοθήκη προσφέρει ισχυρή λειτουργικότητα για την απρόσκοπτη ενσωμάτωση δυνατοτήτων προβολής εγγράφων στα έργα .NET σας.

Προαπαιτούμενα

Πριν ξεκινήσετε την ενσωμάτωση του Groupdocs.Viewer για .NET, βεβαιωθείτε ότι έχετε τις ακόλουθες προϋποθέσεις:

1. Εγκατάσταση: Κατεβάστε και εγκαταστήστε τη βιβλιοθήκη Groupdocs.Viewer για .NET από την παρεχόμενη σύνδεσμος λήψης.

2. Άδεια: Αποκτήστε άδεια από Groupdocs για να αξιοποιήσετε πλήρως τις δυνατότητες της βιβλιοθήκης. Εναλλακτικά, μπορείτε να ξεκινήσετε με μια δωρεάν δοκιμαστική περίοδο χρησιμοποιώντας το προσωρινή άδεια.

3. Περιβάλλον Ανάπτυξης: Βεβαιωθείτε ότι έχετε ρυθμίσει ένα συμβατό περιβάλλον ανάπτυξης, συμπεριλαμβανομένου του Visual Studio ή οποιουδήποτε άλλου .NET IDE της επιλογής σας.

Εισαγωγή χώρων ονομάτων

Για να χρησιμοποιήσετε αποτελεσματικά το Groupdocs.Viewer για .NET, πρέπει να εισαγάγετε τους απαραίτητους χώρους ονομάτων στο έργο σας. Ακολουθήστε τα παρακάτω βήματα:

using System;
using System.IO;
using GroupDocs.Viewer.Options;
using System.Threading.Tasks;
using System.Threading;

Τώρα, ας αναλύσουμε το παράδειγμα που παρέχεται σε πολλά βήματα για καλύτερη κατανόηση και εφαρμογή:

Βήμα 1: Ορισμός καταλόγου εξόδου

string outputDirectory = "Your Document Directory";

Αυτό το βήμα ορίζει τον κατάλογο όπου θα αποθηκευτούν οι σελίδες του εγγράφου που έχουν αποδοθεί.

Βήμα 2: Ορισμός μορφής διαδρομής αρχείου σελίδας

string pageFilePathFormat = Path.Combine(outputDirectory, "page_{0}.html");

Εδώ, ορίζουμε τη μορφή για τις διαδρομές αρχείων των μεμονωμένων σελίδων εγγράφων.

Βήμα 3: Αρχικοποίηση του CancellationTokenSource

CancellationTokenSource cancellationTokenSource = new CancellationTokenSource();

Το CancellationTokenSource χρησιμοποιείται για τη δημιουργία στιγμιότυπων CancellationToken που μπορούν να χρησιμοποιηθούν για την ακύρωση ασύγχρονων λειτουργιών.

Βήμα 4: Λήψη διακριτικού ακύρωσης

CancellationToken cancellationToken = cancellationTokenSource.Token;

Αυτό το βήμα ανακτά το διακριτικό από το CancellationTokenSource, το οποίο θα χρησιμοποιηθεί για την ακύρωση της λειτουργίας απόδοσης.

Βήμα 5: Απόδοση σελίδων εγγράφων

Task.Run(() =>
{
    using (Viewer viewer = new Viewer(TestFiles.SAMPLE_DOCX, new ViewerSettings(new GroupDocs.Viewer.Logging.ConsoleLogger())))
    {
        HtmlViewOptions options = HtmlViewOptions.ForEmbeddedResources(pageFilePathFormat);
        options.RenderComments = true;
        viewer.View(options, cancellationToken);
    }
}, cancellationToken);

Εδώ, ξεκινάμε την απόδοση των σελίδων εγγράφων ασύγχρονα χρησιμοποιώντας την Task.Run(). Η παρουσία του Viewer δημιουργείται με το καθορισμένο αρχείο εγγράφου (SAMPLE_DOCX) και ρυθμίζονται οι επιλογές απόδοσης. Στη συνέχεια, η διαδικασία απόδοσης ξεκινά χρησιμοποιώντας τη μέθοδο View της κλάσης Viewer.

Βήμα 6: Ορισμός χρονικού ορίου απόδοσης

cancellationTokenSource.CancelAfter(10);

Αυτό το βήμα ορίζει ένα χρονικό όριο 10 χιλιοστών του δευτερολέπτου για τη λειτουργία απόδοσης. Εάν η λειτουργία υπερβεί αυτό το χρονικό όριο, θα ακυρωθεί αυτόματα.

Βήμα 7: Εμφάνιση μηνύματος επιτυχίας

Console.WriteLine($"\nSource document rendered successfully.\nCheck output in {outputDirectory}.");

Τέλος, εμφανίζεται ένα μήνυμα επιτυχίας που υποδεικνύει ότι το έγγραφο έχει αποδοθεί με επιτυχία.

Σύναψη

Σε αυτό το σεμινάριο, καλύψαμε τα βασικά στοιχεία της ενσωμάτωσης του Groupdocs.Viewer για .NET στα έργα σας. Ακολουθώντας τα βήματα που περιγράφονται παραπάνω, μπορείτε να ενσωματώσετε απρόσκοπτα τις δυνατότητες προβολής εγγράφων στις εφαρμογές .NET, βελτιώνοντας την εμπειρία χρήστη και την παραγωγικότητα.

Συχνές ερωτήσεις

Είναι το Groupdocs.Viewer για .NET συμβατό με όλες τις μορφές εγγράφων;

Το Groupdocs.Viewer για .NET υποστηρίζει ένα ευρύ φάσμα μορφών εγγράφων, όπως PDF, έγγραφα του Microsoft Office, εικόνες και πολλά άλλα.

Μπορώ να προσαρμόσω την εμφάνιση των σελίδων του εγγράφου που αποδίδονται;

Ναι, μπορείτε να προσαρμόσετε διάφορες πτυχές της διαδικασίας απόδοσης, όπως το μέγεθος σελίδας, την ποιότητα, το υδατογράφημα και άλλα.

Απαιτείται σύνδεση στο διαδίκτυο για το Groupdocs.Viewer για .NET;

Όχι, το Groupdocs.Viewer για .NET λειτουργεί τοπικά στο περιβάλλον .NET σας και δεν απαιτεί σύνδεση στο διαδίκτυο για την προβολή εγγράφων.

Είναι διαθέσιμη τεχνική υποστήριξη για το Groupdocs.Viewer για .NET;

Ναι, η τεχνική υποστήριξη είναι διαθέσιμη μέσω του Φόρουμ Groupdocs, όπου μπορείτε να κάνετε ερωτήσεις, να αναφέρετε προβλήματα και να αλληλεπιδράσετε με την κοινότητα.

Μπορώ να δοκιμάσω το Groupdocs.Viewer για .NET πριν από την αγορά;

Ναι, μπορείτε να ξεκινήσετε με μια δωρεάν δοκιμή χρησιμοποιώντας το παρεχόμενο δοκιμαστική έκδοση.