Método AddInBase.RequestService

Artigo
05/21/2013

Retorna um objeto que estende um recurso em um aplicativo do Microsoft Office.

Namespace: Microsoft.Office.Tools
Assembly: Microsoft.Office.Tools.Common.v4.0.Utilities (em Microsoft.Office.Tools.Common.v4.0.Utilities.dll)

Sintaxe

'Declaração
Protected Overridable Function RequestService ( _
    serviceGuid As Guid _
) As Object

protected virtual Object RequestService(
    Guid serviceGuid
)

Parâmetros

serviceGuid
Tipo: System.Guid
Guid que identifica uma interface de extensibilidade que é suportada por aplicativos do Microsoft Office.

Valor de retorno

Tipo: System.Object
Um objeto que implementa a interface de extensibilidade que é identificada por serviceGuid.

Comentários

Substitua esse método em um suplemento ao nível para implementar uma interface de extensibilidade que estende um recurso em um aplicativo do Microsoft Office.Para obter mais informações, consulte Personalizando os recursos de interface do usuário usando Interfaces de extensibilidade.

Quando você substitui esse método, verificar o valor do parâmetro de serviceGuid para determinar qual interface de extensibilidade está sendo solicitada, e para retornar em um objeto que implementa a interface.Quando o suplemento é carregado, Visual Studio Tools for Office Runtime chama RequestService uma ou mais vezes para cada interface que é suportada pelo aplicativo, e envia o valor de retorno ao aplicativo do Microsoft Office que é carregar o suplemento.Para obter mais informações sobre o processo de carregamento de suplementos, consulte Arquitetura dos suplementos de nível de aplicativo.

Observação
Se você estiver personalizando a fita interface do usuário criando sua própria implementação da interface de Microsoft.Office.Core.IRibbonExtensibility ou adicionando um item de Faixa de Opções (XML) ao seu projeto como alternativa, você pode substituir o método de CreateRibbonExtensibilityObject em vez do método de RequestService .Para obter mais informações, consulte Visão geral da faixa de opções e Faixa de opções XML.

Se você estiver personalizando a fita interface do usuário criando sua própria implementação da interface de Microsoft.Office.Core.IRibbonExtensibility ou adicionando um item de Faixa de Opções (XML) ao seu projeto como alternativa, você pode substituir o método de CreateRibbonExtensibilityObject em vez do método de RequestService .Para obter mais informações, consulte Visão geral da faixa de opções e Faixa de opções XML.

Exemplos

Para um código exemplo que mostra como implementar uma interface de extensibilidade e para substituir o método de RequestService , consulte Personalizando os recursos de interface do usuário usando Interfaces de extensibilidade.

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.

Consulte também

Referência

AddInBase Classe

Namespace Microsoft.Office.Tools

Outros recursos

Personalizando os recursos de interface do usuário usando Interfaces de extensibilidade

Compartilhar via