ServerDocument.RemoveCustomization أسلوب

قم بإزالة التخصيص من مستند.

مساحة الاسم:  Microsoft.VisualStudio.Tools.Applications
التجميع:  Microsoft.VisualStudio.Tools.Applications.ServerDocument (في Microsoft.VisualStudio.Tools.Applications.ServerDocument.dll)

بناء الجملة

'إقرار
Public Shared Sub RemoveCustomization ( _
    documentPath As String _
)

public static void RemoveCustomization(
    string documentPath
)

المعلمات

• documentPath
  النوع: System.String
  مسار الكامل للمستند الذي ترغب في إلى قم بإزالة cusإلىmization.

استثناءات

استثناء:	شرط
ArgumentNullException	documentPathمعلمة هو nullمرجع خالٍ (لا شيء في Visual Basic)أو فارغة أو consهوts تماما من أحرف المسافات البيضاء.
FileNotFoundException	ملف المحدد بواسطة documentPathغير موجود.
IOException	ملف المحدد بواسطة documentPathهو للقراءة فقط أو لا يمكن الوصول إليها.
InvalidOperationException	الملف المحدد بواسطة documentPathأدى لا يكون تخصيص، أو خطأ حدث أثناء تحميل بيان.
DocumentCustomizedWithPreviousRuntimeException	ملف المحدد مع documentPathله تخصيص التي لم يتم تاريخ الإنشاء مع Visual Studio Tools لـ Office Runtimeأو أدوات ‏‫Visual Studio لنظام Microsoft المكتب 2010 Suite (الإصدار 3.0 وقت التشغيل).

ملاحظات

مسح هذا الأسلوب توزيع البيان بيان URL والبيانات المخزنة مؤقتاً، وإزالة أية بيانات مخزنة مؤقتاً من مستند. لمزيد من المعلومات، راجع كيفية: إزالة التعليمات البرمجية المدارة ملحقات من المستندات.

أمثلة

يلي تعليمات برمجية يستخدم المثال RemoveCustomizationالأسلوب لإزالة التخصيص من التطبيق المحدد. المثال أولاً باستدعاء GetCustomizationVersionالأسلوب إلى لتحديد ما إذا كان مستند cusإلىmization.

يتطلب هذا المثال:

• مشروع تطبيقات وحدة تحكم أو بعض المشاريع بخلاف المكتب الأخرى.

• مراجع إلى تجميعات التالية:

  • Microsoft.VisualStudio.أدوات.Applications.ServerDocument.dll و Microsoft.VisualStudio.أدوات.Applications.وقت التشغيل.dll (إذا كان مشروع تستهدف .NET Framework 4).

    أو

  • Microsoft.VisualStudio.أدوات.Applications.ServerDocument.v10.0.dll و Microsoft.VisualStudio.أدوات.Applications.وقت التشغيل.v9.0.dll (إذا كان مشروع تستهدف 3.5 إطار عمل.NET).

• Imports (for Visual Basic) or using (for C#) statements for Microsoft.VisualStudio.Tools.Applications and Microsoft.VisualStudio.Tools.Applications.Runtime namespaces at the top of your code file.

Private Shared Sub RemoveAssembly(ByVal documentPath As String)
    Dim runtimeVersion As Integer = 0

    Try
        ' Make sure that this customization was created using the correct runtime.
        runtimeVersion = ServerDocument.GetCustomizationVersion(documentPath)
        If runtimeVersion <> 3 Then
            MessageBox.Show("This document does not have a Visual Studio Tools for Office " & _
                "customization, or it has a customization that was created with a version of " & _
                "the runtime that is incompatible with this version of the ServerDocument class.")
            Return
        End If

        ServerDocument.RemoveCustomization(documentPath)
        MessageBox.Show("The customization has been removed.")

    Catch ex As System.IO.FileNotFoundException
        System.Windows.Forms.MessageBox.Show("The specified document does not exist.")
    Catch ex As System.IO.IOException
        System.Windows.Forms.MessageBox.Show("The specified document is read-only.")
    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.")
    Catch ex As InvalidOperationException
        System.Windows.Forms.MessageBox.Show("The customization could not be removed." & _
            vbLf & ex.Message)
    End Try
End Sub

private static void RemoveAssembly(string documentPath)
{
    int runtimeVersion = 0;

    try
    {
        runtimeVersion = ServerDocument.GetCustomizationVersion(documentPath);

        // Make sure that this customization was created using the correct runtime.
        if (runtimeVersion != 3)
        {
            MessageBox.Show("This document does not have a Visual Studio Tools for " +
                "Office customization, or it has a customization that was created with " +
                "a version of the runtime that is incompatible with this version of the " +
                "ServerDocument class.");
            return;
        }

        ServerDocument.RemoveCustomization(documentPath);
        MessageBox.Show("The customization has been removed.");
    }
    catch (System.IO.FileNotFoundException)
    {
        System.Windows.Forms.MessageBox.Show("The specified document does not exist.");
    }
    catch (System.IO.IOException)
    {
        System.Windows.Forms.MessageBox.Show("The specified document is read-only.");
    }
    catch (UnknownCustomizationFileException)
    {
        System.Windows.Forms.MessageBox.Show("The specified document has a file " +
            "extension that is not supported by Visual Studio Tools for Office.");
    }
    catch (InvalidOperationException ex)
    {
        System.Windows.Forms.MessageBox.Show("The customization could not be removed.\n" +
            ex.Message);
    }
}

أمن NET Framework.

• الثقة الكاملة للمتصل الفوري. يتعذر استخدام هذا العضو بواسطة التعليمات البرمجية الموثوق بها جزئيًا. لمزيد من المعلومات، راجع باستخدام مكتبات من تعليمات برمجية موثوق بها جزئي.

راجع أيضًَا

المرجع

ServerDocument الفئة

ServerDocument الأعضاء

Microsoft.VisualStudio.Tools.Applications مساحة الاسم

موارد أخرى

كيفية: إزالة التعليمات البرمجية المدارة ملحقات من المستندات