Word 문서를 .NET에서 로드하는 방법

1단계: 파일 또는 스트림에서 문서 로드

Document에는 다섯 개의 생성자가 있습니다. Document()은(는) 문서를 로드하지 않고 새 빈 문서를 생성합니다. Document(fileName)는 디스크상의 경로에서 직접 로드하고, Document(stream)는 읽을 수 있는 Stream에서 로드합니다 — 소스가 파일이 아닌 경우, 예를 들어 메모리에 이미 존재하는 콘텐츠나 네트워크 연결을 통해 받은 경우에 유용합니다. 두 생성자 모두 두 번째 인수인 Document(fileName, loadOptions)와 Document(stream, loadOptions)를 받는 보조 오버로드를 가지고 있으며, 이는 이 가이드의 모든 다른 작업에 대한 진입점입니다.

2단계: 비밀번호로 보호된 문서 로드

LoadOptions 를 비밀번호와 함께 생성한 뒤 Document(fileName, loadOptions) (또는 스트림 오버로드)를 호출하십시오. new LoadOptions(password) 는 LoadOptions.Password 를 직접 설정합니다; 또는 파라미터가 없는 LoadOptions() 인스턴스에 Password 를 설정한 후 전달하십시오. 비밀번호를 먼저 제공하고 나중에 로드 후 실패에 대응하는 대신 — Aspose.Words FOSS for .NET 은 보호된 파일을 파싱하려면 비밀번호가 필요하므로, 복구할 부분적으로 로드된 상태가 없습니다.

Step 3: 텍스트 및 Markdown 소스에 대한 형식별 옵션 적용

Plain-text와 Markdown 소스는 기본 LoadOptions이 노출하지 않는 설정을 허용합니다. TxtLoadOptions 은 일반 텍스트에서 번호 매기기 목록을 인식하기 위한 AutoNumberingDetection와 DetectNumberingWithWhitespaces을 추가하고, DetectHyperlinks는 순수 URL을 하이퍼링크로 변환하며, DocumentDirection (LeftToRight, RightToLeft, 또는 Auto)는 텍스트 흐름 방향을 지정하고, 각 행의 시작과 끝에서 공백을 처리하기 위한 별도 LeadingSpacesOptions/TrailingSpacesOptions (형식은 TxtLeadingSpacesOptions/TxtTrailingSpacesOptions)을 제공합니다. MarkdownLoadOptions 은 Markdown의 줄바꿈 규칙이 단락 및 연속 구간에 매핑되는 방식을 제어하기 위해 PreserveEmptyLines, ImportUnderlineFormatting, SoftLineBreakCharacter을 추가합니다. 두 서브클래스는 LoadOptions을 상속하므로, 둘 중 하나에 설정된 비밀번호 또는 리소스 로딩 콜백은 기본 클래스와 동일하게 동작합니다 — Document(fileName, loadOptions)에 형식별 인스턴스를 평범한 LoadOptions와 같이 전달하십시오.

Step 4: 로딩 중 외부 리소스를 리다이렉트하거나 가로채기

LoadOptions.ResourceLoadingCallback을 IResourceLoadingCallback 구현체로 설정하면 로딩 중 문서가 참조하는 외부 리소스가 어떻게 해결되는지 제어할 수 있습니다. 해당 구현체의 ResourceLoading(args) 메서드는 리소스의 ResourceType (Image, Font, CssStyleSheet, 또는 Document)를 설명하는 ResourceLoadingArgs와 Uri, OriginalUri을 받아들여, ResourceLoadingAction을 반환합니다 — Default은 리소스를 정상적으로 로드하고, Skip은 이를 생략하며, UserProvided는 ResourceLoadingArgs.SetData(data)를 통해 제공된 데이터를 대체합니다.

Step 5: 언어 기본값 및 복구 동작 설정

문서의 언어 메타데이터가 없거나 신뢰할 수 없을 경우, 로드하기 전에 LoadOptions.LanguagePreferences.DefaultEditingLanguage을 EditingLanguage 값으로 설정하고, LanguagePreferences에 AddEditingLanguage(language) 또는 AddEditingLanguages(languages)을 사용하여 문서에 포함될 수 있는 추가 언어를 등록하십시오. 형식이 잘못될 수 있는 소스의 경우, LoadOptions.RecoveryMode를 DocumentRecoveryMode 값으로 설정합니다 — None은 복구 시도 없이 로드하고, TryRecover은 로더가 일부 구조적 문제를 우회하도록 하여 로드 실패를 방지합니다.