Bagikan melalui

Menghapus ekstensi kode terkelola dari dokumen

  • Artikel

Anda dapat menghapus rakitan kustomisasi secara terprogram dari dokumen atau buku kerja yang merupakan bagian dari kustomisasi tingkat dokumen untuk Microsoft Office Word atau Microsoft Office Excel. Pengguna kemudian dapat membuka dokumen dan melihat konten, tetapi antarmuka pengguna kustom (UI) apa pun yang Anda tambahkan ke dokumen tidak akan muncul, dan kode Anda tidak akan berjalan.

Berlaku untuk: Informasi dalam topik ini berlaku untuk proyek tingkat dokumen untuk Excel dan Word. Untuk informasi selengkapnya, lihat Fitur yang tersedia berdasarkan aplikasi Office likasi dan jenis proyek.

Anda dapat menghapus rakitan kustomisasi dengan menggunakan salah RemoveCustomization satu metode yang disediakan oleh Visual Studio Tools untuk runtime Office . Metode mana yang Anda gunakan bergantung pada apakah Anda ingin menghapus kustomisasi pada waktu proses (yaitu, dengan menjalankan kode dalam kustomisasi saat dokumen Word atau buku kerja Excel terbuka), atau jika Anda ingin menghapus kustomisasi dari dokumen tertutup atau dokumen yang ada di server yang tidak menginstal Microsoft Office.

Untuk menghapus rakitan kustomisasi pada waktu proses

  1. Dalam kode kustomisasi Anda, panggil RemoveCustomization metode (untuk Word) atau RemoveCustomization metode (untuk Excel). Metode ini harus dipanggil hanya setelah penyesuaian tidak lagi diperlukan.

    Di mana Anda memanggil metode ini dalam kode Anda tergantung pada bagaimana penyesuaian Anda digunakan. Misalnya, jika pelanggan menggunakan fitur penyesuaian Anda sampai mereka siap untuk mengirim dokumen ke klien lain yang hanya perlu dokumen itu sendiri (bukan kustomisasi), Anda dapat memberikan beberapa UI yang memanggil RemoveCustomization ketika pelanggan mengkliknya. Atau, jika kustomisasi Anda mengisi dokumen dengan data saat pertama kali dibuka, tetapi penyesuaian tidak menyediakan fitur lain yang diakses langsung oleh pelanggan, maka Anda dapat memanggil RemoveCustomization segera setelah kustomisasi Anda selesai menginisialisasi dokumen.

Untuk menghapus rakitan kustomisasi dari dokumen tertutup atau dokumen di server

  1. Dalam proyek yang tidak memerlukan Microsoft Office, seperti aplikasi konsol atau proyek Formulir Windows, tambahkan referensi ke rakitan Microsoft.VisualStudio.Tools.Applications.ServerDocument.dll.

  2. Tambahkan pernyataan Impor atau penggunaan berikut ke bagian atas file kode Anda.

    using Microsoft.VisualStudio.Tools.Applications;

  3. Panggil metode ServerDocument statis RemoveCustomization kelas , dan tentukan jalur dokumen solusi untuk parameter .

    Contoh kode berikut mengasumsikan bahwa Anda menghapus kustomisasi dari dokumen bernama WordDocument1.docx yang ada di desktop.

    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. Buat proyek dan jalankan aplikasi di komputer tempat Anda ingin menghapus kustomisasi. Komputer harus menginstal Alat Visual Studio 2010 untuk runtime Office.

Konten terkait