Aspose.Words FOSS for .NET에 대한 사용 사례

Aspose.Words FOSS for .NET는 Microsoft Word가 설치되지 않은 상태에서 Word 문서를 생성, 편집 및 변환할 수 있는 순수-C# 라이브러리입니다. 아래 사용 사례는 이 오픈소스 에디션이 실제로 지원하는 내용을 반영하며, 이를 기반으로 Document and DocumentBuilder. 페이지 레이아웃, 렌더링, PDF/이미지 내보내기를 포함하지 않으며, 다음 FAQ and Troubleshooting 페이지에서 이 에디션이 제외하는 전체 목록을 확인할 수 있습니다.

서버 측 문서 생성

Office 설치 및 COM 자동화 없이 실행 중인 서비스에서 보고서, 편지 및 계약서를 생성합니다 — Docker 컨테이너나 클라우드 함수에 자연스럽게 어울립니다. Document을(를) 구성하고 DocumentBuilder으로 구동한 뒤 결과를 저장합니다:

using Aspose.Words;

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

builder.Writeln("Hello, Aspose.Words FOSS!");

doc.Save("output.docx");

이 라이브러리는 네이티브 종속성이 없는 .NET Standard 2.0을 목표로 하기 때문에, 동일한 코드를 수정 없이 Windows, Linux, macOS 호스트에서 실행할 수 있습니다.

템플릿 기반 문서 자동화

기존 DOCX 템플릿을 열고, 빌더의 커서를 지정된 북마크로 이동시킨 다음 해당 위치에 새 내용을 작성합니다 — 고정 레이아웃에서 계약서, 편지 또는 청구서를 채우는 일반적인 패턴입니다:

using Aspose.Words;

Document doc = new Document("template.docx");
DocumentBuilder builder = new DocumentBuilder(doc);

builder.MoveToBookmark("CustomerName");
builder.Write("Acme Corp");

doc.Save("output.docx");

DocumentBuilder은(는) 템플릿의 다른 부분을 대상으로 하는 MoveToSection(), MoveToParagraph(), MoveToStructuredDocumentTag()을(를) 제공하며, 여러 소스 문서에서 가져온 내용을 단일 출력 파일로 결합하기 위해 Document.AppendDocument() / NodeImporter도 제공합니다.

DOCX 변형, 마크다운 및 일반 텍스트 간 형식 변환

지원되는 형식 중 하나로 문서를 로드하고 다른 형식으로 저장합니다 — DOCX, DOCM, DOTX, DOTM 및 Flat OPC는 모두 동일한 OOXML 리더/라이터를 공유하며, 마크다운과 일반 텍스트도 양방향으로 지원됩니다:

using Aspose.Words;

Document doc = new Document("report.docx");
doc.Save("report.md");

같은 패턴을 반대로도 사용할 수 있습니다 — .md 파일을 로드하고 .docx 로 저장합니다 — 이는 마크다운으로 작성된 문서를 배포 가능한 Word 파일로 변환하거나, DOCX 콘텐츠를 마크다운 기반 정적 사이트 파이프라인에 공급할 때 유용합니다.

검색 및 색인을 위한 텍스트 추출

문서에서 일반 텍스트 콘텐츠를 추출하여 검색 인덱스, 텍스트 분석 파이프라인, 혹은 빠른 콘텐츠 미리보기에 사용합니다. Word에서 파일을 렌더링하거나 열 필요가 없습니다:

using Aspose.Words;

Document doc = new Document("contract.docx");
string text = doc.GetText();

GetText()은 Document와 개별 노드(CompositeNode.GetText(), Node.GetText(), Row.GetText() 등)에서도 사용할 수 있으므로 전체 문서 또는 특정 부분에서 텍스트를 추출할 수 있습니다.

배치 문서 처리

단일 스크립트에서 파일 디렉터리 전체에 동일한 로드-수정-저장 순서를 적용합니다 — 예를 들어, DOCX 파일 전체 폴더를 마크다운으로 변환하는 경우:

using Aspose.Words;
using System.IO;

foreach (string path in Directory.GetFiles("incoming", "*.docx"))
{
    Document doc = new Document(path);
    doc.Save(Path.ChangeExtension(path, ".md"));
}

각 파일은 독립적으로 로드되고 변환되며 저장되므로, 동일한 루프를 모든 지원되는 소스 및 대상 형식 조합에 적용할 수 있습니다.