IVsAsyncShellOpenDocument.OpenDocumentViaProjectAsync Método

Definição

Namespace:

Microsoft.VisualStudio.Shell.Interop

Assembly:

Microsoft.VisualStudio.Interop.dll

Pacote:

Microsoft.VisualStudio.Interop v17.9.37000

Localiza um projeto apropriado para abrir o documento.

public Microsoft.VisualStudio.Shell.Interop.IVsTask OpenDocumentViaProjectAsync (string documentMoniker, Guid logicalView, bool supportExternalItems);

abstract member OpenDocumentViaProjectAsync : string * Guid * bool -> Microsoft.VisualStudio.Shell.Interop.IVsTask

Public Function OpenDocumentViaProjectAsync (documentMoniker As String, logicalView As Guid, supportExternalItems As Boolean) As IVsTask

Parâmetros

documentMoniker

String

Forma de cadeia de caracteres do identificador de moniker exclusivo do documento no sistema de projeto, por exemplo, o caminho completo para o arquivo. Em casos que não são de arquivo, esse identificador geralmente está na forma de uma URL.

logicalView

Guid

Um Guid que identifica o modo de exibição lógico. A exibição padrão é VSConstants.LOGVIEWID_Primary e cada editor deve dar suporte a essa exibição.

Se o editor implementar IVsMultiViewDocumentView no objeto de exibição de documento, o valor passado para ActivateLogicalView(Guid), que determina qual exibição é ativada quando a janela do editor é mostrada.

Ao especificar a exibição Guidlógica , você pode solicitar a exibição específica que corresponde ao motivo pelo qual você está solicitando a exibição. Por exemplo, especifique VSConstants.LOGVIEWID_DebuggingIVsCodeWindowpara obter a exibição apropriada para depuração ou VSConstants.LOGVIEWID_TextView para obter a exibição apropriada para o editor de texto (ou seja, uma exibição que implementa ).

supportExternalItems

Boolean

true se o projeto der suporte a itens externos; caso contrário, false.

Retornos

IVsTask

Uma tarefa que representa a operação aberta. O resultado da tarefa é um IVsAsyncOpenDocumentResult objeto .

Comentários

A tarefa retornada por esse método não indica que a exibição e o docdata do documento foram carregados. Consulte DocumentLoadTask para obter mais detalhes.

Isso pode ser chamado para abrir qualquer projeto aberto por meio da caixa de diálogo Novo Projeto ou Abrir Projeto. Além disso, esse método também é chamado para abrir um documento em qualquer projeto adicionado à solução por meio AddVirtualProject(IVsHierarchy, UInt32) de ou AddVirtualProjectEx(IVsHierarchy, UInt32, Guid). Um exemplo de uso disso é a hierarquia DataView, que está atualmente no Explorer do Servidor. Se uma hierarquia DataView for adicionada à solução como um projeto virtual usando AddVirtualProject(IVsHierarchy, UInt32), esse método poderá abrir itens de hierarquias do DataView. Essa funcionalidade é importante, pois possibilita a depuração de procedimentos armazenados.