Aracılığıyla paylaş

ServerDocument.GetCustomizationVersion Yöntem

  • Makale

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

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 numara Office için Visual Studio Araçları çalışma zamanı modülü ilişkili özelleştirmesinin kullanıldı.

Özel Durumlar

Exception Koşul
ArgumentNullException

documentPath Parametresi nullnull başvuru (Visual Basic'te Nothing) veya boş ya da tamamen boşluk karakterlerinden oluşur.
FileNotFoundException

Tarafından belirtilen dosya documentPath yok.
UnknownCustomizationFileException

Tarafından belirtilen dosya documentPath tarafından desteklenmeyen bir dosya adı uzantısına sahip Office için Visual Studio Araçları çalışma zamanı modülü.

Notlar

Farklı Visual Studio sürümlerinde oluşturulan office çözümlerini farklı sürümlerini kullanmak Office için Visual Studio Araçları çalışma zamanı modülü.Her çalışma zamanı sürümü farklı bir sürümünü sağlar ServerDocument çözümleri çalışma zamanı sürümü ile çalışmak üzere tasarlanmış bir sınıf.Bu sürümü ServerDocument sınıfı kullanılarak oluşturulan çözümleri ile kullanılabilir Visual Studio 2013, 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

Tanımlama

0

Özelleştirme, belge yok.

1

Belgenin Sürüm 2003 Office için Visual Studio araçları kullanılarak oluşturulmuş bir özelleştirme yok.

2

Belgenin, Second Edition Office çalışma zamanı için Visual Studio 2005 araçları kullanılarak oluşturulmuş bir özelleştirme yok.Özelleştirmeleri 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

Microsoft Office sistemi için Visual Studio Araçları ya da Office çalıştırma zamanı için Visual Studio 2010 araçları kullanılarak oluşturulmuş bir özelleştirme belge sahip (sürüm 3.0 çalışma zamanı).Sürüm 3.0 çalışma zamanı için Visual Studio 2008 2007 Microsoft Office sistemi özelleştirmeleri tarafından kullanılır.

Farklı sürümleri hakkında daha fazla bilgi için Office için Visual Studio Araçları çalışma zamanı modülü, bkz: Office Çalışma Zamanı İçin Visual Studio Araçlarına Genel Bakış.

Örnekler

Aşağıdaki kod örneği oluşturur Yeni bir ServerDocument , belirtilen bir belge yükler ve sonra belgeye iliştirilmiş özelleştirme için dağıtım bildiriminin URL'sini görüntüler.Nesne oluşturmadan önce kodu kullanır GetCustomizationVersion yöntemini özelleştirme Office Runtime için Visual Studio 2010 araçları kullanılarak oluşturulmuş olduğunu doğrulayın.

Bu örnek aşağıdakileri gerektirir:

  • Konsol uygulama projesi veya başka bir Office dışı proje.

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

    • Microsoft.VisualStudio.Tools.Applications.ServerDocument.dll ve Microsoft.VisualStudio.Tools.Applications.Runtime.dll (durumunda proje hedefleri .NET Framework 4 veya .NET Framework 4.5).

      veya

    • Microsoft.VisualStudio.Tools.Applications.ServerDocument.v10.0.dll ve Microsoft.VisualStudio.Tools.Applications.Runtime.v9.0.dll (proje .NET Framework 3.5 hedefliyorsa).

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

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 Sunucuda Belge Yönetme