Aracılığıyla paylaş

ServerDocument.GetCustomizationVersion Yöntem

  • Makale

Sürümünü döndürür Visual Studio Tools for Office çalışma zamanı modülü ile ilişkili özelleştirme oluşturmak için kullanılanbelirtilen belge.

Ad alanı:  Microsoft.VisualStudio.Tools.Applications
Derleme:  Microsoft.VisualStudio.Tools.Applications.ServerDocument (Microsoft.VisualStudio.Tools.Applications.ServerDocument.dll içinde)

Sözdizimi

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

public static int GetCustomizationVersion(
    string documentPath
)

Parametreler

  • documentPath
    Tür: System.String
    Denetlemek istediğiniz belgenin tam yolu.

Dönüş Değeri

Tür: System.Int32
Sürümünü belirten bir sayı Visual Studio Tools for Office çalışma zamanı modülü oluşturma kullanıldıilişkili özelleştirme.

Özel Durumlar

Exception Koşul
ArgumentNullException

documentPath Parametresi nullnull başvuru (Visual Basic\'te Nothing) boş veya oluşur tamamen beyaz boşluk karakterleri.
FileNotFoundException

Belirtilen dosya documentPath yok.
UnknownCustomizationFileException

Belirtilen dosya documentPath tarafından desteklenmeyen bir dosya adı uzantısına sahip Visual Studio Tools for Office çalışma zamanı modülü.

Açıklamalar

Visual Studio farklı sürümlerinde oluşturulmuş office çözümlemelerinizi farklı sürümlerini Visual Studio Tools for Office çalışma zamanı modülü. Her çalışma zamanı sürümü farklı bir sürümünü sağlar ServerDocument sınıf çözümleri bu sürümü için birlikte çalışmak için tasarlanmışçalışma zamanı. Bu sürümü ServerDocument sınıf çözümleri kullanarak oluşturulan kullanılabilecek Visual Studio 2010 ve 2007 ile Visual Studio 2008 kullanılarak oluşturulan Microsoft Office çözümleri.

Aşağıdaki tabloda, bu yöntem için dönüş değerlerini anlamını belirtir.

Dönüş değeri

Açyklama

0

Belgenin bir özelleştirme yok.

1

Belgenin kullanılarak oluşturulmuş bir özelleştirme yok Visual Studio Tools for Office, Sürüm 2003.

2

Belge Office ikinci sürüm çalışma zamanı için Visual Studio 2005 araçları kullanılarak oluşturulmuş bir özelleştirme sahiptir. Bu özelleştirmeler tarafından Visual Studio 2005 araçları Microsoft Office 2003 için Office ve Visual Studio 2008 için kullanılan çalışma zamanı sürümüdür.

3

Belgenin kullanılarak oluşturulmuş bir özelleştirme yok Visual Studio 2010 Tools for Office Çalışma Zamanı Modülü ya da Microsoft Office sistemi için Visual Studio Araçları (sürüm 3.0 Runtime). Çalışma Zamanı'nın 3.0 sürümü 2007 Microsoft Office sistemi Visual Studio 2008 için özelleştirmeleri tarafından kullanılır.

Farklı sürümleri hakkında daha fazla bilgi için Visual Studio Tools for Office çalışma zamanı modülübakın Office için Visual Studio Araçları Çalışma Zamanına Genel Bakış.

Örnekler

Aşağıdaki kod örneği oluşturur Yeni bir ServerDocument , belirtilen belge yükler ve özelleştirme için bağlı dağıtım listesi URL'sini görüntülerbelge. Nesne oluşturmadan önce kodu kullanır GetCustomizationVersion yöntemini kullanarak özelleştirme oluşturulduğunu doğrulamak için Visual Studio 2010 Tools for Office Çalışma Zamanı Modülü.

Bu örnek aşağıdakileri gerektirir:

  • Bir konsol uygulaması projesi veya başka bir Office dışı projeye.

  • Aşağıdaki derlemelerine başvurular:

    • Microsoft.VisualStudio.Tools.Applications.ServerDocument.dll ve Microsoft.VisualStudio.Tools.Applications.Runtime.dll (eğer proje .NET Framework 4'i hedefliyorsa).

      ya da

    • Microsoft.Visualstudio.Tools.Applications.ServerDocument.V10.0.dll ve Microsoft.VisualStudio.Tools.Applications.Runtime.v9.0.dll (, proje hedefleri.net Framework 3.5).

  • Imports(Visual Basic için) veya using (için C#) ifadeleri için Microsoft.VisualStudio.Tools.Applications ve Microsoft.VisualStudio.Tools.Applications.Runtime ad alanları üst kod dosyası.

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

.NET Framework Güvenliği

Ayrıca bkz.

Başvuru

ServerDocument Sınıf

Microsoft.VisualStudio.Tools.Applications Ad Alanı

Diğer Kaynaklar

ServerDocument Sınıfını Kullanarak Sunucu Üzerinde Belge Yönetme