다음을 통해 공유

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

  • 아티클

업데이트: 2007년 11월

적용 대상

이 항목의 정보는 지정된 Visual Studio Tools for Office 프로젝트 및 Microsoft Office 버전에만 적용됩니다.

프로젝트 형식

  • 문서 수준 프로젝트

Microsoft Office 버전

  • 2007 Microsoft Office system

  • Microsoft Office 2003

자세한 내용은 응용 프로그램 및 프로젝트 형식에 따라 사용 가능한 기능을 참조하십시오.

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

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

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

ServerDocument 클래스 이해

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

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

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

작업

Excel 2007 및 Word 2007 프로젝트

Excel 2003 및 Word 2003 프로젝트

문서에 Visual Studio Tools for Office 데이터 캐시가 있는지 여부를 확인

Microsoft Visual Studio Tools for the Microsoft Office system (버전 3.0 런타임)의 IsCacheEnabled 메서드

Visual Studio 2005 Tools for Office Second Edition 런타임의 IsCacheEnabled 메서드

문서의 캐시된 데이터에 액세스

자세한 내용은 서버에 있는 문서의 데이터 액세스를 참조하십시오.

Microsoft Visual Studio Tools for the Microsoft Office system (버전 3.0 런타임)의 CachedData 속성

Visual Studio 2005 Tools for Office Second Edition 런타임의 CachedData 속성

문서 사용자 지정 관리

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

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

작업

Excel 2007 및 Word 2007 프로젝트

Excel 2003 및 Word 2003 프로젝트

문서에 Visual Studio Tools for Office 사용자 지정이 있는지 여부를 확인

Microsoft Visual Studio Tools for the Microsoft Office system (버전 3.0 런타임)의 GetCustomizationVersion 메서드

Visual Studio 2005 Tools for Office Second Edition 런타임의 IsCustomized 메서드

런타임에 문서에 사용자 지정을 프로그래밍 방식으로 연결

자세한 내용은 다음 항목을 참조하십시오.

Microsoft Visual Studio Tools for the Microsoft Office system (버전 3.0 런타임)의 AddCustomization 메서드 중 하나

Visual Studio 2005 Tools for Office Second Edition 런타임의 AddCustomization 메서드 중 하나

런타임에 문서에서 사용자 지정을 프로그래밍 방식으로 제거

자세한 내용은 다음 항목을 참조하십시오.

Microsoft Visual Studio Tools for the Microsoft Office system (버전 3.0 런타임)의 RemoveCustomization 메서드

Visual Studio 2005 Tools for Office Second Edition 런타임의 RemoveCustomization 메서드

문서와 연결된 배포 매니페스트의 URL 가져오기

Microsoft Visual Studio Tools for the Microsoft Office system (버전 3.0 런타임)의 DeploymentManifestUrl 속성

배포 매니페스트는 Excel 2003 및 Word 2003의 문서 수준 솔루션에서 선택적이므로 Visual Studio 2005 Tools for Office Second Edition 런타임에는 이 속성이 포함되어 있지 않습니다. 대신 이러한 솔루션에는 항상 포함된 응용 프로그램 매니페스트가 있습니다.

문서에 포함된 응용 프로그램 매니페스트에 액세스

Excel 2007 및 Word 2007의 문서 수준 솔루션에는 포함된 응용 프로그램 매니페스트가 없으므로 Microsoft Visual Studio Tools for the Microsoft Office system (버전 3.0 런타임)에는 이 속성이 포함되어 있지 않습니다.

Visual Studio 2005 Tools for Office Second Edition 런타임의 AppManifest 속성

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 런타임)

Microsoft.VisualStudio.Tools.Applications

Microsoft.VisualStudio.Tools.Applications.ServerDocument.v9.0.dll

Visual Studio 2005 Tools for Office Second Edition 런타임

Microsoft.VisualStudio.Tools.Applications.Runtime

Microsoft.VisualStudio.Tools.Applications.Runtime.dll

멤버 차이점

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

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

참고 항목

작업

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

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

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

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

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

개념

Visual Studio Tools for Office 런타임 개요

데이터 캐싱

참조

Microsoft.VisualStudio.Tools.Applications.ServerDocument

Microsoft.VisualStudio.Tools.Applications.Runtime.ServerDocument