Anuluj renderowanie za pomocą tokena anulowania
Wstęp
Groupdocs.Viewer dla .NET to potężne narzędzie zaprojektowane w celu uproszczenia przeglądania i przetwarzania dokumentów w aplikacjach .NET. Niezależnie od tego, czy masz do czynienia z plikami PDF, dokumentami Microsoft Office czy innymi popularnymi formatami, ta biblioteka oferuje solidną funkcjonalność, która pozwala bezproblemowo integrować możliwości przeglądania dokumentów z projektami .NET.
Warunki wstępne
Przed przystąpieniem do integracji Groupdocs.Viewer dla .NET upewnij się, że spełnione są następujące wymagania wstępne:
Instalacja: Pobierz i zainstaluj bibliotekę Groupdocs.Viewer for .NET z dostarczonej bibliotekilink do pobrania.
Licencja: Uzyskaj licencję odDokumenty grupowe aby uwolnić pełny potencjał biblioteki. Alternatywnie możesz rozpocząć od bezpłatnego okresu próbnego, korzystając zlicencja tymczasowa.
Środowisko programistyczne: Upewnij się, że masz skonfigurowane kompatybilne środowisko programistyczne, w tym Visual Studio lub dowolne inne wybrane środowisko .NET IDE.
Importuj przestrzenie nazw
Aby efektywnie wykorzystać Groupdocs.Viewer dla .NET, musisz zaimportować niezbędne przestrzenie nazw do swojego projektu. Wykonaj następujące kroki:
using System;
using System.IO;
using GroupDocs.Viewer.Options;
using System.Threading.Tasks;
using System.Threading;
Podzielmy teraz podany przykład na wiele kroków, aby lepiej zrozumieć i wdrożyć:
Krok 1: Zdefiniuj katalog wyjściowy
string outputDirectory = "Your Document Directory";
Ten krok ustawia katalog, w którym będą przechowywane renderowane strony dokumentu.
Krok 2: Zdefiniuj format ścieżki pliku strony
string pageFilePathFormat = Path.Combine(outputDirectory, "page_{0}.html");
Tutaj definiujemy format ścieżek plików poszczególnych stron dokumentu.
Krok 3: Zainicjuj źródło tokenu anulowania
CancellationTokenSource cancellationTokenSource = new CancellationTokenSource();
CancellationTokenSource służy do generowania instancji CancellationToken, których można użyć do anulowania operacji asynchronicznych.
Krok 4: Uzyskaj token anulowania
CancellationToken cancellationToken = cancellationTokenSource.Token;
Ten krok pobiera token z CancellationTokenSource, który będzie używany do anulowania operacji renderowania.
Krok 5: Renderuj strony dokumentu
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);
Tutaj inicjujemy renderowanie stron dokumentu asynchronicznie za pomocą Task.Run(). Instancja Viewer jest tworzona z określonym plikiem dokumentu (SAMPLE_DOCX) i konfigurowane są opcje renderowania. Następnie rozpoczyna się proces renderowania przy użyciu metody View klasy Viewer.
Krok 6: Ustaw limit czasu renderowania
cancellationTokenSource.CancelAfter(10);
Ten krok ustawia limit czasu operacji renderowania na 10 milisekund. Jeśli operacja przekroczy ten limit czasu, zostanie automatycznie anulowana.
Krok 7: Wyświetl komunikat o powodzeniu
Console.WriteLine($"\nSource document rendered successfully.\nCheck output in {outputDirectory}.");
Na koniec zostanie wyświetlony komunikat o powodzeniu, wskazujący, że dokument został pomyślnie wyrenderowany.
Wniosek
W tym samouczku omówiliśmy podstawy integracji Groupdocs.Viewer dla .NET z Twoimi projektami. Wykonując czynności opisane powyżej, można bezproblemowo włączyć funkcje przeglądania dokumentów do aplikacji .NET, zwiększając komfort użytkownika i produktywność.
Często zadawane pytania
Czy Groupdocs.Viewer dla .NET jest kompatybilny ze wszystkimi formatami dokumentów?
Groupdocs.Viewer dla .NET obsługuje szeroką gamę formatów dokumentów, w tym PDF, dokumenty Microsoft Office, obrazy i inne.
Czy mogę dostosować wygląd renderowanych stron dokumentu?
Tak, możesz dostosować różne aspekty procesu renderowania, w tym rozmiar strony, jakość, znak wodny i inne.
Czy Groupdocs.Viewer dla .NET wymaga połączenia z Internetem?
Nie, Groupdocs.Viewer dla .NET działa lokalnie w środowisku .NET i nie wymaga połączenia z Internetem do przeglądania dokumentów.
Czy dostępna jest pomoc techniczna dla Groupdocs.Viewer dla .NET?
Tak, pomoc techniczna jest dostępna za pośrednictwemForum Groupdocs, gdzie możesz zadawać pytania, zgłaszać problemy i wchodzić w interakcje ze społecznością.
Czy przed zakupem mogę wypróbować Groupdocs.Viewer dla .NET?
Tak, możesz rozpocząć od bezpłatnego okresu próbnego, korzystając z dostarczonego oprogramowaniawersja próbna.