GroupDocs.Editor for .NET을 사용하여 일반 텍스트 문서 편집

소개

만약 plain text를 빠르고 신뢰성 있게 .NET 애플리케이션에서 편집해야 한다면, GroupDocs.Editor for .NET이 무거운 작업을 대신해 줍니다. 이 API는 30개 이상의 문서 형식을 지원하고, 최대 500 MB 파일을 처리할 수 있으며, 전체 파일을 메모리에 로드하지 않고도 텍스트를 조작할 수 있습니다. 이 튜토리얼에서는 txt 파일을 로드하고, 끝 공백을 제거하며, 앞쪽 공백을 변환하고, 올바른 인코딩을 설정한 뒤, 편집된 내용을 디스크에 다시 저장하는 방법을 배웁니다. 직접 해볼 준비가 되셨나요? 바로 시작해 봅시다!

빠른 답변

  • txt 파일을 편집하기 위한 첫 번째 단계는 무엇인가요? Editor를 사용해 파일을 경로 또는 스트림으로 로드합니다.
  • 편집 중에 파일 인코딩을 변경할 수 있나요? 예 – TxtSaveOptions를 사용하면 UTF‑8, UTF‑16 또는 사용자 정의 인코딩을 지정할 수 있습니다.
  • 각 줄 끝의 여분 공백을 어떻게 제거하나요? 텍스트를 가져와 각 줄에 TrimEnd()를 호출하고 다시 씁니다.
  • GroupDocs.Editor를 무료로 체험할 수 있나요? 릴리스 페이지에서 30일 완전 기능 체험판을 사용할 수 있습니다.
  • 지원되는 .NET 버전은 무엇인가요? .NET Framework 4.6+, .NET Core 3.1+, 및 .NET 5/6/7.

plain text 편집이란?

Edit plain text는 간단한 .txt 파일 내부의 문자를 프로그래밍 방식으로 변경하는 것을 의미합니다—텍스트를 추가, 삭제 또는 재포맷하면서 파일의 원래 인코딩 및 줄 바꿈 방식을 유지합니다. 여기에는 공백 제거, 줄 바꿈 정규화, 구성 값 업데이트, 생성된 콘텐츠 삽입 등이 포함될 수 있습니다. 이 작업은 파일이 표준 텍스트 편집기에서 읽을 수 있도록 유지하고, BOM 마커와 같은 기존 메타데이터를 보존해야 합니다.

plain‑text 편집에 GroupDocs.Editor를 사용하는 이유

GroupDocs.Editor는 스트리밍 방식으로 파일을 처리하므로, 300 MB 로그 파일도 50 MB 이하의 RAM으로 편집할 수 있습니다. 이 라이브러리는 50개 이상의 입력 및 출력 형식을 지원하고, 줄 바꿈 스타일(CR, LF, CRLF)을 자동으로 감지하며, 사용자 정의 파서를 작성하지 않고도 끝 공백 제거와 앞쪽 공백 변환을 위한 내장 옵션을 제공합니다.

사전 요구 사항

  • .NET 개발 환경 – Visual Studio 2022 또는 C# 확장 기능이 포함된 VS Code.
  • GroupDocs.Editor for .NET – GroupDocs.Editor for .NET 릴리스 페이지에서 다운로드하십시오.
  • 기본 C# 지식 – 파일 I/O 및 문자열 조작에 익숙해야 합니다.
  • 텍스트 편집기 (선택 사항) – 소스 파일을 검사하기 위해; VS Code를 권장합니다.
  • 자세한 사용법은 documentation을 참조하십시오.
  • 또한 일반 releases page를 탐색할 수 있습니다.

plain text를 단계별로 편집하는 방법

파일을 로드하고, 내용을 편집한 뒤 다시 저장합니다—코드 10줄 이하로 가능합니다. 다음 섹션에서는 각 단계를 명확히 설명합니다.

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

먼저 물리적인 파일 경로나 메모리 스트림 중 어떤 것을 사용할지 결정합니다. 경로를 사용하는 것이 로컬 개발에서 가장 간단한 방법입니다.

using System.Collections.Generic;
using System.IO;
using GroupDocs.Editor.Formats;
using GroupDocs.Editor.HtmlCss.Resources;
using GroupDocs.Editor.Options;

단계 2: Editor 인스턴스 생성

Editor는 문서를 로드하고 편집 기능을 제공하는 주요 클래스입니다.

string inputFilePath = "YourSampleDocument.txt";

단계 3: TXT 편집 옵션 생성

TxtEditOptions는 plain‑text 파일이 어떻게 구문 분석되고 편집되는지를 구성하며, 인코딩 및 공백 처리 규칙을 설정할 수 있게 합니다.

using (Editor editor = new Editor(inputFilePath))
{

단계 4: EditableDocument 인스턴스 생성

EditableDocument는 로드된 문서의 메모리 내 버전을 나타내며, 텍스트와 관련된 모든 리소스를 포함합니다.

    TextEditOptions editOptions = new TextEditOptions
    {
        Encoding = System.Text.Encoding.UTF8,
        RecognizeLists = true,
        LeadingSpaces = TextLeadingSpacesOptions.ConvertToIndent,
        TrailingSpaces = TextTrailingSpacesOptions.Trim
    };

단계 5: 문서 내용 편집

원본 텍스트를 가져와 필요한 문자열 작업(예: 교체, 트림, 대소문자 변환)을 적용하고, 결과를 EditableDocument에 다시 저장합니다.

    EditableDocument beforeEdit = editor.Edit(editOptions);

단계 6: 업데이트된 내용으로 EditableDocument 생성

텍스트를 변환한 후, 편집된 문자열과 원본 리소스 컬렉션을 포함하는 새로운 EditableDocument를 인스턴스화합니다.

    string originalTextContent = beforeEdit.GetContent();
    string updatedTextContent = originalTextContent.Replace("text", "EDITED text");
    List<IHtmlResource> allResources = beforeEdit.AllResources;

단계 7: WordProcessing 저장 옵션 생성

WordProcessingSaveOptions는 DOCX 또는 DOCM과 같은 Word 호환 형식으로 문서를 저장하기 위한 설정을 정의합니다.

    EditableDocument afterEdit = EditableDocument.FromMarkup(updatedTextContent, allResources);

단계 8: TXT 저장 옵션 생성

TxtSaveOptions는 편집된 plain‑text 파일을 어떻게 기록할지 지정하며, 인코딩, 줄 바꿈 보존 및 테이블 레이아웃 처리를 포함합니다.

    WordProcessingSaveOptions wordSaveOptions = new WordProcessingSaveOptions(WordProcessingFormats.Docm)
    {
        Locale = System.Globalization.CultureInfo.GetCultureInfo("en-GB")
    };

단계 9: 출력 경로 준비

입력 파일 경로에서 출력 디렉터리를 도출한 뒤, DOCX와 TXT 결과물의 전체 파일명을 구성합니다.

    TextSaveOptions txtSaveOptions = new TextSaveOptions
    {
        Encoding = System.Text.Encoding.UTF8,
        PreserveTableLayout = true
    };

단계 10: 편집된 문서 저장

마지막으로 editor.Save를 두 번 호출합니다—WordProcessing 옵션으로 한 번, TXT 옵션으로 한 번—단일 작업으로 두 형식을 모두 생성합니다.

    string outputWordPath = Path.Combine(Path.GetDirectoryName(inputFilePath), Path.GetFileNameWithoutExtension(inputFilePath) + ".docm");
    string outputTxtPath = Path.Combine(Path.GetDirectoryName(inputFilePath), Path.GetFileNameWithoutExtension(inputFilePath) + ".txt");

일반적인 문제 및 해결책

  • 편집 후에도 끝 공백이 남아 있습니다 – 문서를 로드하기 전에 TxtEditOptions.TrimTrailingSpaces가 true로 설정되어 있는지 확인하십시오.
  • 저장된 파일의 인코딩이 올바르지 않음 – TxtSaveOptions.Encoding이 원하는 코드 페이지(예: Encoding.UTF8)와 일치하는지 확인하십시오.
  • 대용량 파일에서 OutOfMemoryException 발생 – 파일 경로에서 로드하는 대신 스트리밍 API(Editor.Load(Stream))를 사용하여 메모리 사용량을 낮추십시오.

자주 묻는 질문

Q: GroupDocs.Editor for .NET이 지원하는 파일 형식은 무엇인가요?
A: 이 라이브러리는 DOCX, TXT, HTML, PDF, markdown 등을 포함한 50개 이상의 형식을 지원하며, 이를 자유롭게 편집하고 변환할 수 있습니다.

Q: GroupDocs.Editor for .NET의 무료 체험판을 어떻게 받을 수 있나요?
A: releases page에서 체험판을 다운로드하십시오.

Q: 테스트용 임시 라이선스를 구매할 수 있나요?
A: 예, 임시 라이선스는 GroupDocs purchase page에서 제공됩니다.

Q: 문제가 발생했을 때 어디에서 지원을 받을 수 있나요?
A: 공식 지원 포럼이 가장 좋은 곳입니다 – GroupDocs.Editor support forum을 방문하십시오.

Q: 고급 시나리오에 대한 자세한 문서가 있나요?
A: 물론입니다. 전체 참고 자료는 GroupDocs.Editor documentation page에 있습니다.

결론

이제 GroupDocs.Editor for .NET을 사용하여 plain text 파일을 편집하는 방법—txt 파일 로드, 공백 트림, 앞쪽 공백 변환, 적절한 인코딩 설정, 그리고 결과를 TXT와 DOCX 형식 모두로 저장하는 방법—을 마스터했습니다. 이 기능을 통해 로그 파일 정리 자동화, 구성 파일 실시간 생성, 맞춤형 텍스트 처리 파이프라인 구축 등을 휠을 다시 만들지 않고 수행할 수 있습니다. 공식 문서를 방문하여 배치 처리 및 문서 변환과 같은 추가 기능을 살펴보세요.

마지막 업데이트: 2026-08-10
테스트 대상: GroupDocs.Editor 23.11 for .NET
작성자: GroupDocs

    editor.Save(afterEdit, outputWordPath, wordSaveOptions);
    editor.Save(afterEdit, outputTxtPath, txtSaveOptions);
}
System.Console.WriteLine("Document editing process completed successfully!");

관련 튜토리얼