AddInBase.RequestService (Método)
Devuelve un objeto que extiende una característica de una aplicación de Microsoft Office.
Espacio de nombres: Microsoft.Office.Tools
Ensamblado: Microsoft.Office.Tools.Common.v4.0.Utilities (en Microsoft.Office.Tools.Common.v4.0.Utilities.dll)
Sintaxis
'Declaración
Protected Overridable Function RequestService ( _
serviceGuid As Guid _
) As Object
protected virtual Object RequestService(
Guid serviceGuid
)
Parámetros
- serviceGuid
Tipo: System.Guid
Guid que identifica una interfaz de extensibilidad compatible con las aplicaciones de Microsoft Office.
Valor devuelto
Tipo: System.Object
Objeto que implementa la interfaz de extensibilidad identificada por serviceGuid.
Comentarios
Invalide este método en un complemento de nivel de aplicación para implementar una interfaz de extensibilidad que extiende una característica en una aplicación de Microsoft Office. Para obtener más información, vea Personalizar características de la interfaz de usuario mediante interfaces de extensibilidad.
Cuando reemplace este método, compruebe el valor del parámetro serviceGuid para determinar qué interfaz de extensibilidad se solicita y, a continuación, devolver un objeto que implemente la interfaz. Una vez cargado el complemento, Motor en tiempo de ejecución de Microsoft Visual Studio Tools para Office llama una o varias veces a RequestService por cada interfaz compatible con la aplicación y envía el valor devuelto a la aplicación de Microsoft Office que está cargando el complemento. Para obtener más información sobre el proceso de carga de los complementos, consulte Arquitectura de los complementos de nivel de aplicación.
Nota
Si personaliza la interfaz de usuario de la cinta de opciones creando una implementación propia de la interfaz Microsoft.Office.Core.IRibbonExtensibility o agregando un elemento Cinta (XML) al proyecto, también puede invalidar el método CreateRibbonExtensibilityObject en lugar del método RequestService. Para obtener más información, vea Información general sobre la cinta de opciones y XML de la cinta de opciones.
Ejemplos
Para obtener un ejemplo de código en el que se muestra cómo implementar una interfaz de extensibilidad e invalidar el método RequestService, vea Personalizar características de la interfaz de usuario mediante interfaces de extensibilidad.
Seguridad de .NET Framework
- 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
Microsoft.Office.Tools (Espacio de nombres)
Otros recursos
Personalizar características de la interfaz de usuario mediante interfaces de extensibilidad