ServerDocument 클래스(2007 시스템)

아티클
08/22/2008

업데이트: 2007년 11월

Microsoft Office Excel 2007 또는 Microsoft Office Word 2007용 문서 수준 사용자 지정의 일부인 문서에 있는 캐시된 데이터와 사용자 지정 정보에 액세스할 수 있게 해 줍니다.

네임스페이스: Microsoft.VisualStudio.Tools.Applications
어셈블리: Microsoft.VisualStudio.Tools.Applications.ServerDocument.v9.0(Microsoft.VisualStudio.Tools.Applications.ServerDocument.v9.0.dll)

구문

<PermissionSetAttribute(SecurityAction.Demand, Name := "FullTrust")> _
Public NotInheritable Class ServerDocument _
    Implements IDisposable

Dim instance As ServerDocument

[PermissionSetAttribute(SecurityAction.Demand, Name = "FullTrust")]
public sealed class ServerDocument : IDisposable

설명

Excel 또는 Word가 설치되어 있지 않은 컴퓨터에서 문서 수준 사용자 지정의 특정 부분을 관리하려면 ServerDocument 클래스를 사용합니다.

ServerDocument 클래스의 다음 멤버를 사용하여 일반적인 작업을 수행할 수 있습니다.

서버에서 문서의 데이터 캐시에 있는 데이터에 액세스하고 이를 수정하려면 CachedData 속성을 사용합니다.
프로그래밍 방식으로 사용자 지정을 문서에 연결하거나 문서에서 사용자 지정을 제거하려면 AddCustomization 및 RemoveCustomization 메서드를 사용합니다.
문서와 연결된 배포 매니페스트의 URL에 액세스하거나 이를 변경하려면 DeploymentManifestUrl 속성을 사용합니다.

자세한 내용은 ServerDocument 클래스를 사용하여 서버의 문서 관리를 참조하십시오.

사용할 생성자 선택

ServerDocument 클래스를 사용하여 문서의 캐시된 데이터 또는 배포 매니페스트 URL에 액세스하려면 ServerDocument 개체를 만들어야 합니다.

ServerDocument 생성자에는 다음 두 가지가 있습니다.

메모리에 이미 열려 있는 문서에 액세스하는 데 사용할 수 있는 생성자
디스크에 있는 문서에 액세스하는 데 사용할 수 있는 생성자

메모리의 문서 액세스

메모리에 이미 열려 있는 문서에 액세스하려면 다음 생성자 중 하나를 사용합니다.

이러한 생성자는 바이트 배열이나 메모리의 문서를 나타내는 Stream을 받아들입니다. 이는 HTTP 프로토콜을 사용하여 문서의 캐시된 데이터 또는 응용 프로그램 매니페스트를 대상으로 스트리밍하기 전에 수정하려는 경우에 유용합니다. 이러한 생성자를 사용하려면 문서에 Visual Studio Tools for Office 사용자 지정이 이미 있어야 합니다. 그렇지 않으면 이러한 생성자에서 CannotLoadManifestException 예외가 throw됩니다.

디스크의 문서 액세스

디스크의 문서에 액세스하려면 다음 생성자 중 하나를 사용합니다.

이러한 생성자는 열려는 문서의 전체 경로를 받아들입니다. 기본적으로 문서는 읽기/쓰기 권한으로 열립니다. 읽기 전용 또는 쓰기 전용 권한으로 문서를 열려면 FileAccess 매개 변수가 있는 생성자를 사용합니다.

다른 버전의 ServerDocument 클래스 이해

Visual Studio Tools for Office에서는 Microsoft Office 2003 및 2007 Microsoft Office system용 솔루션에 대한 다른 버전의 ServerDocument 클래스를 제공합니다. 이 버전의 ServerDocument 클래스는 Word 2007 및 Excel 2007용 문서 수준 프로젝트 템플릿을 사용하여 만든 솔루션에만 사용할 수 있습니다.

Word 2003 및 Excel 2003용 프로젝트 템플릿을 사용하여 만든 솔루션에서 작업하려면 Microsoft.VisualStudio.Tools.Applications.Runtime 네임스페이스의 ServerDocument 클래스를 사용합니다.

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

예제

다음 코드 예제에서는 지정된 문서를 로드한 다음 문서에 연결된 Visual Studio Tools for Office 사용자 지정에 대한 배포 매니페스의 URL을 표시하는 새 ServerDocument를 만듭니다. 개체를 만들기 전에 코드에서는 GetCustomizationVersion 메서드를 사용하여 사용자 지정이 Microsoft Visual Studio Tools for the Microsoft Office system (버전 3.0 런타임)을 사용하여 만들어졌는지 확인합니다. 이 런타임은 이 버전의 ServerDocument 클래스와 호환되는 유일한 런타임입니다. 자세한 내용은 ServerDocument 클래스를 사용하여 서버의 문서 관리를 참조하십시오.

이 예제를 사용하려면 Microsoft.VisualStudio.Tools.Applications.ServerDocument.v9.0.dll과 Microsoft.VisualStudio.Tools.Applications.Runtime.v9.0.dll 어셈블리에 대한 참조, Microsoft.VisualStudio.Tools.Applications 및 Microsoft.VisualStudio.Tools.Applications.Runtime 네임스페이스에 대한 Imports(Visual Basic) 또는 using(C#) 문을 코드 파일 맨 위에 추가해야 합니다.

Private Sub CreateServerDocumentFromPath(ByVal documentPath As String)
    Dim runtimeVersion As Integer = 0
    Dim serverDocument1 As ServerDocument = Nothing

    Try
        runtimeVersion = ServerDocument.GetCustomizationVersion(documentPath)
        If runtimeVersion = 3 Then
            serverDocument1 = New ServerDocument(documentPath)
            MessageBox.Show("The URL of the deployment manifest is: " & vbLf & _
                serverDocument1.DeploymentManifestUrl.ToString())
        End If

    Catch ex As System.IO.FileNotFoundException
        System.Windows.Forms.MessageBox.Show("The specified document does not exist.")
    Catch ex As UnknownCustomizationFileException
        System.Windows.Forms.MessageBox.Show("The specified document has a file " & _
            "extension that is not supported by Visual Studio Tools for Office.")
    Finally
        If Not (serverDocument1 Is Nothing) Then
            serverDocument1.Close()
        End If
    End Try
End Sub

private void CreateServerDocumentFromPath(string documentPath)
{
    int runtimeVersion = 0;
    ServerDocument serverDocument1 = null;

    try
    {
        runtimeVersion = ServerDocument.GetCustomizationVersion(documentPath);
        if (runtimeVersion == 3)
        {
            serverDocument1 = new ServerDocument(documentPath);
            MessageBox.Show("The URL of the deployment manifest is: \n" +
                serverDocument1.DeploymentManifestUrl.ToString());
        }
    }
    catch (System.IO.FileNotFoundException)
    {
        System.Windows.Forms.MessageBox.Show("The specified document does not exist.");
    }
    catch (UnknownCustomizationFileException)
    {
        System.Windows.Forms.MessageBox.Show("The specified document has a file " +
            "extension that is not supported by Visual Studio Tools for Office.");
    }
    finally
    {
        if (serverDocument1 != null)
            serverDocument1.Close();
    }
}