빌드 및 설치 문제

`dotnet add package Aspose.Words` 패키지를 찾을 수 없습니다

해당 명령은 상용 Aspose.Words 패키지를 가리키며, FOSS 버전이 아닙니다 — FOSS 패키지 ID는 Aspose.Words.FOSS입니다:

dotnet add package Aspose.Words.FOSS

또는 git clone을 실행하여 소스를 가져온 다음, 복제된 폴더에 cd하고 솔루션에 대해 dotnet build을 실행하십시오:

git clone https://github.com/aspose-words-foss/Aspose.Words-FOSS-for-.NET.git
cd Aspose.Words-FOSS-for-.NET
dotnet build Aspose.Words.sln -c Release

그런 다음 패키지 참조 대신 자체 애플리케이션에서 Aspose.Words.csproj에 대한 프로젝트 참조를 추가하십시오.

프로젝트 참조가 복제 후 해결되지 않습니다.

복제된 Aspose.Words-FOSS-for-.NET/Aspose.Words/ 폴더 안의 Aspose.Words.csproj을 가리키는지 확인하고, 먼저 솔루션이 성공적으로 빌드되었는지 (dotnet build Aspose.Words.sln -c Release) 확인하십시오. 라이브러리는 .NET Standard 2.0을 대상으로 하므로, .NET Framework 4.6.2+ 또는 .NET 6/8/10을 대상으로 하는 모든 SDK가 이를 참조할 수 있습니다.

로드 문제

문서를 로드할 때 `UnsupportedFileFormatException`

UnsupportedFileFormatException는 파일 형식이 인식되지 않거나 이 에디션에서 지원되지 않을 때 로드 중에 발생합니다. 이 에디션이 지원하는 로드 형식은 DOCX, DOCM, DOTX, DOTM, Flat OPC, Markdown, 그리고 일반 텍스트이며 — input.doc와 같은 지원되지 않는 경로를 Document 생성자에 전달하면 로드된 문서를 반환하는 대신 이 예외가 발생합니다:

using Aspose.Words;

try
{
    Document doc = new Document("input.doc");
}
catch (UnsupportedFileFormatException ex)
{
    Console.WriteLine("Format not supported by this edition: " + ex.Message);
}

Document 생성자 주변에서 UnsupportedFileFormatException를 잡으면 예외가 원시 스택 트레이스로 전파되는 대신 명확한 메시지를 보고할 수 있습니다.

유효해 보이는 파일에 대한 `FileCorruptedException`

FileCorruptedException은(는) 파일이 손상된 것으로 보이고 파싱할 수 없을 때 로드 중에 발생합니다 — 예를 들어, 유효한 ZIP 기반 OOXML 패키지가 아닌 .docx 파일이거나 전송 중에 잘린 파일입니다. 파일을 원본에서 다시 받아서 Document로 로드하기 전에 정상적으로 열리는지 확인하십시오.

보호된 문서를 열 때 `IncorrectPasswordException`

문서가 비밀번호로 암호화되어 있고 Document 생성자의 LoadOptions 오버로드에 제공된 비밀번호가 없거나 올바르지 않을 때 발생합니다. 로드하기 전에 LoadOptions.Password를 통해 올바른 비밀번호를 제공하십시오.

저장 및 내보내기 문제

PDF, XPS 또는 이미지 형식으로 `Document.Save()`에 실패합니다

이 에디션에는 페이지 레이아웃 및 렌더링 서브시스템이 포함되어 있지 않으므로 Document.Save()은(는) PDF, XPS 또는 이미지 형식으로 내보낼 수 없습니다.

DOCX, DOCM, DOTX, DOTM, Flat OPC, Markdown 또는 일반 텍스트로 저장하십시오 — 이것이 이 버전이 실제로 쓰는 형식입니다. 상업용 Aspose.Words for .NET PDF, XPS 및 이미지 출력 기능을 추가합니다.

페이지 번호와 목차 항목이 항상 0으로 표시됩니다

Aspose.Words FOSS for .NET은 전체 필드 평가 엔진을 포함하고 있어 DATE 및 DOCPROPERTY와 같은 콘텐츠 필드가 올바르게 업데이트됩니다. 페이지 레이아웃에 의존하는 필드—페이지 번호, NUMPAGES, 그리고 TOC 항목—는 계산된 값 대신 자리표시자 0로 평가됩니다. 이는 해당 판에 일반적으로 문서를 페이지 매김하는 레이아웃 엔진이 포함되지 않았기 때문이며, 이 판에서 기대되는 동작이며 버그가 아닙니다.

Digital Signature Issues → 디지털 서명 문제

Signing a document has no effect → 문서에 서명해도 효과가 없습니다.

DigitalSignatureUtil.Sign() 및 관련 서명 API는 상용 제품과 구조적인 호환성을 위해 객체 모델에 존재하지만, 이 FOSS 에디션에서는 새로운 서명을 생성할 수 없습니다 — 이를 호출해도 서명된 출력이 생성되지 않습니다. 이 에디션은 Document.DigitalSignatures 및 DigitalSignatureUtil.LoadSignatures()를 통해 문서에 이미 첨부된 서명을 검사하고 검증할 수 있지만, 서명 워크플로는 .NET을 위해 상용 Aspose.Words이 필요합니다.

Font Issues → 폰트 문제

Embedded fonts are larger than expected → 임베드된 폰트가 예상보다 큽니다.

EmbedTrueTypeFonts이(가) 활성화되면, 폰트가 문서에서 실제로 사용된 글리프만을 서브셋팅하는 것이 아니라 전체 파일로 임베드됩니다. 따라서 폰트를 임베드한 저장 파일은 상용 제품의 동등한 출력보다 더 큽니다. 이 에디션에서는 해결 방법이 없습니다 — 임베드된 폰트 서브셋팅이 포함되어 있지 않습니다.

문제 해결 Aspose.Words FOSS for .NET