Udostępnij za pośrednictwem

Metoda ServerDocument.GetCustomizationVersion —

  • Artykuł

Zwraca informacje o wersji z Visual Studio 2010 Tools for Office Runtime który został użyty do utworzenia dostosowania, jakie są skojarzone z określonego dokumentu.

Przestrzeń nazw:  Microsoft.VisualStudio.Tools.Applications
Zestaw:  Microsoft.VisualStudio.Tools.Applications.ServerDocument (w Microsoft.VisualStudio.Tools.Applications.ServerDocument.dll)

Składnia

'Deklaracja
Public Shared Function GetCustomizationVersion ( _
    documentPath As String _
) As Integer

public static int GetCustomizationVersion(
    string documentPath
)

Parametry

  • documentPath
    Typ: System.String
    Pełną ścieżkę dokumentu, który chcesz sprawdzić.

Wartość zwracana

Typ: System.Int32
Liczba określająca wersję Visual Studio 2010 Tools for Office Runtime który został użyty do utworzenia skojarzonego dostosowywania.

Wyjątki

Wyjątek Warunek
ArgumentNullException

documentPath Jest parametr nullodwołanie o wartości null (Nothing w języku Visual Basic) lub pusty lub zawiera tylko znaki odstępu.
FileNotFoundException

W pliku określonym przez documentPath nie istnieje.
UnknownCustomizationFileException

W pliku określonym przez documentPath ma rozszerzenie nazwy pliku, który nie jest obsługiwany przez Visual Studio 2010 Tools for Office Runtime.

Uwagi

Rozwiązania biurowe między różnymi wersjami programu Visual Studio używają różnych wersji Visual Studio 2010 Tools for Office Runtime.Każda wersja środowiska wykonawczego zawiera inną wersję ServerDocument klasy, który jest przeznaczony do pracy z rozwiązaniami dla tej wersji środowiska wykonawczego.Ta wersja programu ServerDocument klasa może być używana z rozwiązań, które są tworzone za pomocą Visual Studio 2013, Visual Studio 2010 i z 2007 pakietu Microsoft Office, które są tworzone przy użyciu programu Visual Studio 2008.

W poniższej tabeli określono znaczenie wartości zwracanych przez tę metodę.

Wartość zwrócona

Opis

0

Dokument nie ma pliku dostosowań.

1

Dokument zawiera dostosowania, który został utworzony przy użyciu narzędzi Visual Studio Tools for Office, wersja 2003.

2

Dokument zawiera dostosowania, który został utworzony przy użyciu programu Visual Studio 2005 Tools dla Office Second Edition runtime.To jest wersja środowiska wykonawczego używanego przez dostosowania dla pakietu Microsoft Office 2003 w Visual Studio 2005 Tools dla pakietu Office i programu Visual Studio 2008.

3

Dokument zawiera dostosowania, który został utworzony przy użyciu programu Visual Studio 2010 Tools for Office Runtime lub Visual Studio Tools dla pakietu Microsoft Office system (wersja 3.0 Runtime).Wersja 3.0 runtime jest używany przez dostosowania dla pakietu Microsoft Office 2007 w programie Visual Studio 2008.

Aby uzyskać więcej informacji dotyczących różnych wersji programu Visual Studio 2010 Tools for Office Runtime, zobacz Visual Studio Tools for Office Runtime ― Przegląd.

Przykłady

Poniższy przykład kodu tworzy nowy ServerDocument który wczytuje określony dokument, a następnie wyświetla adres URL manifestu wdrażania dla dostosowania, który jest dołączony do dokumentu.Przed utworzeniem obiektu, w kodzie za pomocą GetCustomizationVersion metoda, aby zweryfikować, że dostosowanie zostało utworzone przy użyciu programu Visual Studio 2010 Tools dla środowiska Office Runtime.

W tym przykładzie wymaga:

  • Projekt aplikacji konsoli lub innych projektów nienależących do pakietu Office.

  • Odwołania do następujących zestawów:

    • Microsoft.VisualStudio.Tools.Applications.ServerDocument.dll i Microsoft.VisualStudio.Tools.Applications.Runtime.dll (jeśli cele projektu .NET Framework 4 lub .NET Framework 4.5).

      lub

    • Microsoft.VisualStudio.Tools.Applications.ServerDocument.v10.0.dll i Microsoft.VisualStudio.Tools.Applications.Runtime.v9.0.dll (Jeśli projekt jest przeznaczony dla.NET Framework 3.5).

  • Imports(dla Visual Basic) lub using (w przypadku C#) oświadczenia dla Microsoft.VisualStudio.Tools.Applications i Microsoft.VisualStudio.Tools.Applications.Runtime obszarów nazw u góry pliku kodu.

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();
    }
}

Zabezpieczenia programu .NET Framework

Zobacz też

Informacje

ServerDocument Klasa

Przestrzeń nazw Microsoft.VisualStudio.Tools.Applications

Inne zasoby

Zarządzanie dokumentami na serwerze za pomocą klasy ServerDocument