Interface IVsTrackProjectDocuments2

 

Usado pelos projetos para consultar o ambiente de permissão Adicionar, remover ou renomear um arquivo ou diretório em uma solução.

Namespace:   Microsoft.VisualStudio.Shell.Interop
Assembly:  Microsoft.VisualStudio.Shell.Interop (em Microsoft.VisualStudio.Shell.Interop.dll)

Sintaxe

[InterfaceTypeAttribute(1)]
[GuidAttribute("53544C4D-6639-11D3-A60D-005004775AB1")]
public interface IVsTrackProjectDocuments2

[InterfaceTypeAttribute(1)]
[GuidAttribute("53544C4D-6639-11D3-A60D-005004775AB1")]
public interface class IVsTrackProjectDocuments2

[<InterfaceTypeAttribute(1)>]
[<GuidAttribute("53544C4D-6639-11D3-A60D-005004775AB1")>]
type IVsTrackProjectDocuments2 = interface end

<InterfaceTypeAttribute(1)>
<GuidAttribute("53544C4D-6639-11D3-A60D-005004775AB1")>
Public Interface IVsTrackProjectDocuments2

Métodos

	Nome	Descrição
	AdviseTrackProjectDocumentsEvents(IVsTrackProjectDocumentsEvents2, UInt32)	Esse método permite que os clientes recebam notificações de eventos de documentos do projeto.
	BeginBatch()	Este método iniciará um lote de IVsTrackProjectDocuments2.OnAfter* chamadas de método.
	EndBatch()	Este método termina o lote iniciado por BeginBatch e exibe qualquer interface de usuário (UI) que foi gerado dentro do lote.
	Flush()	Esse método exibe a interface do usuário para o IVsTrackProjectDocuments2 chamadas concluídas até o momento sem encerrar o lote.
	OnAfterAddDirectories(IVsProject, Int32, String[])	Este método é chamado por um projeto depois diretórios foram adicionados ao projeto.
	OnAfterAddDirectoriesEx(IVsProject, Int32, String[], VSADDDIRECTORYFLAGS[])	Este método é chamado por um projeto depois diretórios foram adicionados ao projeto.Esse método é equivalente a OnAfterAddDirectories, mas também usa sinalizadores.
	OnAfterAddFiles(IVsProject, Int32, String[])	Este método é chamado por um projeto após os arquivos foram adicionados ao projeto.
	OnAfterAddFilesEx(IVsProject, Int32, String[], VSADDFILEFLAGS[])	Este método é chamado por um projeto após os arquivos foram adicionados ao projeto.
	OnAfterRemoveDirectories(IVsProject, Int32, String[], VSREMOVEDIRECTORYFLAGS[])	Este método é chamado por um projeto depois que diretórios foram removidos do projeto.
	OnAfterRemoveFiles(IVsProject, Int32, String[], VSREMOVEFILEFLAGS[])	Este método é chamado por um projeto após os arquivos foram removidos do projeto.
	OnAfterRenameDirectories(IVsProject, Int32, String[], String[], VSRENAMEDIRECTORYFLAGS[])	Este método é chamado por um projeto depois que um diretório foi renomeado no projeto.
	OnAfterRenameFile(IVsProject, String, String, VSRENAMEFILEFLAGS)	Este método é chamado por um projeto depois que um arquivo foi renomeado no projeto.
	OnAfterRenameFiles(IVsProject, Int32, String[], String[], VSRENAMEFILEFLAGS[])	Este método é chamado por um projeto após os arquivos foram renomeados no projeto.
	OnAfterSccStatusChanged(IVsProject, Int32, String[], UInt32[])	Este método é chamado pelo Stub de controle de origem para informar aos ouvintes que o status de controle de origem foi alterado.Não chame este método.
	OnQueryAddDirectories(IVsProject, Int32, String[], VSQUERYADDDIRECTORYFLAGS[], VSQUERYADDDIRECTORYRESULTS[], VSQUERYADDDIRECTORYRESULTS[])	Este método é chamado por um projeto para determinar se os diretórios podem ser adicionados ao projeto.
	OnQueryAddFiles(IVsProject, Int32, String[], VSQUERYADDFILEFLAGS[], VSQUERYADDFILERESULTS[], VSQUERYADDFILERESULTS[])	Este método é chamado por um projeto para determinar se os arquivos podem ser adicionados ao projeto.
	OnQueryRemoveDirectories(IVsProject, Int32, String[], VSQUERYREMOVEDIRECTORYFLAGS[], VSQUERYREMOVEDIRECTORYRESULTS[], VSQUERYREMOVEDIRECTORYRESULTS[])	Este método é chamado por um projeto para determinar se os diretórios podem ser removidos do projeto.
	OnQueryRemoveFiles(IVsProject, Int32, String[], VSQUERYREMOVEFILEFLAGS[], VSQUERYREMOVEFILERESULTS[], VSQUERYREMOVEFILERESULTS[])	Este método é chamado por um projeto para determinar se os arquivos podem ser removidos do projeto.
	OnQueryRenameDirectories(IVsProject, Int32, String[], String[], VSQUERYRENAMEDIRECTORYFLAGS[], VSQUERYRENAMEDIRECTORYRESULTS[], VSQUERYRENAMEDIRECTORYRESULTS[])	Este método é chamado por um projeto para determinar se os diretórios do projeto podem ser renomeados.
	OnQueryRenameFile(IVsProject, String, String, VSRENAMEFILEFLAGS, Int32)	Este método é chamado por um projeto para determinar se um arquivo no projeto pode ser renomeado.
	OnQueryRenameFiles(IVsProject, Int32, String[], String[], VSQUERYRENAMEFILEFLAGS[], VSQUERYRENAMEFILERESULTS[], VSQUERYRENAMEFILERESULTS[])	Este método é chamado por um projeto para determinar se os arquivos podem ser renomeados no projeto.
	UnadviseTrackProjectDocumentsEvents(UInt32)	Esse método impede que os clientes recebam notificações de eventos de documentos do projeto.

Comentários

Use o IVsTrackProjectDocuments2 interface para solicitar permissão do ambiente para adicionar, remover ou renomear qualquer arquivo ou pasta em um projeto e (se a permissão é concedida) para informar o ambiente quando essas ações são concluídas.Você precisa fazer essas chamadas, mesmo se o seu projeto não oferece suporte a controle de origem.Você deve usar IVsTrackProjectDocuments2 para todos os arquivos, não apenas arquivos master.Por exemplo, se você tiver um formulário com um arquivo. resx e outros arquivos, você precisa dizer sobre todos os arquivos para o ambiente.Não chame os métodos de IVsTrackProjectDocuments2 no projeto, abrir ou fechar.Qualquer entidade que requer que as informações fornecidas por meio de IVsTrackProjectDocuments2 na inicialização pode aguardar a OnAfterOpenSolution eventos e iterar por meio da solução para localizar as informações necessárias.Ao desligar, essas informações não é necessária.O acesso a IVsTrackProjectDocuments2 é fornecido pela SVsTrackProjectDocuments service.

Para cada chamada em IVsTrackProjectDocuments2, há dois métodos, o OnQuery* método e a OnAfter* método.Chame o apropriado OnQuery* método para solicitar permissão para adicionar, remover ou renomear um arquivo ou diretório em um projeto.Desta chamada, você poderá receber a notificação de que a operação não pode continuar.Por exemplo, se o sistema de projeto da estrutura corporativa e o modelo (EFT) não permite ao usuário adicionar um arquivo que não atendem à diretiva, o projeto deve estar preparado para não realizar a adicionar, remover ou renomear.Se a permissão for concedida, o projeto deve concluir a adicionar, renomear, ou ação de remover e, em seguida, chame o apropriado OnAfter* método para informar o ambiente das alterações feitas no projeto.

O IVsTrackProjectDocuments2 o método também se aplica a diretórios, mas as chamadas de diretório são opcionais.Se o sistema de projeto tem informações de diretório, em seguida, fornece essas informações para o ambiente usando esses métodos.No entanto, se não tiver essas informações, o sistema do projeto, o ambiente deduzirá-lo.

Observação
Todas as chamadas de diretório são opcionais.No entanto, se você chamar um do OnQuery* métodos de diretório e a chamada foi bem-sucedida, em seguida, você deve chamar o correspondente OnAfter* o método de diretório.

IVsTrackProjectDocuments2é acessada por meio do SVsTrackProjectDocuments service.

Observações para implementadores:

Implementado pelo ambiente.Essa interface é o mecanismo para reunir as informações sobre quando um arquivo ou diretório é adicionado, removido ou renomeado em um projeto.

Observações para chamadores:

Chamado por projetos para consultar o ambiente como se um arquivo ou diretório pode ser adicionado, removido ou renomeado em uma solução.Para todas as ações são aprovadas pelo ambiente, o método apropriado é então chamado depois que a ação é concluída.IVsTrackProjectDocuments2deve ser usado por todos os projetos, independentemente se eles oferecem suporte a controle de origem.

Consulte também

Namespace Microsoft.VisualStudio.Shell.Interop

Retornar ao topo