HOWTO · Csharp
C#에서 PDF 파일을 여는 방법
C#으로 PDF를 기본 뷰어에서 실행하거나 텍스트를 추출하는 방법과 WinForms 뷰어 컨트롤을 평가하는 방법을 알아봅니다.
이 페이지의 내용
Windows Forms 애플리케이션에서 PDF를 연다는 것은 별도의 애플리케이션을 실행하거나, 폼 안에 페이지를 렌더링하거나, 문서 텍스트를 추출하는 것을 의미할 수 있습니다. UseShellExecute = true를 사용하는 Process.Start()는 Windows에 파일 연결을 사용하도록 요청합니다. 페이지를 내장하지는 않습니다. 렌더링에는 특정 뷰어 컨트롤과 그 문서화된 WinForms API가 필요합니다. 이 글에서 사용할 수 있는 제품 및 버전 정보로는 완전한 내장 워크플로로 보여 줄 수 있는 뷰어 API를 특정할 수 없으므로, 뷰어 섹션에서는 확인되지 않은 설정이나 로드 코드를 제시하는 대신 무엇을 확인해야 하는지를 설명합니다. 아래의 PdfDocument 및 System.IO.Stream 섹션은 텍스트 추출만을 다룹니다.
Process.Start() 메서드를 사용하여 C#에서 PDF 파일 열기
UseShellExecute = true와 함께 Process.Start()를 사용하면 사용자의 연결된 애플리케이션에서 PDF를 열 수 있습니다. 아래 경로는 애플리케이션 디렉터리를 기준으로 구성되므로 프로세스의 현재 작업 디렉터리에 의존하지 않습니다. report.pdf를 애플리케이션 옆의 Resources 폴더에 두거나, OpenFileDialog로 선택한 경로를 사용하세요. Microsoft의 Process.Start API 참조는 셸 실행을 문서화하고 있습니다.
이 독립 실행형 C# 샘플은 일반적인 경로를 구성합니다. 제공된 실행 결과는 파일 이름만 확인합니다. PDF 애플리케이션을 실행하거나 PDF가 열리는지를 확인하지는 않습니다.
using System;
using System.IO;
class Program
{
static void Main()
{
string pdfPath = Path.Combine(AppContext.BaseDirectory, "Resources", "report.pdf");
Console.WriteLine(Path.GetFileName(pdfPath));
}
}
Output:
report.pdf
WinForms 버튼에는 using System.Diagnostics;, using System.IO;, using System.Windows.Forms;를 추가하세요. 이 핸들러는 파일을 묻고, 연결된 애플리케이션을 실행하며, 흔한 파일 또는 셸 실행 실패를 보고합니다. private void openPdfButton_Click(object sender, EventArgs e) { using (var dialog = new OpenFileDialog { Filter = "PDF files (*.pdf)|*.pdf|All files (*.*)|*.*" }) { if (dialog.ShowDialog(this) != DialogResult.OK) return; try { Process.Start(new ProcessStartInfo { FileName = dialog.FileName, UseShellExecute = true }); } catch (FileNotFoundException ex) { MessageBox.Show(this, ex.Message, "Could not open PDF"); } catch (System.ComponentModel.Win32Exception ex) { MessageBox.Show(this, ex.Message, "Could not open PDF"); } } }. 호출이 성공하면 외부 애플리케이션이 시작됩니다. 폼 안에 PDF 페이지가 표시되지는 않습니다.
DynamicPDF 뷰어를 사용하여 C#에서 PDF 파일 열기
DynamicPDF라는 이름만으로는 뷰어 컨트롤을 특정할 수 없습니다. 여러 제품에 걸쳐 사용되는 제품 이름이기 때문입니다. 제공된 문서에서는 WinForms 뷰어, 설치 지침, 라이선스 조건, PDF 로드 API를 갖춘 특정 DynamicPDF 에디션과 버전을 특정할 수 없습니다. 따라서 이 섹션은 DynamicPDF 설정이나 코드 순서를 제공하지 않으며, DynamicPDF가 제목에서 요구하는 내장 워크플로를 제공한다고 주장하지도 않습니다. 이 이름의 제품을 채택하기 전에, 정확한 에디션과 버전에 대한 공급업체 문서를 찾아 WinForms 지원, 라이선스, 파일 로드, 문서 수명을 확인하세요. 위의 Process.Start() 핸들러는 사용할 수 있는 외부 실행 옵션입니다. 폼 안에 페이지를 렌더링하지는 않습니다.
PdfDocument를 사용하여 C#에서 PDF 파일 열기
PdfDocument는 기본 제공 .NET 형식이 아니며, 그 생성자와 렌더링 동작은 이를 정의하는 라이브러리에 따라 달라집니다. 제공된 제품 문서에서 특정 PdfDocument 뷰어 API가 특정되지 않았으므로, 이 섹션에서는 바이트 배열에서 뷰어로 이어지는 워크플로를 보여 주지 않습니다. 아래 예제는 다른 작업입니다. iTextSharp 5.5.13.4로 PDF 바이트를 읽고 텍스트를 추출합니다. 페이지를 렌더링하지는 않습니다.
iTextSharp NuGet 패키지를 버전 5.5.13.4로 설치하세요. using System.IO;, using System.Text;와 두 iTextSharp 네임스페이스를 가져온 상태에서, byte[] pdfBytes = File.ReadAllBytes(path); var text = new StringBuilder(); using (var reader = new PdfReader(pdfBytes)) { for (int page = 1; page <= reader.NumberOfPages; page++) text.AppendLine(PdfTextExtractor.GetTextFromPage(reader, page)); }를 사용해 선택한 PDF 경로를 읽습니다. 여기서 path는 선택한 PDF 파일 이름입니다. PdfReader는 구문 분석된 문서를 소유하며 루프가 끝난 뒤 dispose됩니다. 버전이 지정된 iTextSharp 5 .NET API 참조는 리더와 추출 API를 문서화합니다. 이 바이트를 WinForms 컨트롤에서 렌더링하려면, 정확한 버전에서 바이트 배열 로드와 페이지 렌더링을 문서화하는 라이브러리를 사용하세요. PdfReader를 뷰어로 취급해서는 안 됩니다.
System.IO.Stream 인스턴스를 사용하여 C#에서 PDF 파일 열기
System.IO.Stream은 라이브러리에 바이트를 공급합니다. 스트림 자체는 PDF 페이지를 표시하지 않습니다. 다음 iTextSharp 5.5.13.4 작업은 메모리에 있는 PDF에서 텍스트를 추출하며 렌더링하지는 않습니다. using System.IO;, using System.Text;와 iTextSharp 네임스페이스가 필요합니다. var text = new StringBuilder(); using (var stream = new MemoryStream(pdfBytes, writable: false)) { using (var reader = new PdfReader(stream)) { reader.CloseStream = false; for (int page = 1; page <= reader.NumberOfPages; page++) text.AppendLine(PdfTextExtractor.GetTextFromPage(reader, page)); } }. pdfBytes에는 PDF 데이터가 들어 있습니다. 리더가 먼저 dispose됩니다. CloseStream = false는 스트림을 소유자를 위해 열린 상태로 두고, 바깥쪽 using이 이후에 이를 dispose합니다. 스트림은 리더에 전달될 때 읽을 수 있어야 하고 시작 위치에 있어야 합니다. 버전이 지정된 iTextSharp 5 .NET API 참조는 스트림 입력을 문서화합니다. 이것은 텍스트 추출이지 내장 뷰어 워크플로가 아닙니다. 뷰어의 스트림 로드와 소유권 규칙은 그 뷰어 자체의 버전 지정 문서에서 나와야 합니다.
iTextSharp NuGet 패키지를 사용하여 C#에서 PDF 파일 열기
이 iTextSharp 5.5.13.4 워크플로는 WinForms RichTextBox로 텍스트를 추출합니다. PDF 페이지를 표시하지는 않습니다. iTextSharp NuGet 패키지를 버전 5.5.13.4로 설치하고, 이름이 textBox1인 RichTextBox를 폼에 배치한 뒤, iTextSharp.text.pdf, iTextSharp.text.pdf.parser, System.Text를 가져오세요. dialog.FileName에 선택된 경로가 있을 때 핵심 작업은 var text = new StringBuilder(); using (var reader = new PdfReader(dialog.FileName)) { for (int page = 1; page <= reader.NumberOfPages; page++) text.AppendLine(PdfTextExtractor.GetTextFromPage(reader, page)); } textBox1.Text = text.ToString();입니다. 버전이 지정된 iTextSharp 5 .NET API 참조는 이러한 리더와 추출 API를 문서화합니다. 패키지를 선택할 때는 iText의 AGPLv3 라이선스 정보를 검토하세요.
PdfReader는 페이지 루프가 끝난 뒤 dispose됩니다. 메모리에 있는 문서에는 문서화된 바이트 배열 생성자를 사용하세요. 비밀번호로 보호된 파일에는 같은 버전이 지원하는 비밀번호 오버로드를 사용하고, 비밀번호는 사용자에게서 받으세요. 추출된 텍스트는 페이지 레이아웃, 글꼴, 이미지, 주석을 유지하지 않습니다. 이는 콘텐츠를 읽는 접근 방식이지 뷰어 컨트롤이 아닙니다.
도구 상자의 PdfViewer를 사용하여 C#에서 PDF 파일 열기
PdfViewer는 제품별 컨트롤 이름이지, 하나의 공통 로드 메서드를 가진 표준 WinForms 구성 요소가 아닙니다. 제공된 문서는 공급업체 에디션과 버전을 명시하지 않으며, WinForms 사용 가능 여부, 도구 상자 설치, 라이선스, PDF 로드, 문서와 스트림 수명에 대한 공급업체의 직접적인 안내도 제공하지 않습니다. 따라서 이 섹션은 도구 상자 순서를 확인된 것처럼 제시하지 않으며, 사용할 수 있는 내장 뷰어 워크플로를 제공하지도 않습니다. 실제 WinForms 뷰어를 사용하려면 문서화된 제품 버전을 선택하고, 컨트롤을 추가하고, 파일이나 지원되는 입력을 로드하고, 그 소유권 규칙에 따라 문서나 스트림을 dispose하는 공급업체 지침을 따르세요. 위의 외부 Process.Start() 옵션은 연결된 별도의 애플리케이션을 엽니다. 내장 PdfViewer가 아닙니다.