Wiele aplikacji potrzebuje dodawać tekst do PDF w .NET, aby dynamicznie anotować dokumenty. Conholdate.Total for .NET jest kompleksowym zestawem SDK, który upraszcza manipulację PDF na serwerze lub komputerze stacjonarnym. W tym przewodniku zobaczysz, jak zainstalować bibliotekę, załadować istniejący PDF, wstawić sformatowany tekst i zapisać zaktualizowany plik przy użyciu kompletnego, gotowego do uruchomienia przykładu kodu.

Wymagania dotyczące dodawania tekstu do PDF w Javie

Programiści tworzący front‑end oparte na Javie często potrzebują usługi .NET, która może modyfikować pliki PDF po stronie serwera. Typowe wymagania obejmują:

  • Ładowanie istniejącego pliku PDF bez utraty istniejącej zawartości.
  • Dodawanie własnego tekstu w precyzyjnych współrzędnych, z określoną czcionką i kolorem.
  • Zapisywanie zmodyfikowanego PDF z zachowaniem oryginalnego układu i metadanych.

Ręczna edycja lub ogólne narzędzia wiersza poleceń nie mogą sprostać tym potrzebom w zautomatyzowanym przepływie pracy, szczególnie gdy operacja musi być wykonana programowo dla wielu plików.

Wybór Conholdate.Total for .NET do zadania

Conholdate.Total for .NET oferuje bogaty zestaw interfejsów PDF API, które bezpośrednio spełniają powyższe wymagania. Może:

  • Otwórz i edytuj pliki PDF bez konwersji.
  • Twórz obiekty TextFragment z pełną kontrolą stylizacji.
  • Wstaw fragmenty na dowolną stronę w dokładnych pozycjach.
  • Zapisz wynik jednym wywołaniem metody.

SDK jest dostarczany jako pakiet NuGet, działa na wszystkich środowiskach .NET i zawiera szczegółową dokumentację oraz obszerną referencję API. Najnowszą wersję możesz pobrać ze strony wydania.

Przewodnik krok po kroku: Dodaj tekst do PDF w .NET

Poniżej znajduje się praktyczny przewodnik, który odzwierciedla kod pokazany później w pełnym przykładzie.

Install Conholdate.Total for .NET

Najpierw dodaj SDK do swojego projektu za pomocą NuGet.

dotnet add package Conholdate.Total --version 25.10.0

Możesz również uzyskać pliki binarne z adresu pobierania.

Ładowanie istniejącego dokumentu PDF

Utwórz instancję Document, wskazującą na źródłowy plik PDF.

using GroupDocs.Pdf;

string inputPath = "input.pdf";

// Load the existing PDF document
using (Document pdfDocument = new Document(inputPath))
{
    // further processing...
}

Klasa Document jest częścią API PDF opisanego w referencji API.

Utwórz i skonfiguruj fragment tekstu

Zainicjuj TextFragment, ustaw jego pozycję, czcionkę i kolor.

using GroupDocs.Pdf.Contents;
using GroupDocs.Pdf.Contents.Text;
using GroupDocs.Pdf.Contents.Fonts;

// Create a text fragment to insert
TextFragment textFragment = new TextFragment("Added text using Conholdate.Total for .NET");

// Set visual properties
textFragment.Position = new Position(100, 150); // X and Y coordinates in points
textFragment.Font = new Font("Arial", 12);
textFragment.Color = new Color(255, 0, 0); // Red color

Ten krok demonstruje wstawianie tekstu do PDF przy użyciu biblioteki .NET z pełnymi opcjami stylizacji.

Dodaj fragment tekstu do strony

Wybierz docelową stronę (pierwszą stronę w tym przypadku) i dodaj fragment.

// Ensure there is at least one page
Page page = pdfDocument.Pages.Count > 0 ? pdfDocument.Pages[0] : pdfDocument.Pages.Add();

// Add the text fragment to the page
page.Paragraphs.Add(textFragment);

Możesz powtarzać ten blok, aby dodać tekst do pliku PDF w .NET na wielu stronach lub pozycjach.

Zapisz zmodyfikowany dokument PDF

Na koniec zapisz zmiany do nowego pliku.

string outputPath = "output.pdf";

// Save the modified PDF
pdfDocument.Save(outputPath);

SDK obsługuje wszystkie niskopoziomowe struktury PDF, więc zapisany plik zachowuje oryginalną zawartość oraz nową adnotację.

Pełny przykładowy kod: Dodaj tekst do PDF w .NET

Poniższy przykład demonstruje cały proces od początku do końca.

using System;
using GroupDocs.Pdf;
using GroupDocs.Pdf.Contents;
using GroupDocs.Pdf.Contents.Text;
using GroupDocs.Pdf.Contents.Fonts;

class Program
{
    static void Main()
    {
        string inputPath = "input.pdf";
        string outputPath = "output.pdf";

// Load the existing PDF document
        using (Document pdfDocument = new Document(inputPath))
        {
            // Ensure there is at least one page
            Page page = pdfDocument.Pages.Count > 0 ? pdfDocument.Pages[0] : pdfDocument.Pages.Add();

// Create a text fragment to insert
            TextFragment textFragment = new TextFragment("Added text using Conholdate.Total for .NET");

// Set visual properties
            textFragment.Position = new Position(100, 150); // X and Y coordinates in points
            textFragment.Font = new Font("Arial", 12);
            textFragment.Color = new Color(255, 0, 0); // Red color

// Add the text fragment to the page
            page.Paragraphs.Add(textFragment);

// Save the modified PDF
            pdfDocument.Save(outputPath);
        }

Console.WriteLine($"Text successfully added. Output saved to '{outputPath}'.");
    }
}

Uwaga: Ten przykład kodu demonstruje podstawową funkcjonalność. Przed użyciem go w swoim projekcie upewnij się, że zaktualizowałeś wszystkie ścieżki plików i wartości konfiguracyjne, aby odpowiadały rzeczywistemu środowisku, sprawdź, czy wszystkie wymagane zależności są poprawnie 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.

Podsumowanie

Dodawanie tekstu do PDF w .NET jest proste dzięki potężnym funkcjom Conholdate.Total for .NET. Postępując zgodnie z powyższymi krokami, możesz załadować dokument, utworzyć stylizowany TextFragment, precyzyjnie go umieścić i zapisać wynik, używając zaledwie kilku linii kodu. Pamiętaj, aby zastosować ważną licencję w środowiskach produkcyjnych; tymczasową licencję możesz uzyskać na stronie licencji i sprawdzić opcje cenowe na stronie cenowej. Mając tę podstawę, możesz rozszerzyć podejście o wieloliniowe adnotacje, dynamiczne wstawianie danych lub przetwarzanie wsadowe plików PDF.

FAQ

Jak wstawić tekst do PDF przy użyciu biblioteki .NET?

Użyj klasy TextFragment z PDF API, ustaw jej Position, Font i Color, a następnie dodaj ją do kolekcji Paragraphs na stronie. Pełny przepływ pracy jest zilustrowany w powyższym przykładzie kodu.

Czy mogę dodać tekst do istniejącego PDF w .NET bez nadpisywania pozostałej zawartości?

Tak. SDK modyfikuje PDF w miejscu, zachowując istniejące strony, obrazy i adnotacje, jednocześnie dodając nowe fragmenty tekstu.

Jaki jest najlepszy sposób na dodanie tekstu do pliku PDF w .NET dla wielu stron?

Iteruj przez kolekcję Pages, utwórz TextFragment dla każdej strony, skonfiguruj jego pozycję i dodaj go do Paragraphs strony. To podejście skalowalne jest dla dowolnej liczby stron.

Czytaj więcej