ServerDocument 클래스를 사용하여 서버의 문서 관리

업데이트: 2007년 11월

ServerDocument 클래스를 사용하면 Microsoft Office Word 및 Microsoft Office Excel이 설치되어 있지 않은 경우에도 문서 수준 사용자 지정의 여러 가지 측면을 관리할 수 있습니다. 다음 작업을 수행할 수 있습니다.

• 문서 또는 통합 문서의 데이터 캐시에 있는 데이터에 액세스하고 이를 수정할 수 있습니다. 자세한 내용은 문서의 캐시된 데이터 작업을 참조하십시오.

• 문서의 Visual Studio Tools for Office 사용자 지정을 관리할 수 있습니다. 자세한 내용은 문서 사용자 지정 관리를 참조하십시오.

ServerDocument 클래스 이해

Visual Studio Tools for Office 런타임의 각 버전에 대해 하나씩, 모두 두 가지 버전의 ServerDocument 클래스가 있습니다. Microsoft Office의 솔루션 버전에 해당하는 버전을 사용합니다.

• Excel 2007 및 Word 2007의 사용자 지정에는 Microsoft.VisualStudio.Tools.Applications.ServerDocument 클래스를 사용합니다. 이 클래스는 Microsoft Visual Studio Tools for the Microsoft Office system (버전 3.0 런타임)에서 제공됩니다.

• Excel 2003 및 Word 2003의 사용자 지정에는 Microsoft.VisualStudio.Tools.Applications.Runtime.ServerDocument 클래스를 사용합니다. 이 클래스는 Visual Studio 2005 Tools for Office Second Edition 런타임에서 제공됩니다.

ServerDocument 클래스의 두 버전은 대부분의 기능이 동일하지만 네임스페이스, 어셈블리 및 멤버에는 차이가 있습니다. 자세한 내용은 ServerDocument 차이점 이해를 참조하십시오.

ServerDocument 클래스는 Microsoft Office가 설치되어 있지 않은 컴퓨터에서 작동하도록 디자인되었습니다. 따라서 대개 Visual Studio Tools for Office 프로젝트가 아니라 콘솔 프로젝트 또는 Windows Forms 프로젝트와 같이 Microsoft Office와 통합되지 않은 프로젝트에서 이 클래스를 사용합니다.

서로 다른 버전의 Visual Studio Tools for Office 런타임에 대한 자세한 내용은 Visual Studio Tools for Office 런타임 개요를 참조하십시오.

문서의 캐시된 데이터 작업

ServerDocument 클래스의 두 버전 모두 사용자 지정된 문서의 데이터 캐시에 대해 작업하는 데 사용할 수 있는 멤버를 제공합니다. 캐시된 데이터에 대한 자세한 내용은 데이터 캐싱 및 서버에 있는 문서의 데이터 액세스을 참조하십시오.

다음 표에는 캐시된 데이터에 대해 작업하는 데 사용할 수 있는 멤버가 나와 있습니다.

문서 사용자 지정 관리

ServerDocument 클래스의 멤버를 사용하여 문서의 Visual Studio Tools for Office 사용자 지정을 관리할 수 있습니다. 예를 들어 문서가 더 이상 Visual Studio Tools for Office 사용자 지정의 일부가 되지 않도록 문서에서 사용자 지정을 프로그래밍 방식으로 제거할 수 있습니다.

다음 표에는 사용자 지정 어셈블리를 관리하는 데 사용할 수 있는 멤버가 나와 있습니다.

ServerDocument 차이점 이해

두 가지 버전의 ServerDocument 클래스와 CachedDataHostItem 및 CachedDataItem과 같이 캐시된 데이터에 대한 개체 모델을 제공하는 관련 클래스는 서로 다른 어셈블리 및 네임스페이스에 정의되어 있습니다. 또한 일부 멤버 및 메서드 오버로드는 한 버전의 클래스에서만 제공됩니다. 다음과 같은 경우에 이러한 차이점을 알고 있어야 합니다.

• Excel 2007 및 Word 2007 솔루션에서 사용할 수 있도록 Visual Studio 2005 Tools for Office Second Edition 런타임의 ServerDocument 클래스를 사용하는 코드를 마이그레이션하려는 경우

• Microsoft Office 2003 및 2007 Microsoft Office system 모두의 문서 수준 사용자 지정과 함께 작동하는 코드에서 ServerDocument 클래스를 사용하려는 경우

동일한 코드에서 두 버전의 ServerDocument 클래스를 모두 사용하는 방법을 보여 주는 예제는 방법: ServerDocument 클래스의 두 버전을 모두 사용하는 코드 작성을 참조하십시오.

네임스페이스와 어셈블리 차이점

다음 표에는 두 가지 버전의 ServerDocument 클래스와 캐시된 데이터에 대한 개체 모델을 제공하는 클래스의 네임스페이스 및 어셈블리 차이점이 나와 있습니다.

멤버 차이점

다음 멤버는 Microsoft Visual Studio Tools for the Microsoft Office system (버전 3.0 런타임)의 ServerDocument 클래스에서만 제공됩니다.

• GetCustomizationVersion

• DeploymentManifestUrl

• SolutionId

• AddCustomization

• AddCustomization

다음 멤버는 Visual Studio 2005 Tools for Office Second Edition 런타임의 ServerDocument 클래스에서만 제공됩니다.

• AppManifest

• ManifestModifiedTime

• AddCustomization

참고 항목

작업

방법: ServerDocument 클래스의 두 버전을 모두 사용하는 코드 작성

방법: 문서에 관리 코드 확장 연결(2007 시스템)

방법: 문서에 관리 코드 확장 연결(2003 시스템)

방법: 문서에서 관리 코드 확장 제거(2007 시스템)

방법: 문서에서 관리 코드 확장 제거(2003 시스템)

개념

Visual Studio Tools for Office 런타임 개요

데이터 캐싱

참조

Microsoft.VisualStudio.Tools.Applications.ServerDocument

Microsoft.VisualStudio.Tools.Applications.Runtime.ServerDocument