Integracja z aplikacją internetową ASP.NET Core umożliwia płynną edycję dokumentów bezpośrednio w portalu internetowym. GroupDocs.Editor Cloud SDK for .NET zapewnia potężne API, które pozwala ładować, edytować i zapisywać pliki DOCX na serwerze. Ten przewodnik przeprowadzi Cię przez niezbędną konfigurację, pokaże kod krok po kroku i dostarczy kompletny przykład, który możesz uruchomić w kilka minut. Po zakończeniu będziesz w stanie dodać edycję dokumentów do aplikacji ASP.NET Core z pełnym przekonaniem.

Wymagania wstępne i konfiguracja

Zanim rozpoczniesz, upewnij się, że masz następujące:

  • Zainstalowany .NET 6.0 SDK lub nowszy
  • IDE, takie jak Visual Studio 2022 lub VS Code
  • Konto GroupDocs Cloud, aby uzyskać Client Id i Client Secret
  • Dostęp do maszyny deweloperskiej z systemem Windows, Linux lub macOS

Integracja z aplikacją internetową ASP.NET Core wymaga również niezawodnego połączenia sieciowego z punktami końcowymi GroupDocs Cloud, ponieważ całe przetwarzanie dokumentów odbywa się zdalnie. Zaplanuj odpowiednio środowisko wdrożeniowe.

Zainstaluj SDK za pomocą NuGet:

dotnet add package GroupDocs.editor-Cloud

Pobierz najnowszy pakiet ze strony oficjalnych wydań: GroupDocs.Editor Cloud SDK for .NET Pobierz.

Utwórz obiekt konfiguracji z użyciem swoich danych uwierzytelniających (fragment pełnego przykładu):

var configuration = new Configuration
{
    ClientId = "client_id",
    ClientSecret = "client_secret"
};

Po zainstalowaniu pakietu i przygotowaniu poświadczeń możesz przejść do implementacji. Kolejne sekcje szczegółowo wyjaśniają każdy fragment kodu, abyś zrozumiał, jak biblioteka wpasowuje się w ogólną architekturę aplikacji internetowej ASP.NET Core.

Przewodnik krok po kroku integracji z aplikacją internetową ASP.NET Core

Ta sekcja rozkłada proces integracji z aplikacją internetową ASP.NET Core na odrębne, łatwe do zarządzania kroki. Każdy krok zawiera krótki fragment kodu pobrany bezpośrednio z implementacji referencyjnej.

Krok 1: Skonfiguruj poświadczenia API

Najpierw zainicjuj obiekt Configuration ze swoimi danymi klienta i utwórz klienta EditorApi.

var configuration = new Configuration
{
    ClientId = "client_id",
    ClientSecret = "client_secret"
};

var editorApi = new EditorApi(configuration);

Klasa EditorApi jest udokumentowana w referencji API. Inicjalizacja klienta raz na żądanie jest wystarczająca w większości scenariuszy; możesz również zarejestrować go jako singleton w kontenerze wstrzykiwania zależności ASP.NET Core, aby uzyskać lepszą wydajność.

Krok 2: Zdefiniuj opcje ładowania

Określ plik źródłowy i żądaną lokalizację wyjścia przy użyciu LoadOptions. Ten obiekt informuje usługę, który dokument otworzyć i gdzie przechowywać renderowany HTML.

var loadOptions = new LoadOptions
{
    FileInfo = new FileInfo { FilePath = "input.docx" },
    RenderOptions = new RenderOptions { OutputPath = "output.html" }
};

LoadOptions, FileInfo i RenderOptions pozwalają kontrolować sposób renderowania dokumentu do edycji. Na przykład możesz ustawić RenderOptions, aby uwzględniały obrazy, zachowywały oryginalne style lub ograniczały liczbę renderowanych stron.

Krok 3: Wywołaj LoadDocument

Wywołaj API, aby załadować i przekonwertować dokument. Wywołanie jest synchroniczne w tym przykładzie, ale możesz również użyć wersji asynchronicznej, jeśli akcja kontrolera jest asynchroniczna.

var loadResult = editorApi.LoadDocument(loadOptions);

Metoda LoadDocument zwraca obiekt wyniku zawierający adresy URL do renderowanego HTML oraz inne metadane. Możesz przechowywać loadResult do późniejszego pobrania lub przekazać HTML bezpośrednio do front‑end.

Krok 4: Przetwarzanie wyniku ładowania

Po załadowaniu możesz udostępnić HTML front‑endowi lub przechować go do późniejszego użycia. Ten krok kończy przepływ pracy integracji edytora dokumentów w aplikacji ASP.NET Core i przygotowuje dokument do interakcji użytkownika.

W rzeczywistym scenariuszu zazwyczaj zwracałbyś treść HTML z akcji kontrolera:

return Content(loadResult.HtmlContent, "text/html");

Możesz również chcieć wdrożyć buforowanie, aby uniknąć ponownego ładowania tego samego dokumentu wielokrotnie, co może poprawić czasy odpowiedzi przy integracji z aplikacją internetową ASP.NET Core na dużą skalę.

Integracja Document Editor w aplikacji internetowej ASP.NET Core - Pełny przykład kodu

Poniższy kod demonstruje cały proces od konfiguracji do ładowania pliku DOCX.

var configuration = new Configuration
{
    ClientId = "client_id",
    ClientSecret = "client_secret"
};

var editorApi = new EditorApi(configuration);

var loadOptions = new LoadOptions
{
    FileInfo = new FileInfo { FilePath = "input.docx" },
    RenderOptions = new RenderOptions { OutputPath = "output.html" }
};

var loadResult = editorApi.LoadDocument(loadOptions);

Uwaga: Ten przykład kodu demonstruje podstawową funkcjonalność. Przed użyciem w swoim projekcie upewnij się, że zaktualizowałeś wszystkie ścieżki do plików i wartości konfiguracyjne, aby odpowiadały rzeczywistemu środowisku, sprawdź, czy wszystkie wymagane zależności są prawidłowo zainstalowane, oraz dokładnie przetestuj w środowisku deweloperskim. Jeśli napotkasz jakiekolwiek problemy, odwołaj się do oficjalnej dokumentacji lub skontaktuj się z zespołem wsparcia w celu uzyskania pomocy.

Korzystanie z cURL w integracji edycji dokumentów ASP.NET Core

Jeśli wolisz bezpośrednie podejście REST, tę samą operację można wykonać za pomocą poleceń cURL. Metoda ta jest przydatna do szybkiego prototypowania lub gdy musisz zintegrować edytor z usługą, która nie jest napisana w .NET.

1. Uwierzytelnij i uzyskaj token dostępu

curl -X POST "https://api.groupdocs.cloud/v2.0/auth/token" \
     -H "Content-Type: application/json" \
     -d '{"client_id":"YOUR_CLIENT_ID","client_secret":"YOUR_CLIENT_SECRET"}'

Odpowiedź zawiera access_token używany w kolejnych wywołaniach.

2. Prześlij plik źródłowy

curl -X POST "https://api.groupdocs.cloud/v2.0/editor/storage/upload?path=/input.docx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -F "file=@input.docx"

3. Załaduj dokument do edycji

curl -X POST "https://api.groupdocs.cloud/v2.0/editor/load" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "fileInfo": { "filePath": "input.docx" },
           "renderOptions": { "outputPath": "output.html" }
         }'

4. Pobierz renderowany HTML

curl -X GET "https://api.groupdocs.cloud/v2.0/editor/storage/download?path=/output.html" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o output.html

Te polecenia ilustrują, jak dodać edycję dokumentów do aplikacji ASP.NET Core bez pisania kodu w C#, co jest przydatne do szybkiego testowania lub integracji z innymi usługami. Po więcej szczegółów zobacz oficjalną dokumentację API.

Opanowując zarówno bibliotekę .NET, jak i surowe API REST, zyskujesz elastyczność przy integracji z aplikacją internetową ASP.NET Core, co pozwala wybrać podejście najlepiej pasujące do Twojej architektury.

Najczęściej zadawane pytania

Dalsze materiały