GroupDocs.Editor for .NET으로 워드 문서 프로그래밍 편집

만약 여러분이 .NET 개발자이며 프로그램적으로 워드 문서를 편집 파일을 필요로 한다면—텍스트를 교체하거나 형식을 변환하거나 결과를 스트림에 삽입하든—GroupDocs.Editor for .NET은 강력하고 사용하기 쉬운 라이브러리로 작업을 수행합니다. 이 튜토리얼에서는 DOCX 파일을 로드하고, 내용을 편집하며, 결과를 RTF로 변환하고, 디스크 또는 메모리 스트림에 저장하는 실제 예제를 단계별로 살펴보겠습니다.

빠른 답변

무엇을 편집할 수 있나요? Word, PDF, HTML, RTF 및 기타 많은 형식.
텍스트를 교체할 수 있나요? 예 – 간단한 문자열 교체 또는 더 고급 DOM 조작을 사용하세요.
PDF를 편집 가능한 형태로 변환하려면 어떻게 하나요? Editor로 PDF를 로드하고 생성된 HTML을 편집합니다.
스트림에 저장하는 가장 쉬운 방법은? editor.Save(editableDoc, stream, options)를 사용합니다.
라이선스가 필요합니까? 프로덕션 사용을 위해 임시 또는 정식 라이선스가 필요합니다.

프로그램적으로 워드 문서를 편집한다는 것은?

프로그램적으로 워드 문서를 편집한다는 것은 UI 대신 코드를 사용하여 파일을 열고, 내용(텍스트, 이미지, 스타일)을 변경한 뒤 수정된 버전을 저장소에 다시 쓰는 것을 의미합니다. 이 접근 방식은 자동 보고, 대량 문서 업데이트 및 맞춤형 콘텐츠 생성에 활용됩니다.

왜 GroupDocs.Editor for .NET을 사용해야 할까요?

형식 유연성: DOCX, PDF, HTML, RTF 등을 로드하고 지원되는 모든 형식으로 저장합니다.
Office 의존성 없음: 서버에 Microsoft Office가 설치되지 않아도 작동합니다.
스트림 친화적: 파일 시스템 대신 스트림을 읽고 쓰는 클라우드 시나리오에 적합합니다.
풍부한 API: 이미지, 폰트, CSS 및 기타 리소스에 접근하여 완전한 편집 기능을 제공합니다.

전제 조건

Before we dive into the implementation, make sure you have:

Visual Studio 2017 또는 그 이후 버전.
.NET Framework 4.6.1 또는 그 이후 버전.
GroupDocs.Editor for .NET – 사이트에서 download 할 수 있습니다.
유효한 라이선스 또는 GroupDocs에서 제공하는 temporary license가 필요합니다.

네임스페이스 가져오기

GroupDocs.Editor for .NET을 사용하려면 필요한 네임스페이스를 가져옵니다:

using System;
using System.IO;
using GroupDocs.Editor.Formats;
using GroupDocs.Editor.Options;

다음 섹션에서는 워크플로를 작은 단계로 나누어 쉽게 따라 할 수 있도록 하겠습니다.

단계 1: 입력 파일 경로 가져오기

편집하려는 워드 파일의 위치를 지정합니다. 이 예제에서는 Your Sample Document.docx라는 DOCX 파일을 가정합니다.

string inputFilePath = "Your Sample Document.docx";

단계 2: Editor 객체 인스턴스화

Editor 인스턴스를 입력 경로와 함께 생성합니다. 이렇게 하면 문서가 로드되고 편집 준비가 됩니다.

using (GroupDocs.Editor.Editor editor = new Editor(inputFilePath))
{
    // Subsequent steps will be nested inside this block
}

단계 3: 문서를 편집용으로 열기

EditableDocument를 얻어 문서의 HTML 표현 및 리소스에 접근할 수 있습니다.

EditableDocument beforeEdit = editor.Edit();

단계 4: 문서 내용 및 리소스 가져오기

원시 HTML, 이미지, 폰트 및 CSS를 추출할 수 있습니다. 마크업을 직접 조작해야 할 때 유용합니다.

string content = beforeEdit.GetContent();
var images = beforeEdit.Images;
var fonts = beforeEdit.Fonts;
var stylesheets = beforeEdit.Css;

단계 4.1: 문서를 단일 Base64‑인코딩 문자열로 가져오기

모든 포함된 리소스를 하나의 문자열에 담고 싶다면 GetEmbeddedHtml()을 호출합니다.

string allEmbeddedInsideString = beforeEdit.GetEmbeddedHtml();

단계 4.2: 내용 편집

간단한 텍스트 교체 예시로 Subtitle을 Edited subtitle으로 바꿔보겠습니다.

string allEmbeddedInsideStringEdited = allEmbeddedInsideString.Replace("Subtitle", "Edited subtitle");

단계 5: 새로운 EditableDocument 인스턴스 생성

마크업을 편집한 후, 이를 EditableDocument 객체로 다시 래핑합니다.

EditableDocument afterEdit = EditableDocument.FromMarkup(allEmbeddedInsideStringEdited, null);

단계 6: 편집된 문서 저장

결과를 RTF 파일로 저장하며, 파일 시스템 경로와 메모리 스트림 옵션을 모두 보여줍니다.

단계 6.1: 출력 경로 준비

RTF가 기록될 위치를 정의합니다.

string outputPath = Path.Combine("Output Directory Path", Path.GetFileNameWithoutExtension(inputFilePath) + ".rtf");

단계 6.2: 저장 옵션 준비

WordProcessingSaveOptions를 사용해 RTF 형식을 선택합니다.

Options.WordProcessingSaveOptions saveOptions = new WordProcessingSaveOptions(WordProcessingFormats.Rtf);

단계 6.3: 경로에 저장

편집된 문서를 파일 시스템에 기록합니다.

editor.Save(afterEdit, outputPath, saveOptions);

단계 6.4: 스트림에 저장

메모리 내에서 결과가 필요하면(예: 클라우드 스토리지에 업로드) MemoryStream을 사용합니다.

using (MemoryStream ms = new MemoryStream())
{
    editor.Save(afterEdit, ms, saveOptions);
}

단계 7: Editor 및 EditableDocument 인스턴스 해제

메모리 누수를 방지하기 위해 리소스를 즉시 해제합니다.

beforeEdit.Dispose();
afterEdit.Dispose();
editor.Dispose();

일반 사용 사례 및 팁

PDF를 편집 가능한 형태로 변환: Editor로 PDF를 로드하고, 생성된 HTML을 편집한 뒤 PDF 또는 다른 형식으로 저장합니다.
문서 내 텍스트 교체: 간단한 경우 string.Replace를 사용하고, 복잡한 시나리오에서는 DOM을 조작합니다.
워드를 RTF로 변환: 위와 같이 저장 옵션에서 WordProcessingFormats.Rtf를 설정합니다.
문서를 스트림에 저장: 파일을 클라이언트에 직접 반환하는 웹 API에 이상적입니다.
편집을 위해 문서 로드: 항상 Editor를 using 블록으로 감싸서 적절히 해제하도록 합니다.

자주 묻는 질문

Q: GroupDocs.Editor for .NET으로 PDF 파일을 편집할 수 있나요?
A: 예, GroupDocs.Editor는 PDF를 중간 HTML 표현으로 변환하여 편집을 지원합니다.

Q: GroupDocs.Editor for .NET의 임시 라이선스는 어떻게 얻나요?
A: GroupDocs 웹사이트에서 임시 라이선스를 받을 수 있습니다.

Q: GroupDocs.Editor for .NET이 지원하는 파일 형식은 무엇인가요?
A: DOCX, PDF, HTML, RTF 및 기타 많은 형식을 지원합니다.

Q: GroupDocs.Editor를 클라우드 스토리지와 통합할 수 있나요?
A: 물론입니다 – Azure Blob, Amazon S3, Google Cloud Storage 등에서 스트림을 읽고 쓸 수 있습니다.

Q: GroupDocs.Editor for .NET 문서는 어디서 찾을 수 있나요?
A: 문서는 여기에서 확인할 수 있습니다.

마지막 업데이트: 2026-04-11
테스트 환경: GroupDocs.Editor 23.12 for .NET
작성자: GroupDocs