IsCustomized (Método) (2003 System)

Actualización: noviembre 2007

Obtiene un valor que indica si el documento especificado tiene una personalización de Visual Studio Tools para Office.

Espacio de nombres:  Microsoft.VisualStudio.Tools.Applications.Runtime
Ensamblado:  Microsoft.VisualStudio.Tools.Applications.Runtime (en Microsoft.VisualStudio.Tools.Applications.Runtime.dll)

Sintaxis

'Declaración
Public Shared Function IsCustomized ( _
    documentPath As String _
) As Boolean
'Uso
Dim documentPath As String
Dim returnValue As Boolean

returnValue = ServerDocument.IsCustomized(documentPath)

public static bool IsCustomized(
    string documentPath
)

Parámetros

• documentPath
  Tipo: System. . :: .String

  Ruta de acceso del documento en el que desea comprobar si hay una personalización.

Valor devuelto

Tipo: System. . :: .Boolean

true si el documento tiene una personalización de Visual Studio Tools para Office; de lo contrario, false.

Excepciones

Excepción	Condición
ArgumentNullException	El parámetro documentPath es null Nothing nullptr referencia null (Nothing en Visual Basic) o está vacío, o se compone únicamente de caracteres de espacio en blanco.
FileNotFoundException	El archivo de documentPath no existe.

Comentarios

Este método devuelve true si el documento tiene un manifiesto de aplicación que señala a un ensamblado de personalización y al menos un elemento entryPoint. El elemento entryPoint especifica la clase de la que se crean instancias cuando se abre el documento. Los documentos que se asocian a un ensamblado pero no tienen ningún elemento entryPoint no ejecutan el código y no se consideran personalizados. Para obtener más información, vea Elemento <entryPoint> (Referencia de Visual Studio Tools para Office).

Ejemplos

En el ejemplo de código siguiente se utiliza el método RemoveCustomization para quitar la personalización del documento especificado. En el ejemplo se llama primero al método IsCustomized para determinar si el documento tiene una personalización de Visual Studio Tools para Office. En este ejemplo se necesita una referencia al ensamblado Microsoft.VisualStudio.Tools.Applications.Runtime y una instrucción Imports (para Visual Basic) o using (para C#) para el espacio de nombres Microsoft.VisualStudio.Tools.Applications.Runtime al principio del archivo de código.

Private Shared Sub Remove(ByVal fileName As String)
    If ServerDocument.IsCustomized(fileName) Then
        ServerDocument.RemoveCustomization(fileName)
        MsgBox("The customization has been removed.")
    Else
        MsgBox("The specified document is not " + _
            "customized.")
    End If
End Sub

private static void Remove(string fileName)
{
    if (ServerDocument.IsCustomized(fileName))
    {
        ServerDocument.RemoveCustomization(fileName);
        MessageBox.Show("The customization has been removed.");
    }
    else
    {
        MessageBox.Show("The specified document is not " +
            "customized.");
    }
}

Permisos

• Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.

Vea también

Referencia

ServerDocument (Clase)

ServerDocument (Miembros)

Microsoft.VisualStudio.Tools.Applications.Runtime (Espacio de nombres)