Nasıl yapılır: belgelerden yönetilen kod uzantıları kaldırma

Microsoft Office Word ya da Microsoft Office Excel belge düzeyi özelleştirmesinin parçası olan özelleştirilmiş derlemeyi program aracılığı ile belgeden veya çalışma kitabından kaldırabilirsiniz.Kullanıcılar daha sonra belgelerini açabilir ve içindekileri görüntüleyebilir, fakat belgeye eklediğiniz herhangi bir özel kullanıcı arayüzü (UI) gözükmeyecek ve kodunuz çalışmayacaktır.

Uygulama alanı: Bu konudaki bilgiler şu uygulamaların belge düzeyi projelerine yöneliktir: Excel 2013 ve Excel 2010; Word 2013 ve Word 2010. Daha fazla bilgi için bkz. Office Uygulamalarında Kullanılabilir Özellikler ve Proje Türü.

Office için Visual Studio Araçları çalışma zamanı modülü tarafından sağlanan RemoveCustomization yöntemlerinden birini kullanarak özelleştirilmiş derlemeyi kaldırabilirsiniz.Hangi yöntemi kullanacağınız özelleştirmeyi çalışma zamanında (yani, özelleştirmedeki kodu Word belgesi veya Excel çalışma kitabı açıkken çalıştırma) kaldırmak isteyip istemediğinize veya özelleştirmeyi kapalı bir belgeden yada Microsoft Office yüklü olmayan sunucudaki bir belgeden silmek istemenize göre değişir.

İlgili video gösterimi için bkz: nasıl yapmak ı: İliştirme veya Word belgesinden vsto derlemesini Ayır?.

Özelleştirilmiş derlemeyi çalışma zamanında kaldırmak için

• Özelleştirilmiş kodunuzda Document.RemoveCustomization (Word için) veya Workbook.RemoveCustomization (Excel için) yöntemini çağırın.Bu method yalnızca özelleştirmenin daha fazla gerekmediği zamandan sonra çağırılır.

  Bu methodu kodunuzda nerden çağırdığınız özelleştirmenizin nasıl kullanıldığına göre değişir.Örneğin, müşteriler sadece belgenin kendisine (özelleştirmeye değil) ihtiyaç duyan diğer müşterilere belgeyi göndermeye hazır olana kadar sizin özelleştirmenizin özelliklerini kullanıyorsa, kullanıcı tıkladığında RemoveCustomization'ı çağıran bazı UI sağlayabilirsiniz.Alternatif olarak, özelleştirmeniz belgeyi ilk açıldığında bilgi ile dolduruyorsa, fakat özelleştirme müşteriler tarafından doğrudan erişilen özelliklerden başka bir özellik sağlamıyorsa, o zaman müşteriniz belgeyi başlatmayı bitirir bitirmez RemoveCustomization'ı çağırabilirsiniz.

Kapalı veya sunucudaki bir belgeden özelleştirilmiş derlemeyi kaldırmak için

1. Microsoft Office gibi bir konsol uygulaması gerektirmeyen bir proje veya Windows Forms projesi Microsoft.VisualStudio.Tools.Applications.ServerDocument.dll bütünleştirilmiş koduna başvuru ekleyin.

2. Kod dosyanın en üstüne aşağıdaki Imports veya using deyimini ekleyin.

   Imports Microsoft.VisualStudio.Tools.Applications
   

   using Microsoft.VisualStudio.Tools.Applications;
   

3. ServerDocument sınıfının statik RemoveCustomization yöntemini çağırın ve parametre için çözüm belgesi konumunu belirtin.

   Aşağıdaki kod örneği özelleştirmeyi masaüstündeki WordDocument1.docx isimli belgeden kaldırdığınızı varsayar.

   Dim documentPath As String = System.Environment.GetFolderPath( _
       Environment.SpecialFolder.Desktop) & "\WordDocument1.docx"
   Dim runtimeVersion As Integer = 0
   
   Try
       runtimeVersion = ServerDocument.GetCustomizationVersion(documentPath)
       If runtimeVersion = 3 Then
           ServerDocument.RemoveCustomization(documentPath)
           System.Windows.Forms.MessageBox.Show("The customization has been removed.")
       End If
   Catch ex As FileNotFoundException
       System.Windows.Forms.MessageBox.Show("The specified document does not exist.")
   Catch ex As IOException
       System.Windows.Forms.MessageBox.Show("The specified document is read-only.")
   Catch ex As InvalidOperationException
       System.Windows.Forms.MessageBox.Show("The customization could not be removed." & _
           vbLf & ex.Message)
   End Try
   

   string documentPath = System.Environment.GetFolderPath(
       Environment.SpecialFolder.Desktop) + @"\WordDocument1.docx";
   int runtimeVersion = 0;
   
   try
   {
       runtimeVersion = ServerDocument.GetCustomizationVersion(documentPath);
   
       if (runtimeVersion == 3)
       {
           ServerDocument.RemoveCustomization(documentPath);
           System.Windows.Forms.MessageBox.Show("The customization has been removed.");
       }
   }
   catch (FileNotFoundException)
   {
       System.Windows.Forms.MessageBox.Show("The specified document does not exist.");
   }
   catch (IOException)
   {
       System.Windows.Forms.MessageBox.Show("The specified document is read-only.");
   }
   catch (InvalidOperationException ex)
   {
       System.Windows.Forms.MessageBox.Show("The customization could not be removed.\n" +
           ex.Message);
   }
   

4. Projeyi derleyin ve özelleştirmesini kaldırmak istediğiniz bilgisayarda uygulamayı çalıştırın.Bilgisayarda Office Runtime için Visual Studio 2010 Araçları olmalıdır.

Ayrıca bkz.

Görevler

Nasıl yapılır: yönetilen kod uzantıları için belgeler eklemek

Kavramlar

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