.NET에서 문서 설정을 사용하는 방법

이 가이드는 Aspose.Words FOSS for .NET에서 애플리케이션 수준 문서 설정을 사용하는 방법을 보여줍니다: 레거시 호환 스위치, 하이픈 설정, 저장된 메일 병합 구성, 보기 옵션 및 쓰기 보호. Aspose.Words FOSS for .NET은 NuGet을 통해 또는 소스에서 직접 빌드하여 사용할 수 있습니다.

단계별 가이드

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

저장소를 복제하고 빌드합니다 Aspose.Words.sln Release 구성으로 빌드한 뒤, 프로젝트 참조를 추가합니다 Aspose.Words.csproj 자신의 .NET 프로젝트에서, 다음에 설명된 대로 설치 가이드. 추가 using Aspose.Words; and using Aspose.Words.Settings; 문서 설정을 읽거나 쓰는 모든 파일의 최상단에.

2단계: 레거시 호환 옵션 설정

Document.CompatibilityOptions (CompatibilityOptions 인스턴스)는 특정 구버전 Word 레이아웃 및 간격 동작을 재현하는 수십 개의 부울 스위치를 포함하고 있습니다 — 예를 들어 GrowAutofit, UseWord2010TableStyleRules, AdjustLineHeightInTable, AlignTablesRowByRow, NoExtraLineSpacing, SuppressSpacingAtTopOfPage, 및 SpacingInWholePoints. 필요한 개별 속성을 직접 설정하십시오; OptimizeFor(MsWordVersion)는 클래스에 존재하지만 이 빌드에서는 NotImplementedException을 발생시키므로, 전체 버전 프로파일을 한 번에 적용하는 바로 가기는 없습니다.

3단계: 하이픈 설정 구성

Document.HyphenationOptions (HyphenationOptions 인스턴스) 은(는) 문서에 대한 Word의 하이픈 설정을 저장합니다: AutoHyphenation, ConsecutiveHyphenLimit, HyphenateCaps, 및 HyphenationZone. 이러한 속성은 저장된 파일에서 요청을 라운드 트립합니다; 이 버전에는 페이지 레이아웃 엔진이 없기 때문에 하이픈 구분은 파일을 열고 페이지 매김할 때 Word에 의해 계산되며, Aspose.Words FOSS에 의해 계산되지 않습니다.

4단계: 메일 병합 설정 읽기 및 쓰기

Document.MailMergeSettings (MailMergeSettings 인스턴스) 은(는) 문서에 기록된 메일 병합 구성을 저장합니다 — MainDocumentType, CheckErrors, Destination, DataSource, DataType, Query, ConnectString, MailSubject, MailAsAttachment, ActiveRecord, 및 ViewMergedData — 그리고 Clear() 및 Clone(). Word의 Office Data Source Object 메커니즘을 통해 연결된 외부 데이터 소스의 경우, MailMergeSettings.Odso 은(는) Odso 인스턴스(DataSource, DataSourceType, TableName, ColumnDelimiter, FirstRowContainsColumnNames) 를 노출하며, 해당 인스턴스의 FieldMapDatas 및 RecipientDatas 컬렉션은 필드 매핑과 수신자 목록을 설명합니다. 이 저장된 구성을 읽고 쓰는 기능은 이 오픈소스 에디션에서 제공됩니다; 실시간 데이터 소스에 대해 병합을 실행하는 것은 이 페이지 범위 밖의 별도 문제입니다.

5단계: 문서 보기 설정 구성

Document.ViewOptions (ViewOptions 인스턴스) 은(는) 파일이 열렸을 때 Word가 파일을 표시하는 방식을 제어합니다: ViewType, ZoomType, ZoomPercent, DisplayBackgroundShape, DoNotDisplayPageBoundaries, 및 FormsDesign. 이러한 속성은 저장된 기본 설정으로, 문서의 Word 자체 표시 방식에만 영향을 미치며 — Aspose.Words FOSS가 이를 처리하는 방식에는 영향을 주지 않습니다.

6단계: 쓰기 보호 적용

Document.WriteProtection (WriteProtection 인스턴스) 은(는) IsWriteProtected 및 ReadOnlyRecommended 를 노출하며, SetPassword() 로 보호 암호를 설정하고 ValidatePassword() 로 후보 암호를 확인합니다. IsWriteProtected = true 을 설정하기 전에 SetPassword() 을 호출하고, 원시 암호 문자열을 직접 저장하거나 비교하는 대신 ValidatePassword() 을 사용하십시오.

일반적인 문제 및 해결 방법

CompatibilityOptions.OptimizeFor() throws NotImplementedException. 이 메서드는 현재 빌드에 구현되어 있지 않습니다. 개별 CompatibilityOptions 필요한 불리언 속성을 직접 설정하십시오.

Changing ViewOptions.ZoomPercent 생성된 출력에 눈에 보이는 영향을 주지 않습니다. ViewOptions Word에서 읽어들이는 저장된 표시 환경 설정이며, Aspose.Words FOSS 자체가 처리 중에 적용하는 것이 아닙니다. 수정이 필요하지 않으며—이는 예상된 동작입니다.

WriteProtection.ValidatePassword() 예상치 않게 반환됩니다. false. SetPassword() 한 번도 호출되지 않았거나, 다른 비밀번호가 설정되었습니다. 호출하십시오. SetPassword() 유효성 검사를 수행하기 전에 보호된 비밀번호를 설정하려면 먼저 실행하십시오.

메일 병합 구성이 저장되었지만 병합이 실행되지 않습니다. MailMergeSettings and Odso 병합 구성을 저장만 합니다; 이 오픈소스 에디션은 병합 자체를 실행하지 않습니다. 저장된 구성을 읽어 자체 필드 채우기 로직을 적용하십시오.

자주 묻는 질문

`CompatibilityOptions.OptimizeFor()`가 작동합니까?

아니요 — 이 빌드에서는 NotImplementedException이(가) 발생합니다. 필요한 개별 CompatibilityOptions 속성을 직접 설정하세요.

문서를 편집으로부터 비밀번호로 보호하려면 어떻게 해야 하나요?

Document.WriteProtection에 대해 WriteProtection.SetPassword()을(를) 호출한 다음, 보호를 활성화하려면 IsWriteProtected를 설정하세요.

`HyphenationOptions`와 `ViewOptions`은(는) Aspose.Words FOSS가 문서를 처리할 때 문서 모양을 변경합니까?

아니요. 두 항목 모두 Word가 파일을 열고 표시할 때 적용하는 저장된 기본 설정이며, 이 버전에는 이를 직접 처리할 페이지 레이아웃 엔진이 없습니다.

외부 데이터 소스에 대한 메일 병합 데이터 소스 구성을 어디에서 찾을 수 있나요?

MailMergeSettings.Odso — 해당 FieldMapDatas 및 RecipientDatas 컬렉션은 열 매핑과 수신자 포함 상태를 설명합니다.

`Document.CompatibilityOptions`와 `Document.ViewOptions`의 차이점은 무엇인가요?

CompatibilityOptions 스위치는 오래된 Word 레이아웃 및 간격 특성을 재현합니다; ViewOptions은 Word 자체 인터페이스가 파일을 표시하는 방식을 제어합니다(확대/축소, 서식 표시). 둘 다 Aspose.Words FOSS 자체에 의해 계산되지 않습니다.