Partilhar via


Serviços relacionados e Interfaces (VSPackage de controle de origem)

Esta seção lista todas as interfaces relacionadas ao VSPackage de controlar a origem do SDK do Visual Studio. O controle de origem VSPackage implementa algumas dessas interfaces e usa a outras pessoas para realizar tarefas de controle de origem.

Interfaces implementadas por e para os VSPackages de controle de origem

As seguintes interfaces são descritas as SDK do Visual Studio, e o controle de origem VSPackage implementa um subconjunto deles, dependendo do seu conjunto de recursos desejado. Algumas interfaces são marcados como necessária e deve ser implementado por cada controle de origem VSPackage.

Para essas interfaces que não implementa um pacote, Visual Studio fornece uma implementação padrão. Observe que a implementação padrão é criada para o caso quando nenhum VSPackage é registrado e nenhum projeto é controlado. Um controle de origem criados corretamente VSPackage implementa interfaces todas as mídias necessárias em vez de deixá-la para a implementação padrão dessas interfaces.

Um controle de fonte VSPackage deve implementar um serviço particular que encapsula a algumas ou todas as seguintes interfaces.

Interfaces são:

  • Obrigatório: A entidade adequado (controle de origem VSPackage, Stub de controle de origem, do projeto) deve implementar a interface.

  • Recomendado: A entidade deve implementar essa interface; Caso contrário, a funcionalidade de controle de origem pode ser limitada.

  • Opcional: a entidade pode implementar essa interface para fornecer um conjunto de recursos mais sofisticado.

Interface

Objetivo

Implementado por

Implementar?

IVsQueryEditQuerySave2

Editores de chamam essa interface antes de modificar ou salvar um arquivo. O controle de origem VSPackage pode fazer check-out do arquivo ou negar a operação se o check-out falhar.

Controle de origem VSPackage

Recomendável

IVsSccManager2

Essa interface fornece funcionalidade de controle de origem de básico para projetos, como registrar e cancelar o registro de projetos com controle de origem e fornecendo suporte para glifos de controle de origem básico.

Controle de origem VSPackage

Necessário

IVsSccProject2

Essa interface é obtida a partir do IVsHierarchy usando o QueryInterface função, ou simplesmente Projetando a implementação do objeto IVsHierarchy para IVsSccProject2. Ele é usado para obter os arquivos sob controle de origem em um projeto ou para informar o projeto do status atual de controle de origem ou local.

Project

Necessário

IVsSccProvider

O módulo de integração usa essa interface para definir o VSPackage ativo atual.

Controle de origem VSPackage

Necessário

IVsTrackProjectDocuments2

Essa interface é baseada em um modelo de assinatura. Qualquer VSPackage pode sinalizar que deseja receber eventos de documento e aconselhado pelo shell em eventos que estão prestes a acontecer. Ele está implementado e controlado por Visual Studio, que por sua vez passa eventos Implementando o IVsTrackProjectDocumentsEvents2 para o VSPackage.

Stub de controle de origem

Necessário

IVsTrackProjectDocuments3

Essa interface fornece processamento em lotes, operações de leitura/gravação sincronizada e um avançado OnQueryAddFiles método.

Stub de controle de origem

Necessário

IVsTrackProjectDocumentsEvents2

Solution Explorer e projetos chamam essa interface quando novos arquivos são adicionados aos projetos ou arquivos e pastas são renomeadas ou excluídas de projetos. O controle de origem VSPackage pode fazer check-out do arquivo de projeto ou cancelar a operação.

Controle de origem VSPackage

Recomendável

IVsTrackProjectDocumentsEvents3

Solution Explorer e projetos chamar essa interface em resposta a chamadas feitas para os métodos da interface IVstrackProjectDocuments3. As operações de leitura/gravação o controle de origem VSPackage pode controlar as operações em lote, sincronizadas e trabalhar com mais avançados OnQueryAddFiles método.

Controle de origem VSPackage

Recomendável

IVsSccEnlistmentPathTranslation

Essa interface fornece suporte de gerenciamento de inscrição para projetos da Web.

Controle de origem VSPackage

Recomendável

IVsSccManagerTooltip

Essa interface é usada para recuperar as dicas de ferramentas para os arquivos de origem controlada nos projetos.

Controle de origem VSPackage

Optional

IVsSccOpenFromSourceControl

Essa interface fornece suporte de extensão do namespace.

Controle de origem VSPackage

Optional

IVsSccControlNewSolution

O VSPackage usa essa interface para integrar uma extensão do namespace para o New, Abrir, ou Salvar caixas de diálogo. Conseqüentemente, projetos podem ser automaticamente adicionados ao controle de origem na criação ou adicionados ao controle de origem, quando uma operação Salvar operação está em vigor.

Controle de origem VSPackage

Optional

IVsSccGlyphs

O VSPackage usa essa interface para definir os glifos adicionais como glifos de controle de origem para nós em Solution Explorer.

Controle de origem VSPackage

Optional

IVsSccAddWebProjectFromSourceControl

O Add caixa de diálogo para projetos da Web usa essa interface. Ele fornece métodos para navegar para um local de controle de origem e para abrir um projeto da Web adicionado anteriormente no repositório de controle de origem nesse local.

Controle de origem VSPackage

Recomendável

IVsAsynchOpenFromScc

Essa interface fornece suporte para o carregamento assíncrono (plano de fundo) de projetos de controle de origem.

Controle de origem VSPackage

Optional

IVsAsynchOpenFromSccProjectEvents

Essa interface permite que os projetos para observar o progresso de carregamento assíncrono iniciado por IVsAsynchOpenFromScc.

Project

Optional

IVsSccToolsOptions

Essa interface permite que o IDE consultar o controle de fonte ativa VSPackage. O IDE consulta o valor de configurações de controle de origem que têm significado, mesmo quando não há nenhum controle de fonte ativa que VSPackage é registrado. Essa interface é implementada e manipulada por Visual Studio.

Stub de controle de origem

Necessário

IVsRegisterScciProvider

Essa interface é usada em registrar o controle de origem VSPackage.

Stub de controle de origem

Necessário

SourceControl

Essa interface é usada na automação. Como tal, ele expõe apenas as funções que podem ser executadas sem exibir qualquer interface do usuário.

Controle de origem VSPackage

Optional

IVsPersistSolutionProps

Essa interface é usada para salvar configurações de controle de origem no arquivo de solução (. sln). As configurações incluem o local do controle de origem e os sinalizadores de status de controle de origem.

Controle de origem VSPackage

Recomendável

IVsPersistSolutionOpts

Essa interface é usada para salvar as configurações de controle de origem no arquivo de opções (. suo) da solução. Isso pode incluir configurações de controle de origem de usuário específicas, como local de inscrição do usuário atual.

Controle de origem VSPackage

Recomendável

IVsSolutionEvents3

Essa interface é usada para monitorar os eventos para realizar operações como, por exemplo, check-in de arquivos de projeto antes de fechar soluções ou obter novos arquivos de controle de origem ao abrir um projeto.

Controle de origem VSPackage

Recomendável

Consulte também

Outros recursos

Elementos de Design de VSPackage de controle de origem