Carregamento atrasado de documentos

Quando um usuário reabre uma solução do Visual Studio, a maioria dos documentos associados não são carregados imediatamente. O quadro da janela do documento é criado em um estado de inicialização pendente e um documento de espaço reservado (chamado de quadro de stub) é colocado na tabela RDT (Documento em Execução).

Sua extensão pode fazer com que os documentos do projeto sejam carregados desnecessariamente, consultando elementos nos documentos antes de serem carregados, o que pode aumentar o espaço de memória geral para o Visual Studio.

Carregamento de documentos

O quadro de stub e o documento são totalmente inicializados quando o usuário acessa o documento, por exemplo, selecionando a guia do quadro da janela. O documento também pode ser inicializado por uma extensão que solicita os dados do documento, seja acessando o RDT diretamente para adquirir os dados do documento, ou acessando o RDT indiretamente fazendo uma das seguintes chamadas:

• O método de moldura Show de janela.

• O método window frame GetProperty em qualquer uma das seguintes propriedades:

  • __VSFPROPID. VSFPROPID_DocView

  • __VSFPROPID. VSFPROPID_ViewHelper

  • __VSFPROPID. VSFPROPID_DocData

  • __VSFPROPID. VSFPROPID_AltDocData

  • __VSFPROPID. VSFPROPID_RDTDocData

  • __VSFPROPID. VSFPROPID_SPProjContext

• Se sua extensão usa código gerenciado, você não deve chamar GetDocumentInfo , a menos que tenha certeza de que o documento não está no estado de inicialização pendente ou deseja que o documento seja totalmente inicializado. O motivo é porque o método sempre retorna o objeto de dados doc, criando-o se necessário. Em vez disso, você deve chamar um dos métodos na IVsRunningDocumentTable4 interface.

• Se sua extensão usa C++, você pode passar null para os parâmetros que você não deseja.

• Você pode evitar o carregamento desnecessário de documentos chamando um dos seguintes métodos antes de solicitar as propriedades relevantes antes de solicitar outras propriedades:

  • GetProperty usando __VSFPROPID6. VSFPROPID_PendingInitialization.

  • GetDocumentFlags. Esse método retorna um objeto que inclui um _VSRDTFLAGS4 valor para _VSRDTFLAGS4. RDT_PendingInitialization se o documento ainda não tiver sido inicializado.

Você pode descobrir quando um documento foi carregado inscrevendo-se no evento RDT que é gerado quando um documento é totalmente inicializado. Há duas possibilidades:

• Se o coletor de IVsRunningDocTableEvents2eventos implementar , você poderá se inscrever no OnAfterAttributeChangeEx,

• Caso contrário, você pode assinar o OnAfterAttributeChange.

O exemplo a seguir é um cenário hipotético de acesso a documentos: Uma extensão do Visual Studio deseja exibir algumas informações sobre documentos abertos, por exemplo, a contagem de bloqueio de edição e algo sobre os dados do documento. Ele enumera os documentos no RDT usando IEnumRunningDocumentso , em seguida, chama GetDocumentInfo cada documento para recuperar a contagem de bloqueio de edição e os dados do documento. Se o documento estiver no estado de inicialização pendente, solicitar os dados do documento fará com que ele seja inicializado desnecessariamente.

Uma maneira mais eficiente de acessar um documento é usar para obter a contagem de bloqueio de edição e, em seguida, usar GetDocumentEditLockCount GetDocumentFlags para determinar se o documento foi inicializado. Se as bandeiras não incluírem _VSRDTFLAGS4. RDT_PendingInitialization, o documento já foi inicializado e solicitar os dados do documento com GetDocumentData não causa nenhuma inicialização desnecessária. Se as bandeiras incluírem _VSRDTFLAGS4. RDT_PendingInitialization, a prorrogação deve evitar solicitar os dados do documento até que o documento seja inicializado. Essa inicialização pode ser detectada no manipulador de OnAfterAttributeChange(Ex) eventos.

Testar extensões para ver se elas forçam a inicialização

Não há nenhuma pista visível para indicar se um documento foi inicializado, portanto, pode ser difícil descobrir se sua extensão está forçando a inicialização. Você pode definir uma chave do Registro que facilite a verificação, pois faz com que o título de cada documento que não está totalmente inicializado tenha o texto [Stub] no título.

Em HKEY_CURRENT_USER\Software\Microsoft\VisualStudio\14.0\BackgroundSolutionLoad, defina StubTabTitleFormatString como {0} [Stub].