다음을 통해 공유


문서 속성 읽기 및 쓰기

문서와 함께 문서 속성을 저장할 수 있습니다. Office 애플리케이션은 작성자, 제목 및 주제와 같은 다양한 기본 제공 속성을 제공합니다. 이 항목에서는 Microsoft Office Excel 및 Microsoft Office Word에서 문서 속성을 설정하는 방법을 보여 줍니다.

적용 대상: 이 항목의 정보는 Excel, PowerPoint, Project, Word의 문서 수준 프로젝트 및 VSTO 추가 기능 프로젝트에 적용됩니다. 자세한 내용은 Office 애플리케이션 및 프로젝트 형식에 따라 사용 가능한 기능을 참조하세요.

Excel에서 문서 속성 설정

Excel에서 기본 제공 속성으로 작업하려면 다음 속성을 사용합니다.

  • 문서 수준 프로젝트에서는 BuiltinDocumentProperties 클래스의 ThisWorkbook 속성을 사용합니다.

  • VSTO 추가 기능 프로젝트에서는 BuiltinDocumentProperties 개체의 Workbook 속성을 사용합니다.

    이러한 속성은 DocumentProperties 개체 컬렉션인 DocumentProperty 개체를 반환합니다. 컬렉션의 Item 속성을 사용하여 이름 또는 컬렉션 내의 인덱스로 특정 속성을 검색할 수 있습니다.

    다음 코드 예제에서는 문서 수준 프로젝트에서 기본 제공 Revision Number 속성을 변경하는 방법을 보여 줍니다.

Excel에서 수정 번호 속성을 변경하려면

  1. 기본 제공 문서 속성을 변수에 할당합니다.

    Microsoft.Office.Core.DocumentProperties properties;
    
    properties = (Microsoft.Office.Core.DocumentProperties)
        Globals.ThisWorkbook.BuiltinDocumentProperties; 
    
    Microsoft.Office.Core.DocumentProperty prop;
    prop = properties["Revision Number"];
    
  2. Revision Number 속성을 1씩 증가시킵니다.

    if (prop.Value == null)
    {
        prop.Value = 1;
    }
    else
    {
        int revision;
        if (int.TryParse((string)prop.Value, out revision))
        {
            prop.Value = revision + 1;
            MessageBox.Show("Revision Number = " + revision);
        }
        else
        {
            MessageBox.Show("Revision Number = invalid value");
        }
    }
    

Word에서 문서 속성 설정

Word에서 기본 제공 속성으로 작업하려면 다음 속성을 사용합니다.

  • 문서 수준 프로젝트에서는 BuiltInDocumentProperties 클래스의 ThisDocument 속성을 사용합니다.

  • VSTO 추가 기능 프로젝트에서는 BuiltInDocumentProperties 개체의 Document 속성을 사용합니다.

    이러한 속성은 DocumentProperties 개체 컬렉션인 DocumentProperty 개체를 반환합니다. 컬렉션의 Item 속성을 사용하여 이름 또는 컬렉션 내의 인덱스로 특정 속성을 검색할 수 있습니다.

    다음 코드 예제에서는 문서 수준 프로젝트에서 기본 제공 Subject 속성을 변경하는 방법을 보여 줍니다.

Subject 속성을 변경하려면

  1. 기본 제공 문서 속성을 변수에 할당합니다.

    Microsoft.Office.Core.DocumentProperties properties;
    
    properties = (Microsoft.Office.Core.DocumentProperties)
        Globals.ThisDocument.BuiltInDocumentProperties;
    
  2. Subject 속성을 "Whitepaper"로 변경합니다.

    // Set the Subject property. 
    properties["Subject"].Value = "Whitepaper";
    

강력한 프로그래밍

예제에서는 Excel용 문서 수준 프로젝트의 ThisWorkbook 클래스 및 Word용 문서 수준 프로젝트의 ThisDocument 클래스에서 코드를 작성했다고 가정합니다.

Word 및 Excel과 해당 개체로 작업 중이지만 Microsoft Office에서 사용 가능한 기본 제공 문서 속성 목록을 제공합니다. 정의되지 않은 속성에 액세스하려고 하면 예외가 발생합니다.