Aspose.Words 문서 변환기 for .NET

Aspose.Words Document Converter for .NET는 가벼운, 고성능 API입니다 format-to-format 변환. 그것은 일반적인 시나리오를 지원합니다 Word → PDF, HTML → pdf**, DOCX ↔ ODT* , * DOCX → Markdown** PDF → 이미지 (JPG/PNG/TIFF) 및 수십 개 이상 - Microsoft Office를 필요로하지 않고.

설치 및 설정

  • NuGet 패키지를 설치합니다 Aspose.Words (코어 API 전원 변환).
  • 평가 제한을 피하기 위해 스타트업에서 측정 된 라이센스를 적용하십시오 : 참조 계량된 라이선스 .
  • 프레임 워크 요구 사항에 대한 검토 설치 가이드 .

지원되는 플랫폼

  • 윈도우, 리눅스, macOS
  • 프레임 워크: .NET Framework 4.x, .NET Standard 2.0,.NET Core 2.0–3.1, .Net 5/6/7+, Mono
  • IDEs: Visual Studio 2017–2022, JetBrains Rider, MonoDevelop

빠른 시작

1) 단어 → PDF (One-lineer) 

using Aspose.Words;
var doc = new Document("input.docx");
doc.Save("output.pdf");

2) HTML → PDF 옵션 

using Aspose.Words;
using Aspose.Words.Saving;

var doc = new Document("input.html");
var pdf = new PdfSaveOptions
{
    Compliance = PdfCompliance.PdfA1b,    // archival
    EmbedFullFonts = false,               // reduce size
    OptimizationOptions = { ImageCompression = PdfImageCompression.Jpeg }
};
doc.Save("output.pdf", pdf);

3) DOCX → 마크다운 

using Aspose.Words;
using Aspose.Words.Saving;

var doc = new Document("spec.docx");
var md = new MarkdownSaveOptions
{
    TableContentAlignment = MarkdownTableContentAlignment.Auto,
    ListExportMode = MarkdownListExportMode.PlainText
};
doc.Save("spec.md", md);

4) PDF → 이미지 (페이지 당) 

using Aspose.Words;
using Aspose.Words.Saving;

var pdfDoc = new Document("report.pdf");
var img = new ImageSaveOptions(SaveFormat.Png) { Resolution = 200 };
for (int page = 0; page < pdfDoc.PageCount; page++)
{
    img.PageSet = new PageSet(page);
    pdfDoc.Save($"report_page_{page + 1}.png", img);
}

5) 흐름 → 스트림 (웹 / 서비스) 

using (var input = httpFile.OpenReadStream())
using (var output = new MemoryStream())
{
    var doc = new Aspose.Words.Document(input);   // auto-detects format
    doc.Save(output, SaveFormat.Pdf);
    output.Position = 0;
    return File(output.ToArray(), "application/pdf", "converted.pdf");
}

특징 및 기능성

광범위한 포맷 커버

입력 / 출력 (선택):

  • Word 가족: DOC, DOCX, DOT, RTF, WordML (XML)
  • 고정된 레이아웃 : PDF, 오트 포맷 / EPUB/)

전체 매트릭스는 Aspose.Words 기능과 일치합니다. **File Processor ** 플러그인과 이 Converter 이 모두 존재한다면 먼저 로드/ 편집하고 원하는 형식으로 수출할 수 있습니다.

자동 형식 탐지

API는 **file headers ** 또는 stream content 에서 형식을 감지하여 웹 서비스에서 자발적인 업로드를 안전하게 수락할 수 있습니다.

Fine-Tuning with 저장 옵션

  • PDF: PDF/A‐1b/2u, 암호화, 허가 깃발, 디지털 서명, 글꼴 삽입, 이미지 압축.
  • HTML/MHTML: 자원 관리 (외부 vs. 외부), CSS 모드, 암호화, 이미지 형식 & DPI.
  • 사진: DPI, 색상 깊이, 압축, 페이지 범위, 멀티 페이지 TIFF.
  • Markdown: 목록 및 제목 스타일, 테이블 일치, 링크 생성.

Layout Fidelity & 메타데이터

글꼴, 스타일, 테이블, 헤드/포터, 워터마크, 코멘트, 섹션 휴식 및 문서 속성 (작가, 제목, 사용자 지정 필드)을 보존합니다.

서버 친화적 인 처리

  • Stream-first APIs, 낮은 할당, 부퍼 I/O.
  • Async/batch 변환 및 통과를 위한 병렬화.
  • 설정할 수 있는 메모리 & 페이지 처리 범위 대형 도크.

진단 및 저항

부패 / 지원되지 않은 입력에 대한 명확한 예외; 캡처 기간, 페이지 계산 및 실패의 이유를 기록 / 텔레메트리로 이동 슬라 추적하기.

인기있는 변환 요리법

  • **DOCX → PDF/XPS ** 배포 및 아카이브 (선택적으로 PDF/A).
  • HTML → PDF 일관된 페이지를 가진 청구서, 진술 및 보고서에 대 한.
  • DOCX ↔ ODT 크로스 스위트 상호 작용을 위해.
  • DOCX → Markdown 기술 문서를 게시합니다.
  • PDF → PNG/JPEG/TIFF 프리비전 또는 템플릿을 생성합니다.
  • Word/HTML → EPUB e-book 작업 흐름.

팁: **PageSet ** 를 사용하여 특정 페이지 또는 범위를 수출하십시오. ImageSaveOptions 와 결합하여 스프리트 또는 템플릿을 사용할 수 있습니다.

모범 사례

  • License first : 평가 물표를 피하기 위해 변환 전에 측정 된 라이센스를 시작합니다.
  • 디스크 I/O를 뛰어 넘고 유연성을 줄이기 위해 서비스에서 흐름을 선호합니다.
  • 일찍 확인 : 마법 바이트를 검사하거나 건조한 부하가 빠르게 실패하려고 시도합니다.
  • **오른쪽 크기 출력 ** : 민감한 DPI를 선택하고, 필요하지 않은 경우 모든 글꼴을 삽입하는 것을 피하십시오. PDF/A 는 준수가 필요한 경우에만 선택합니다.
  • 자원 위생 : 포장 Document 그리고 흐름 속에서 using 블록에 대하여.
  • 통화 : 사용 짧은 수명 Document 요청에 따라 사례; 필요한 경우 옵션을 위해 수영장을 고용합니다.
  • 관찰 가능성 : 로그 페이지 계산, 기간 및 옵션 세트; 상호 작용 ID로 실패를 표시합니다.

FAQ

**Microsoft Office가 필요합니까?**아니, 그것은 단일 API입니다.

**파일 시스템을 만지지 않고 변환할 수 있습니까?**모든 변환은 Stream → Stream 이 될 수 있습니다.

**어떻게 PDF/A를 실행할 수 있습니까?**세트 PdfSaveOptions.Compliance = PdfCompliance.PdfA1b (또는 2U) 저축하기 전에.

**PDF 파일을 암호로 보호할 수 있나요?**예. 암호화 및 허가 깃발을 설정 PdfSaveOptions.

**마크다운 라운드 트리프 안전합니까?**테이블, 목록, 헤드, 링크 및 인라인 포맷은 튜닝 가능한 옵션으로 지원됩니다.

**어떻게 특정 페이지를 변환할 수 있습니까?**사용하기 PageSet 안에서 ImageSaveOptions 또는 FixedPageSaveOptions‑추출된 클래스.

 한국어