Nasıl yapılır: Belgelere yönetilen kod uzantıları ekleme

Şunlar için geçerlidir:yesnoVisual Studio Mac için Visual Studio noVisual Studio Code

Varolan bir Microsoft Office Word belgesine veya Microsoft Office Excel çalışma kitabına özelleştirme derlemesi ekleyebilirsiniz. Belge veya çalışma kitabı, Visual Studio'daki Microsoft Office projeleri ve geliştirme araçları tarafından desteklenen herhangi bir dosya biçiminde olabilir. Daha fazla bilgi için bkz . Belge düzeyinde özelleştirmelerin mimarisi.

Şunlar için geçerlidir: Bu konudaki bilgiler, Excel ve Word için belge düzeyi projeler için geçerlidir. Daha fazla bilgi için bkz. Office uygulama ve proje türüne göre kullanılabilen özellikler.

Word veya Excel belgesine özelleştirme eklemek için sınıfının yöntemini ServerDocument kullanınAddCustomization. ServerDocument sınıfı, Microsoft Office yüklü olmayan bir bilgisayarda çalıştırılacak şekilde tasarlandığından, bu yöntemi Microsoft Office geliştirme (konsol veya Windows Forms uygulaması gibi) ile doğrudan ilgili olmayan çözümlerde kullanabilirsiniz.

Not

Kod, belirtilen belgenin sahip olmadığı denetimleri bekliyorsa özelleştirme yüklenemiyor.

Bir belgeye yönetilen kod uzantıları eklemek için

  1. Konsol uygulaması veya Windows Forms projesi gibi Microsoft Office gerektirmeyen bir projede, Microsoft.VisualStudio.Tools.Applications.ServerDocument.dll başvuru ekleyin ve derlemeleri Microsoft.VisualStudio.Tools.Applications.Runtime.dll.

  2. Kod dosyanızın en üstüne aşağıdaki İçeri aktarmaları veya using deyimlerini ekleyin.

    using Microsoft.VisualStudio.Tools.Applications;
    using Microsoft.VisualStudio.Tools.Applications.Runtime;
    
  3. Statik AddCustomization yöntemini çağırın.

    Aşağıdaki kod örneği aşırı yüklemeyi kullanır AddCustomization . Bu aşırı yükleme, belgenin tam yolunu ve belgeye eklemek istediğiniz özelleştirme için dağıtım bildiriminin konumunu belirten bir Uri alır. Bu örnekte ,WordDocument1.docx adlı bir Word belgesinin masaüstünde olduğu ve dağıtım bildiriminin aynı zamanda masaüstünde bulunan Yayımla adlı bir klasörde yer aldığı varsayılır.

    string documentPath = System.Environment.GetFolderPath(
        Environment.SpecialFolder.Desktop) + @"\WordDocument1.docx";
    int runtimeVersion = 0;
    
    try
    {
        runtimeVersion = ServerDocument.GetCustomizationVersion(documentPath);
    
        // Make sure that this document does not yet have any Visual Studio Tools 
        // for Office customizations.
        if (runtimeVersion == 0)
        {
            string deployManifestPath = System.Environment.GetFolderPath(
                Environment.SpecialFolder.Desktop) + @"\Publish\WordDocument1.vsto";
    
            Uri deploymentManifestUri = new Uri(deployManifestPath);
            ServerDocument.AddCustomization(documentPath, deploymentManifestUri);
            System.Windows.Forms.MessageBox.Show("The document was successfully customized.");
        }
        else
        {
            System.Windows.Forms.MessageBox.Show("The document is already customized.");
        }
    }
    catch (FileNotFoundException)
    {
        System.Windows.Forms.MessageBox.Show("The specified document does not exist.");
    }
    catch (DocumentNotCustomizedException ex)
    {
        System.Windows.Forms.MessageBox.Show("The document could not be customized.\n" +
            ex.Message);
    }
    
  4. Projeyi derleyin ve özelleştirmeyi eklemek istediğiniz bilgisayarda uygulamayı çalıştırın. Bilgisayarda Office Çalışma Zamanı için Visual Studio 2010 Araçları yüklü olmalıdır.

Ayrıca bkz.