많은 애플리케이션에서는 .NET에서 PDF에 텍스트를 추가하여 문서를 동적으로 주석 처리해야 합니다. Conholdate.Total for .NET은 서버 또는 데스크톱에서 PDF 조작을 간소화하는 포괄적인 SDK입니다. 이 가이드에서는 라이브러리를 설치하고, 기존 PDF를 로드한 뒤, 스타일이 적용된 텍스트를 삽입하고, 완전한 실행 가능한 코드 예제와 함께 업데이트된 파일을 저장하는 방법을 보여드립니다.

Java에서 PDF에 텍스트 추가 요구 사항

Java 기반 프런트엔드를 구축하는 개발자는 백엔드에서 PDF를 수정할 수 있는 .NET 서비스가 필요할 때가 많습니다. 일반적인 요구 사항은 다음과 같습니다:

  • 기존 PDF를 로드하면서 기존 콘텐츠를 잃지 않기.
  • 정확한 좌표에 사용자 정의 텍스트를 추가하고, 특정 폰트와 색상을 지정하기.
  • 원본 레이아웃 및 메타데이터를 유지하면서 수정된 PDF를 저장하기.

수동 편집이나 일반적인 명령줄 도구는 자동화된 워크플로에서 이러한 요구를 충족시킬 수 없으며, 특히 작업을 많은 파일에 대해 프로그래밍 방식으로 수행해야 할 때 그렇습니다.

Conholdate.Total for .NET를 작업에 선택하기

Conholdate.Total for .NET은 위 요구 사항을 직접 해결하는 풍부한 PDF API 세트를 제공합니다. 다음과 같은 작업을 수행할 수 있습니다:

  • 변환 없이 PDF를 열고 편집합니다.
  • 전체 스타일 제어가 가능한 TextFragment 객체를 생성합니다.
  • 정확한 위치에 프래그먼트를 삽입하여 페이지에 추가합니다.
  • 단일 메서드 호출로 결과를 저장합니다.

SDK는 NuGet 패키지로 제공되며 모든 .NET 런타임에서 작동하고, 자세한 문서와 광범위한 API 참조를 포함합니다. 최신 빌드는 릴리스 페이지에서 다운로드할 수 있습니다.

단계별 가이드: .NET에서 PDF에 텍스트 추가

아래는 전체 예제에서 나중에 보여지는 코드를 반영한 실용적인 단계별 안내입니다.

Conholdate.Total for .NET 설치

먼저, NuGet을 통해 SDK를 프로젝트에 추가합니다.

dotnet add package Conholdate.Total --version 25.10.0

바이너리는 다운로드 URL에서도 얻을 수 있습니다.

기존 PDF 문서 로드

소스 PDF를 가리키는 Document 인스턴스를 생성합니다.

using GroupDocs.Pdf;

string inputPath = "input.pdf";

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

Document 클래스는 API 참조에 설명된 PDF API의 일부입니다.

텍스트 조각 만들기 및 구성

텍스트 조각(TextFragment)을 인스턴스화하고, 위치, 글꼴 및 색상을 설정합니다.

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

이 단계에서는 .NET 라이브러리를 사용하여 PDF에 텍스트 삽입을 전체 스타일 옵션과 함께 시연합니다.

페이지에 텍스트 조각 추가

대상 페이지(이 경우 첫 페이지)를 선택하고 조각을 추가합니다.

// 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);

여러 페이지나 위치에 .NET에서 PDF 파일에 텍스트를 추가할 수 있도록 이 블록을 반복할 수 있습니다.

수정된 PDF 문서 저장

마지막으로, 변경 사항을 새 파일에 기록합니다.

string outputPath = "output.pdf";

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

SDK는 모든 저수준 PDF 구조를 처리하므로 저장된 파일은 원본 콘텐츠와 새로운 주석을 모두 유지합니다.

전체 샘플 코드: .NET에서 PDF에 텍스트 추가

다음 예제는 시작부터 끝까지 전체 과정을 보여줍니다.

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}'.");
    }
}

Note: 이 코드 예제는 핵심 기능을 보여줍니다. 프로젝트에 사용하기 전에 파일 경로와 구성 값을 실제 환경에 맞게 업데이트하고, 모든 필수 종속성이 올바르게 설치되었는지 확인하며, 개발 환경에서 충분히 테스트하십시오. 문제가 발생하면 공식 문서를 참조하거나 지원 팀에 문의하십시오.

결론

.NET에서 PDF에 텍스트를 추가하는 것은 Conholdate.Total for .NET의 강력한 기능을 사용하면 간단합니다. 위 단계들을 따라 문서를 로드하고, 스타일이 적용된 TextFragment를 생성하고, 정확히 배치한 뒤, 몇 줄의 코드만으로 결과를 저장할 수 있습니다. 프로덕션 배포를 위해 유효한 라이선스를 적용하는 것을 잊지 마세요; 임시 라이선스는 license page에서 얻을 수 있으며, pricing page에서 가격 옵션을 확인하세요. 이 기반을 바탕으로 다중 행 주석, 동적 데이터 삽입 또는 PDF 배치 처리와 같은 작업으로 접근 방식을 확장할 수 있습니다.

FAQ

.NET 라이브러리를 사용하여 PDF에 텍스트를 삽입하려면 어떻게 해야 하나요?

PDF API의 TextFragment 클래스를 사용하고, Position, Font, Color를 설정한 다음 페이지의 Paragraphs 컬렉션에 추가합니다. 전체 워크플로는 위의 코드 예제에 나와 있습니다.

.NET을 사용하여 기존 PDF에 텍스트를 다른 내용을 덮어쓰지 않고 쓸 수 있나요?

예. SDK는 PDF를 제자리에서 수정하여 기존 페이지, 이미지 및 주석을 보존하면서 새로운 텍스트 조각을 추가합니다.

.NET에서 여러 페이지에 텍스트를 추가하는 가장 좋은 방법은 무엇인가요?

Pages 컬렉션을 순회하고, 각 페이지마다 TextFragment를 생성하고, 위치를 구성한 뒤 페이지의 Paragraphs에 추가합니다. 이 접근 방식은 페이지 수에 관계없이 확장됩니다.

더 읽기