Word 문서를 .NET에서 내보내고 저장하는 방법

Word 문서를 .NET에서 내보내고 저장하는 방법

이 가이드는 Aspose.Words FOSS for .NET를 사용하여 Word 문서를 내보내고 저장하는 방법을 보여줍니다: 추론된 형식 또는 명시적 형식으로 저장, OOXML 저장 옵션 구성, Markdown으로 내보내기, 일반 텍스트로 내보내기, 변환하기 전에 파일 형식 감지. Aspose.Words FOSS for .NET는 NuGet를 통해 또는 소스에서 빌드하여 사용할 수 있습니다.

단계별 가이드

1단계: 라이브러리 가져오기

레포지토리를 복제하고 빌드합니다 Aspose.Words.sln Release 구성으로 빌드한 후, 프로젝트 참조를 추가합니다 Aspose.Words.csproj 귀하의 .NET 프로젝트에서, 다음에 설명된 대로 설치 가이드. 추가 using Aspose.Words; 문서를 저장하는 모든 파일의 상단에.


2단계: 추론된 형식 또는 명시적 형식으로 저장

Document.Save(fileName)는 파일 확장자에서 대상 형식을 추론합니다. Save(fileName, saveFormat)은 SaveFormat 열거형 값을 받아 확장자와 관계없이 형식을 명시적으로 지정합니다. 그리고 Save(fileName, saveOptions)(또는 일치하는 Stream 오버로드)는 형식별 제어를 위해 SaveOptions 서브클래스를 사용합니다. SaveOptions.CreateSaveOptions(saveFormat)은 정적 팩토리로, 주어진 SaveFormat에 대해 기본값이 이미 설정된 일치하는 옵션 서브클래스를 반환합니다. 이 버전은 DOCX, DOCM, DOTX, DOTM 및 Flat OPC(매크로 지원 및 템플릿 변형 포함)를 비롯해 Markdown 및 일반 텍스트로의 양방향 저장을 완전하게 지원합니다.


3단계: OOXML 내보내기 옵션 구성

OoxmlSaveOptions은(는) Open XML 변형 중 어느 것이든 저장하도록 구성합니다. 해당 SaveFormat 속성은 DOCX, DOCM, DOTX, DOTM 또는 Flat OPC를 구체적으로 선택합니다; Password는 저장 파일에 열 암호를 설정하며, 이는 Document.Protect의 편집 제한과는 무관합니다; Compliance는 OOXML 엄격성 수준을 선택하고; CompressionLevel / Zip64Mode는 기본 ZIP 패키징을 제어합니다. new OoxmlSaveOptions(saveFormat)을(를) 사용하거나 SaveOptions.CreateSaveOptions(saveFormat)을(를) 통해 하나를 생성하십시오.


4단계: Markdown으로 내보내기

MarkdownSaveOptions은(는) Markdown 내보내기를 제어합니다: ListExportMode과 LinkExportMode는 목록과 하이퍼링크가 어떻게 렌더링되는지를 관리하고, ImagesFolder / ImagesFolderAlias는 추출된 이미지가 어디에 저장되고 어떻게 참조되는지를 제어하며, ExportImagesAsBase64는 별도 파일을 쓰는 대신 인라인으로 삽입하고, TableContentAlignment은 생성된 표 마크업에 영향을 줍니다. MarkdownSaveOptions 인스턴스를 Document.Save(fileName, saveOptions)에 .md 파일 이름과 함께 전달하거나, 그 SaveFormat을 명시적으로 설정하십시오.


5단계: 일반 텍스트로 내보내기

TxtSaveOptions (공유 기반 TxtSaveOptionsBase을 통해, MarkdownSaveOptions에서도 사용됨) 은 일반 텍스트 내보내기를 제어합니다: Encoding은 문자 인코딩을 설정하고, ParagraphBreak는 줄 끝 문자열을 지정하며, MaxCharactersPerLine는 긴 줄을 자동으로 줄 바꿈하고, SimplifyListLabels은 목록 글머리표와 번호를 일반 문자로 정규화하며, PreserveTableLayout은 공백을 사용해 표 열을 정렬된 상태로 유지합니다.


6단계: 변환하기 전에 형식 감지

알 수 없는 형식의 파일을 변환하기 전에, FileFormatUtil.DetectFileFormat(fileName)은 감지된 LoadFormat를 포함한 FileFormatInfo을 반환합니다. FileFormatUtil.LoadFormatToSaveFormat(loadFormat)과 함께 사용하여 해당 형식이 이 에디션이 지원하는 형식들을 통해 라운드트립이 가능한지 확인한 후 Document.Save를 호출하십시오. 일부 SaveFormat 열거형 멤버는 API 완전성을 위해 존재하지만, 이 축소된 오픈소스 에디션은 해당 형식에 대한 작동 가능한 리더나 라이터를 구현하지 않습니다; 신뢰할 수 있는 출력을 위해 DOCX/DOCM/DOTX/DOTM/Flat OPC 계열과 Markdown 및 일반 텍스트만 사용하십시오.

일반적인 문제와 해결 방법

Save(fileName) 잘못된 형식으로 기록합니다. 파일 확장자가 의도한 형식과 일치하지 않습니다. 사용 Save(fileName, saveFormat) or Save(fileName, saveOptions) 형식을 명시적으로 지정하려면 확장자에 의존하지 마십시오.

저장된 OOXML 파일은 비밀번호로 열 수 없습니다. OoxmlSaveOptions.Password 저장하기 전에 설정되지 않았습니다. 구성하십시오. OoxmlSaveOptions, 설정 Password, 그리고 전달하십시오 Save.

Markdown 내보내기가 이미지 파일을 예상치 않게 흩뜨립니다. Default MarkdownSaveOptions 동작이 이미지를 별도 파일로 추출합니다. 설정 ExportImagesAsBase64 = true 하나의 자체 포함된 Markdown 파일을 위해, 또는 설정 ImagesFolder 이미지를 배치하는 위치를 제어하려면.

텍스트만 내보내면 테이블 열 정렬이 손실됩니다. TxtSaveOptions.PreserveTableLayout 기본값으로 남겨져 있습니다. 설정 PreserveTableLayout = true 저장하기 전에.

자주 묻는 질문

파일 확장자와 관계없이 특정 형식으로 저장하려면 어떻게 해야 하나요?

명시적인 SaveFormat 값을 사용하여 Save(fileName, saveFormat)를 호출하거나, 일치하는 SaveOptions 서브클래스를 사용하여 Save(fileName, saveOptions)를 호출합니다.

이 버전에서 양방향 라운드트립이 가능한 포맷은 무엇인가요?

DOCX, DOCM, DOTX, DOTM, Flat OPC(매크로 사용 가능 및 템플릿 변형 포함), Markdown, 그리고 일반 텍스트.

저장된 파일을 열조차 할 수 없도록 비밀번호로 보호하려면 어떻게 해야 하나요?

OoxmlSaveOptions 인스턴스에 Password를 설정하고 이를 Document.Save(fileName, saveOptions)에 전달합니다.

내보낸 텍스트 파일에서 줄 끝 문자를 어떻게 제어하나요?

저장하기 전에 TxtSaveOptions 인스턴스에 ParagraphBreak를 설정합니다.

파일을 변환하기 전에 파일 형식을 어떻게 확인하나요?

FileFormatUtil.DetectFileFormat(fileName)를 호출하고 반환된 FileFormatInfo.LoadFormat을 읽으세요.

참조

 한국어