ServerDocument.GetCustomizationVersion(String) Yöntem

Tanım

Office çalışma zamanı için Visual Studio AraçlarıBelirtilen belgeyle ilişkili özelleştirmeyi oluşturmak için kullanılan sürümünü döndürür.

public static int GetCustomizationVersion (string documentPath);

Parametreler

documentPath
String

Denetlemek istediğiniz belgenin tam yolu.

Döndürülenler

Int32

Office çalışma zamanı için Visual Studio Araçlarıİlişkili özelleştirmeyi oluşturmak için kullanılan sürümünü belirten bir sayı.

Özel durumlar

documentPathParametresi null veya boş ya da tamamen boşluk karakterlerinden oluşur.

Tarafından belirtilen dosya documentPath yok.

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

Örnekler

Aşağıdaki kod örneği, belirtilen bir belgeyi yükleyen yeni bir oluşturur ServerDocument ve ardından belgeye iliştirilmiş özelleştirmenin dağıtım BILDIRIMININ URL 'sini görüntüler. Nesne oluşturmadan önce, kod, GetCustomizationVersion özelleştirmenin Office çalışma zamanı Için Visual Studio 2010 araçları kullanılarak oluşturulduğunu doğrulamak için yöntemini kullanır.

Bu örnek şunları gerektirir:

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

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

    • Microsoft.VisualStudio.Tools.Applications.ServerDocument.dll ve Microsoft.VisualStudio.Tools.Applications.Runtime.dll (proje veya ' i hedefliyorsa .NET Framework 4 .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'i hedefliyorsa).

  • Imports(for Visual Basic) veya using (for C#) deyimleri, Microsoft.VisualStudio.Tools.Applications ve için Microsoft.VisualStudio.Tools.Applications.Runtime Kod dosyanızın en üstünde bulunan ad alanları.

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

Açıklamalar

Visual Studio 'nun farklı sürümlerinde oluşturulan Office çözümleri farklı sürümlerini kullanır Office çalışma zamanı için Visual Studio Araçları . Çalışma zamanının her sürümü, ServerDocument çalışma zamanının bu sürümü için çözümlerle çalışacak şekilde tasarlanan sınıfının farklı bir sürümünü sağlar. Sınıfının bu sürümü ServerDocument kullanılarak oluşturulan çözümlerle Visual Studio 2013 Visual Studio 2010 ve Visual Studio 2008 kullanılarak oluşturulan 2007 Microsoft Office çözümlerle birlikte kullanılabilir.

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

Döndürülen değer Açıklama
0 Belgenin bir özelleştirmesi yok.
1 Belge, Office için Visual Studio Araçları, Sürüm 2003 kullanılarak oluşturulmuş bir özelleştirmeye sahiptir.
2 Belge, Office Ikinci sürüm çalışma zamanı için Visual Studio 2005 araçları kullanılarak oluşturulmuş bir özelleştirmeye sahiptir. Bu, Office ve Visual Studio 2008 için Visual Studio 2005 araçları 'nda Microsoft Office 2003 için özelleştirmeler tarafından kullanılan çalışma zamanının sürümüdür.
3 Belge, Office çalışma zamanı için Visual Studio 2010 araçları veya Microsoft Office sistemi için Visual Studio Araçları (sürüm 3,0 çalışma zamanı) kullanılarak oluşturulmuş bir özelleştirmeye sahiptir. Çalışma zamanının 3,0 sürümü Visual Studio 2008 içindeki 2007 Microsoft Office sistemine yönelik özelleştirmeler tarafından kullanılır.

Uygulamasının farklı sürümleri hakkında daha fazla bilgi için Office çalışma zamanı için Visual Studio Araçları , bkz. Office çalışma zamanına genel bakış Visual Studio Araçları.

Şunlara uygulanır