문서 속성 작업
문서 속성을 사용하면 문서에 대한 유용한 정보를 저장할 수 있습니다. 이러한 속성은 두 그룹으로 나눌 수 있습니다
- 문서 제목, 작성자 이름, 문서 통계 등과 같은 값을 포함하는 시스템 또는 내장 기능입니다.
- 사용자 정의 또는 사용자 정의. 사용자가 이름과 값을 모두 정의할 수 있는 이름-값 쌍으로 제공됩니다.
API 및 버전 번호에 대한 정보가 출력 문서에 직접 기록된다는 점을 알아두면 유용합니다. 예를 들어, 문서를 PDF로 변환할 때 Aspose.Words는 “응용 프로그램” 필드를 “Aspose.Words"로 채우고 “PDF 생산자” 필드를 “.NET YY.MN용 Aspose.Words"로 채웁니다. 여기서 YY.M.N는 변환에 사용된 Aspose.Words 버전입니다.. 자세한 내용은 출력 문서에 포함된 생성자 또는 생산자 이름을 참조하세요.
문서 속성에 액세스
Aspose.Words의 문서 속성에 액세스하려면 다음을 사용하세요
-
내장 속성을 얻기 위한 built_in_document_properties.
-
사용자 정의 속성을 얻기 위한 custom_document_properties.
built_in_document_properties 및 custom_document_properties는 DocumentProperty 객체의 컬렉션입니다. 이러한 개체는 이름 또는 인덱스별로 indexer 속성을 통해 얻을 수 있습니다.
built_in_document_properties는 적절한 유형의 값을 반환하는 입력된 속성 집합을 통해 문서 속성에 대한 액세스를 추가로 제공합니다. custom_document_properties를 사용하면 문서에서 문서 속성을 추가하거나 제거할 수 있습니다.
DocumentProperty 클래스를 사용하면 문서 속성의 이름, 값 및 유형을 얻을 수 있습니다. value는 객체를 반환하지만 속성 값을 특정 유형으로 변환할 수 있는 일련의 메서드가 있습니다. 속성의 유형을 파악한 후에는 DocumentProperty.__str__ 및 DocumentProperty.to_int과 같은 DocumentProperty.to_XXX 메서드 중 하나를 사용하여 적절한 유형의 값을 얻을 수 있습니다.
다음 코드 예제에서는 문서의 모든 기본 제공 속성과 사용자 지정 속성을 열거하는 방법을 보여줍니다
Microsoft Word에서는 “파일 → 속성” 메뉴를 사용하여 문서 속성에 접근할 수 있습니다.
문서 속성 추가 또는 제거
Aspose.Words를 사용하여 기본 제공 문서 속성을 추가하거나 제거할 수 없습니다. 해당 값을 변경하거나 업데이트하는 것만 가능합니다.
Aspose.Words를 사용하여 사용자 정의 문서 속성을 추가하려면 add 메서드를 사용하여 새 속성 이름과 적절한 유형의 값을 전달합니다. 이 메서드는 새로 생성된 DocumentProperty 객체를 반환합니다.
사용자 정의 속성을 제거하려면 remove 메서드를 사용하여 제거할 속성 이름을 전달하거나 remove_at 메서드를 사용하여 인덱스별로 속성을 제거합니다. clear 메서드를 사용하여 모든 속성을 제거할 수도 있습니다.
다음 코드 예제에서는 특정 이름을 가진 사용자 정의 속성이 문서에 존재하는지 확인하고 몇 가지 사용자 정의 문서 속성을 더 추가합니다
다음 코드 예제에서는 사용자 정의 문서 속성을 제거하는 방법을 보여줍니다
내장 문서 속성 업데이트
Aspose.Words는 Microsoft Word가 일부 속성을 수행하는 것처럼 문서 속성을 자동으로 업데이트하지 않지만 통계적으로 내장된 일부 문서 속성을 업데이트하는 방법을 제공합니다. update_word_count 메서드를 호출하여 다음 속성을 다시 계산하고 업데이트합니다
콘텐츠에 연결된 새 사용자 정의 속성 생성
Aspose.Words는 콘텐츠에 연결된 새로운 사용자 정의 문서 속성을 생성하는 add_link_to_content 방법을 제공합니다. 이 속성은 새로 생성된 속성 개체를 반환하거나 링크_소스이 유효하지 않은 경우 null을 반환합니다.
다음 코드 예제에서는 사용자 정의 속성에 대한 링크를 구성하는 방법을 보여줍니다
문서 변수 가져오기
variables 속성을 사용하여 문서 변수 컬렉션을 가져올 수 있습니다. 변수 이름과 값은 문자열입니다.
다음 코드 예제에서는 문서 변수를 추가하고 액세스하는 방법을 보여줍니다
문서에서 개인 정보 제거
Word 문서를 다른 사람과 공유하려면 작성자 이름, 회사 등의 개인 정보를 제거할 수 있습니다. 이를 수행하려면 remove_personal_information 속성을 사용하여 Microsoft Word가 문서 저장 시 주석, 수정본 및 문서 속성에서 모든 사용자 정보를 제거함을 나타내는 플래그를 설정합니다.
다음 코드 예제에서는 개인 정보를 제거하는 방법을 보여줍니다