Aspose.Cells에서 Excel의 외부 리소스를 PDF로 제어

소개

오늘날의 디지털 시대에 Excel 스프레드시트를 PDF 문서로 변환하는 것은 흔한 작업입니다. 보고서, 재무 데이터 또는 프레젠테이션 자료를 준비하든 PDF가 의도한 대로 정확히 표시되도록 해야 합니다. Aspose.Cells for .NET은 특히 Excel 파일에 포함된 이미지와 같은 외부 리소스를 처리할 때 이 변환 프로세스를 세부 사항까지 제어할 수 있는 강력한 라이브러리입니다. 이 가이드에서는 Aspose.Cells를 사용하여 Excel에서 PDF로 변환하는 동안 외부 리소스를 제어하는 방법을 알아봅니다. 좋아하는 음료를 들고 시작해 볼까요!

필수 조건

본격적으로 들어가기 전에, 시작하기 위해 필요한 모든 것을 가지고 있는지 확인해 보겠습니다. 간단한 체크리스트는 다음과 같습니다.

  1. Visual Studio나 .NET 호환 IDE: 코드를 작성하고 테스트할 수 있는 환경이 필요합니다.
  2. .NET용 Aspose.Cells: 아직 설치하지 않았다면 다음으로 이동하세요.Aspose 다운로드 페이지로 가서 최신 버전을 다운로드하세요.
  3. C#에 대한 기본 지식: C# 프로그래밍 언어에 대한 지식이 도움이 될 것입니다. 어떤 개념에 대해 확신이 서지 않는다면, 주저하지 말고 찾아보세요.
  4. 샘플 Excel 파일: 변환하려는 외부 리소스가 있는 Excel 파일을 준비합니다. 제공된 샘플 파일 “samplePdfSaveOptions_StreamProvider.xlsx"를 사용할 수 있습니다.
  5. 테스트를 위한 이미지 파일: 이것은 변환 중에 외부 리소스로 사용됩니다. 이미지 파일 “newPdfSaveOptions_StreamProvider.png"는 좋은 플레이스홀더입니다.

패키지 가져오기

시작하려면 Aspose.Cells 라이브러리에서 필요한 네임스페이스를 가져와야 합니다. 이는 기능에 액세스하는 데 필수적입니다. 파일 맨 위에 다음 using 지시문을 추가해야 합니다.

using System.IO;
using System.Drawing;
using System.Drawing.Imaging;
using Aspose.Cells;
using Aspose.Cells.Drawing;
using Aspose.Cells.Rendering;
using System;

이러한 패키지는 작업을 수행하는 데 필요한 모든 필수 클래스와 메서드를 제공합니다.

1단계: 스트림 공급자 클래스 만들기

첫 번째 업무 순서는 스트림 공급자 클래스를 만드는 것입니다.IStreamProvider 인터페이스. 이 클래스를 사용하면 외부 리소스가 로드되는 방식을 제어할 수 있습니다.

class MyStreamProvider : IStreamProvider
{
    public void CloseStream(StreamProviderOptions options)
    {
        Debug.WriteLine("-----Close Stream-----");
    }
    public void InitStream(StreamProviderOptions options)
    {
        string sourceDir = "Your Document Directory";
        Debug.WriteLine("-----Init Stream-----");
        // 메모리 스트림에서 새 이미지를 읽고 Stream 속성에 할당합니다.
        byte[] bts = File.ReadAllBytes(sourceDir + "newPdfSaveOptions_StreamProvider.png");
        MemoryStream ms = new MemoryStream(bts);
        options.Stream = ms;
    }
}

이 수업에서는:

  • CloseStream: 이 메서드는 스트림이 닫힐 때 호출됩니다. 지금은 추적을 위한 디버그 메시지만 작성합니다.
  • InitStream: 마법이 시작되는 곳입니다. 여기에서 외부 이미지를 바이트 배열로 읽고 메모리 스트림으로 변환하여 할당합니다.options.Stream 재산.

2단계: 소스 및 출력 디렉토리 설정

이제 스트림 제공자가 준비되었으므로 Excel 파일이 있는 위치와 PDF를 저장할 위치를 확립할 차례입니다.

// 소스 디렉토리
string sourceDir = "Your Document Directory";
// 출력 디렉토리
string outputDir = "Your Document Directory";

간단히 교체하세요"Your Document Directory" 파일이 있는 컴퓨터의 실제 경로와 함께. 파일을 정리하는 것이 핵심입니다!

3단계: Excel 파일 로드

다음으로, PDF를 만들려는 Excel 파일을 로드합니다.

// 외부 이미지가 포함된 소스 Excel 파일 로드
Workbook wb = new Workbook(sourceDir + "samplePdfSaveOptions_StreamProvider.xlsx");

우리는 사용하고 있습니다Workbook Aspose.Cells의 클래스로, Excel 파일을 나타냅니다. 이 파일에는 변환 중에 제어하려는 이미지와 같은 다양한 외부 리소스가 포함될 수 있습니다.

4단계: PDF 저장 옵션 설정

워크북을 PDF로 저장하기 전에 저장 방법을 지정해 보겠습니다. 요구 사항에 따라 이러한 옵션을 조정할 수 있습니다.

// PDF 저장 옵션 지정 - 스트림 제공자
PdfSaveOptions opts = new PdfSaveOptions();
opts.OnePagePerSheet = true; // 각 시트를 새 페이지에 저장하세요

여기서 우리는 새로운 인스턴스를 생성하고 있습니다PdfSaveOptions PDF가 어떻게 포맷될지 사용자 정의할 수 있는 기능입니다.OnePagePerSheet이 옵션은 각 Excel 시트가 최종 PDF에서 별도의 페이지를 차지하도록 하는 데 유용합니다.

5단계: 스트림 공급자 지정

PDF 옵션을 설정하면 Aspose에서 외부 리소스에 대해 사용자 정의 스트림 공급자를 사용하도록 설정해야 합니다.

wb.Settings.StreamProvider = new MyStreamProvider();

이 라인은 당신을 연결합니다Workbook 인스턴스와 함께MyStreamProvider 이전에 만든 클래스입니다. 즉, 변환 중에 외부 리소스가 발생할 때마다 공급자가 지정된 대로 처리합니다.

6단계: 통합 문서를 PDF로 저장

모든 것이 설정되었으니, 마침내 Excel 통합 문서를 PDF로 저장할 시간입니다.

// 통합 문서를 PDF로 저장
wb.Save(outputDir + "outputPdfSaveOptions_StreamProvider.pdf", opts);

전화를 걸어서Save 통합 문서 개체에서 메서드를 사용하고 PDF 옵션과 함께 출력 디렉터리를 전달하면 Excel 파일이 아름답게 포맷된 PDF로 변환됩니다.

7단계: 성공적인 실행 확인

마무리로, 프로세스가 성공적으로 진행되었는지 확인하는 것이 좋습니다!

Console.WriteLine("ControlLoadingOfExternalResourcesInExcelToPDF executed successfully.\r\n");

콘솔에 성공 메시지를 인쇄하면 작업 상태를 파악하는 데 도움이 됩니다. 코드에 이러한 작은 확인을 포함하는 것은 좋은 습관입니다.

결론

이제 알았어요! 간단한 단계를 따르면 Aspose.Cells를 사용하여 Excel에서 PDF로 변환하는 동안 외부 리소스가 처리되는 방식을 전문적으로 제어할 수 있습니다. 즉, 이제 문서에 이미지와 기타 외부 요소를 정확하게 포함할 수 있으므로 매번 세련된 최종 제품을 보장할 수 있습니다.

자주 묻는 질문

Aspose.Cells란 무엇인가요?

Aspose.Cells는 다양한 형식의 Excel 파일을 만들고, 조작하고, 변환하고, 렌더링할 수 있는 .NET 개발자를 위한 강력한 라이브러리입니다.

Aspose.Cells를 어떻게 다운로드하나요?

Aspose.Cells의 최신 버전은 다음에서 다운로드할 수 있습니다.다운로드 링크.

Aspose.Cells를 무료로 사용할 수 있나요?

네! 무료 체험판을 방문하시면 받으실 수 있습니다.무료 체험 페이지.

Aspose.Cells에 대한 지원은 어디에서 찾을 수 있나요?

지원 관련 문의사항은 다음 사이트를 방문하세요.Aspose 지원 포럼.

Aspose.Cells에 대한 임시 라이선스를 어떻게 얻을 수 있나요?

임시면허를 신청할 수 있습니다.여기.

Aspose.Cells에서 출력 PDF에 빈 페이지가 나타나지 않도록 방지 Aspose.Cells에서 차트 시트에 대한 PDF 북마크 만들기