Dodaj nagłówki i stopki w formacie PDF przy użyciu języka C#

Sekcje nagłówka i stopki w dokumencie pokazują informacje o dokumencie, takie jak tytuł dokumentu, logo, nagłówek rozdziału, numery stron itp. Możemy programowo dodać dowolny tekst lub obraz do nagłówków/stopek dokumentu PDF. W tym artykule dowiemy się, jak dodawać nagłówki i stopki w dokumentach PDF za pomocą języka C#.

W tym artykule zostaną omówione następujące tematy:

API C# umożliwiające dodawanie nagłówków i stopek w dokumentach PDF

Do dodawania nagłówków i stopek w plikach PDF będziemy używać Aspose.PDF for .NET API. Pozwala nam generować, modyfikować, konwertować, renderować, zabezpieczać i drukować obsługiwane dokumenty bez użycia programu Adobe Acrobat. Pobierz bibliotekę DLL interfejsu API lub zainstaluj ją za pomocą NuGet.

Install-Package Aspose.PDF

Dodaj tekst w nagłówku pliku PDF za pomocą C#

Możemy dodać tekst w nagłówku istniejącego dokumentu PDF, wykonując poniższe czynności:

  1. Najpierw załaduj dokument PDF, używając klasy Document ze ścieżką pliku wejściowego jako argumentem. Jest to główna klasa reprezentująca dokument PDF i umożliwiająca wykonywanie różnych funkcjonalności.
  2. Następnie utwórz instancję klasy TextStamp z tekstem, który będzie wyświetlany w nagłówku dokumentu.
  3. Następnie ustaw różne właściwości, takie jak TopMargin, HorizontalAlignment i VerticalAlignment jako Top itp.
  4. Opcjonalnie ustaw ForegroundColor, Font, FontStyle, FontSize, BackgroundColor, RotateAngle i poziom powiększenia tekstu.
  5. Następnie przejrzyj wszystkie strony i dodaj nagłówek za pomocą metody Page.AddStamp() z obiektem TextStamp.
  6. Na koniec wywołaj metodę Document.Save() podając ścieżkę pliku wyjściowego jako argument, aby zapisać plik wyjściowy.

Poniższy przykładowy kod pokazuje, jak dodać tekst w nagłówku dokumentu PDF przy użyciu języka C#.

// Ten przykład kodu demonstruje, jak dodać tekst w nagłówku istniejącego dokumentu PDF.
// Załaduj dokument PDF
Document pdfDocument = new Document(@"C:\Files\sample.pdf");

// Utwórz nagłówek
TextStamp textStamp = new TextStamp("Header Text");

// Ustaw właściwości stempla
textStamp.TopMargin = 10;
textStamp.HorizontalAlignment = HorizontalAlignment.Center;
textStamp.VerticalAlignment = VerticalAlignment.Top;

// Określ styl czcionki
textStamp.TextState.FontStyle = FontStyles.Bold;
textStamp.TextState.ForegroundColor = Color.Red;
textStamp.TextState.FontSize = 14;
textStamp.TextState.BackgroundColor = Color.Pink;
textStamp.TextState.Font = FontRepository.FindFont("Verdana");

// Dodaj nagłówek na wszystkich stronach
foreach (Page page in pdfDocument.Pages)
{
    page.AddStamp(textStamp);
}

// Zapisz zaktualizowany dokument
pdfDocument.Save(@"C:\Files\output.pdf");
Dodaj tekst w nagłówku pliku PDF przy użyciu języka C#.

Dodaj tekst w nagłówku pliku PDF przy użyciu języka C#.

Dodaj tekst w stopce pliku PDF przy użyciu języka C#

Możemy programowo dodać tekst w stopce dokumentów PDF, wykonując kroki wymienione wcześniej. Musimy jednak ustawić BottomMargin i VerticalAlignment jako Bottom, aby wyświetlić tekst w stopce.

Poniższy przykładowy kod pokazuje, jak dodać tekst w stopce dokumentu PDF przy użyciu języka C#.

// Ten przykład kodu demonstruje, jak dodać tekst w stopce istniejącego dokumentu PDF.
// Załaduj dokument PDF
Document pdfDocument = new Document(@"C:\Files\sample.pdf");

// Utwórz stopkę
TextStamp textStamp = new TextStamp("Footer Text");

// Ustaw właściwości stempla
textStamp.BottomMargin = 10;
textStamp.HorizontalAlignment = HorizontalAlignment.Center;
textStamp.VerticalAlignment = VerticalAlignment.Bottom;

// Dodaj stopkę na wszystkich stronach
foreach (Page page in pdfDocument.Pages)
{
    page.AddStamp(textStamp);
}

// Zapisz zaktualizowany dokument
pdfDocument.Save(@"C:\Files\output.pdf");
Dodaj tekst w stopce pliku PDF przy użyciu języka C#.

Dodaj tekst w stopce pliku PDF przy użyciu języka C#.

Wstaw obraz w nagłówku pliku PDF przy użyciu języka C#

Możemy także dodać obraz w nagłówku istniejącego dokumentu PDF, wykonując poniższe czynności:

  1. Najpierw załaduj dokument PDF, używając klasy Document ze ścieżką pliku wejściowego jako argumentem.
  2. Następnie utwórz instancję klasy ImageStamp, podając jako argument ścieżkę do pliku obrazu.
  3. Następnie ustaw różne właściwości, takie jak TopMargin, HorizontalAlignment i VerticalAlignment jako Top itp.
  4. Następnie przejrzyj wszystkie strony i dodaj nagłówek za pomocą metody Page.AddStamp() z obiektem ImageStamp.
  5. Na koniec wywołaj metodę Document.Save() podając ścieżkę do pliku wyjściowego jako argument, aby zapisać plik wyjściowy.

Poniższy przykładowy kod pokazuje, jak dodać obraz w nagłówku dokumentu PDF przy użyciu języka C#.

// Ten przykład kodu demonstruje, jak dodać obraz w nagłówku istniejącego dokumentu PDF.
// Załaduj dokument PDF
Document pdfDocument = new Document(@"C:\Files\sample.pdf");

// Utwórz nagłówek
ImageStamp imageStamp = new ImageStamp(@"C:\Files\conholdate-logo.jpg");

// Ustaw właściwości stempla
imageStamp.TopMargin = 10;
imageStamp.HorizontalAlignment = HorizontalAlignment.Center;
imageStamp.VerticalAlignment = VerticalAlignment.Top;

// Dodaj nagłówek na wszystkich stronach
foreach (Page page in pdfDocument.Pages)
{
    page.AddStamp(imageStamp);
}

// Zapisz zaktualizowany dokument
pdfDocument.Save(@"C:\Files\output.pdf");
Wstaw obraz w nagłówku pliku PDF przy użyciu języka C#.

Wstaw obraz w nagłówku pliku PDF przy użyciu języka C#.

Możemy programowo dodawać obrazy w stopce dokumentów PDF, wykonując kroki wymienione wcześniej. Musimy jednak ustawić BottomMargin i VerticalAlignment jako Bottom, aby wyświetlić obraz w stopce.

Poniższy przykładowy kod pokazuje, jak dodać obraz w stopce dokumentu PDF przy użyciu języka C#.

// Ten przykład kodu demonstruje, jak dodać obraz w stopce istniejącego dokumentu PDF.
// Załaduj dokument PDF
Document pdfDocument = new Document(@"C:\Files\sample.pdf");

// Utwórz stopkę
ImageStamp imageStamp = new ImageStamp(@"C:\Files\conholdate-logo.jpg");

// Ustaw właściwości stempla
imageStamp.BottomMargin = 10;
imageStamp.HorizontalAlignment = HorizontalAlignment.Center;
imageStamp.VerticalAlignment = VerticalAlignment.Bottom;

// Dodaj stopkę na wszystkich stronach
foreach (Page page in pdfDocument.Pages)
{
    page.AddStamp(imageStamp);
}

// Zapisz zaktualizowany dokument
pdfDocument.Save(@"C:\Files\output.pdf");
Wstaw obraz w stopce pliku PDF przy użyciu języka C#.

Wstaw obraz w stopce pliku PDF przy użyciu języka C#.

Dodaj różne nagłówki i stopki na różnych stronach

Możemy dodać różne nagłówki/stopki dla różnych stron w jednym dokumencie PDF, wykonując czynności podane poniżej:

  1. Najpierw załaduj dokument PDF, używając klasy Document ze ścieżką pliku wejściowego jako argumentem.
  2. Następnie utwórz wiele instancji klasy ImageStamp ze ścieżką do pliku obrazu i/lub klasy TextStamp z tekstem do wyświetlenia.
  3. Następnie ustaw różne właściwości, takie jak TopMargin, HorizontalAlignment i VerticalAlignment jako Top dla nagłówka oraz BottomMargin i VerticalAlignment jako Bottom dla stopki.
  4. Następnie dodaj nagłówek lub stopkę za pomocą metody Page.AddStamp() z obiektem ImageStamp lub TextStamp dla strony.
  5. Na koniec wywołaj metodę Document.Save() podając ścieżkę do pliku wyjściowego jako argument, aby zapisać plik wyjściowy.

Poniższy przykładowy kod pokazuje, jak dodać wiele nagłówków i stopek w jednym dokumencie PDF przy użyciu języka C#.

// Ten przykład kodu demonstruje, jak dodać różne nagłówki dla różnych stron w jednym dokumencie PDF.
// Załaduj dokument PDF
Document pdfDocument = new Document(@"C:\Files\sample.pdf");

// Utwórz trzy pieczątki
ImageStamp stamp1 = new ImageStamp(@"C:\Files\PDF\conholdate-logo.jpg");
TextStamp stamp2 = new TextStamp("Header Stamp 2");
TextStamp stamp3 = new TextStamp("Header Stamp 3");

// Ustaw wyrównanie stempla dla stempla 1
stamp1.VerticalAlignment = VerticalAlignment.Top;
stamp1.HorizontalAlignment = HorizontalAlignment.Center;

// Ustaw wyrównanie stempla dla stempla 2
stamp2.VerticalAlignment = VerticalAlignment.Top;
// Ustaw informacje o wyrównaniu w poziomie dla stempla jako Wyrównane do środka
stamp2.HorizontalAlignment = HorizontalAlignment.Center;
// Ustaw współczynnik powiększenia obiektu stempla
stamp2.Zoom = 10;

// Ustaw wyrównanie stempla dla stempla 3
stamp3.VerticalAlignment = VerticalAlignment.Top;
// Ustaw informacje o wyrównaniu w poziomie dla obiektu stempla jako Wyrównane do środka
stamp3.HorizontalAlignment = HorizontalAlignment.Center;
// Ustaw kąt obrotu obiektu stempla
stamp3.RotateAngle = 35;


// Dodaj pierwszą pieczątkę na pierwszej stronie;
pdfDocument.Pages[1].AddStamp(stamp1);

// Dodaj drugi znaczek na drugiej stronie;
pdfDocument.Pages[2].AddStamp(stamp2);

// Dodaj trzeci znaczek na trzeciej stronie.
pdfDocument.Pages[3].AddStamp(stamp3);

// Zapisz zaktualizowany dokument
pdfDocument.Save(@"C:\Files\output.pdf");

Dodaj numery stron w stopce pliku PDF przy użyciu języka C#

Możemy dodać numery stron w sekcji stopki dokumentów PDF, wykonując czynności podane poniżej:

  1. Najpierw załaduj dokument PDF, używając klasy Document ze ścieżką pliku wejściowego jako argumentem.
  2. Następnie wykonaj poniższe czynności dla każdej strony w kolekcji Document.Pages.
    • Utwórz instancję klasy TextStamp z tekstem połączonym z numerem bieżącej strony.
    • Następnie ustaw różne właściwości, takie jak BottomMargin, HorizontalAlignment i VerticalAlignment jako Bottom itp.
    • Następnie wywołaj metodę Page.AddStamp() z obiektem TextStamp, aby dodać numer strony w stopce.
  3. Na koniec wywołaj metodę Document.Save() podając ścieżkę pliku wyjściowego jako argument, aby zapisać plik wyjściowy.

Poniższy przykładowy kod pokazuje, jak dodać numer strony dla każdej strony w stopce dokumentu PDF przy użyciu języka C#.

// Ten przykład kodu demonstruje, jak dodać numer strony w stopce każdej strony dokumentu PDF. 
// Załaduj dokument PDF
Document pdfDocument = new Document(@"C:\Files\sample.pdf");

// Dodaj stopkę na wszystkich stronach
foreach (Page page in pdfDocument.Pages)
{
    // Utwórz stopkę
    TextStamp textStamp = new TextStamp("Page " + page.Number + " of " + pdfDocument.Pages.Count + " pages.");
    
    // Ustaw właściwości stempla
    textStamp.BottomMargin = 10;
    textStamp.HorizontalAlignment = HorizontalAlignment.Center;
    textStamp.VerticalAlignment = VerticalAlignment.Bottom;

    // Dodaj znaczek
    page.AddStamp(textStamp);
}

// Zapisz zaktualizowany dokument
pdfDocument.Save(@"C:\Files\PDF\output.pdf");
Dodaj numery stron w stopce.

Dodaj numery stron w stopce pliku PDF przy użyciu języka C#.

Uzyskaj bezpłatną licencję API

Możesz wypróbować interfejs API bez ograniczeń ewaluacyjnych, prosząc o bezpłatną licencję tymczasową.

Wniosek

W tym artykule dowiedzieliśmy się, jak dodać tekst lub obraz do nagłówków/stopek istniejących plików PDF przy użyciu języka C#. Widzieliśmy także, jak dodawać różne nagłówki na różnych stronach dokumentu PDF i jak dodawać numer strony w stopce dokumentu. Poza tym możesz dowiedzieć się więcej o Aspose.PDF for .NET API, korzystając z dokumentacji. W przypadku jakichkolwiek niejasności prosimy o kontakt na forum.

Zobacz też