Método AddInBase.RequestService

Artigo
08/01/2011

Retorna um objeto que se estende a um recurso em um aplicativo de 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
A Guid que identifica uma interface de extensibilidade, que é suportada por aplicativos de Microsoft Office.

Valor de retorno

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

Comentários

Substitua este método em um suplemento do nível do aplicativo para implementar uma interface de extensibilidade que estende um recurso em um aplicativo de Microsoft Office. For more information, see Personalizando os recursos de interface do usuário usando Interfaces de extensibilidade.

Quando você substituir esse método, verifique o valor de serviceGuid parâmetro para determinar qual interface de extensibilidade está sendo solicitado e, em seguida, retornar um objeto que implementa a interface. Quando seu suplemento é carregado, o Visual Studio Tools for Office runtime chamadas RequestService um ou mais vezes para cada interface que é suportado pelo aplicativo, e envia o valor de retorno para o aplicativo de Microsoft Office que está carregando o add-in. 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 interface do usuário, criando sua própria implementação da Microsoft.Office.Core.IRibbonExtensibility interface ou pela adição de um Da faixa de opções (XML) item ao seu projeto, como alternativa você pode substituir o CreateRibbonExtensibilityObject método em vez da RequestService método. For more information, see Visão geral da faixa de opções and XML da faixa de opções.

Se você estiver personalizando a interface do usuário, criando sua própria implementação da Microsoft.Office.Core.IRibbonExtensibility interface ou pela adição de um Da faixa de opções (XML) item ao seu projeto, como alternativa você pode substituir o CreateRibbonExtensibilityObject método em vez da RequestService método. For more information, see Visão geral da faixa de opções and XML da faixa de opções.

Exemplos

Para obter um exemplo de código demonstra como implementar uma interface de extensibilidade e substituir o RequestService método, 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