延遲的文件載入

 

如需 Visual Studio 2017 的最新文件請參閱 Visual Studio 2017 文件。

當使用者重新開啟 Visual Studio 方案時，大部分的相關聯的文件並不會立即載入。 文件視窗框架中會建立為擱置中初始化的狀態，並且預留位置文件 （稱為虛設常式框架） 會執行文件資料表 (RDT) 中。

您的擴充功能可能會導致不必要地藉由查詢文件中的項目，在載入之前載入的專案文件。 Visual studio，這樣會增加整體的記憶體耗用量。

文件載入

當使用者存取文件，例如藉由選取的視窗框架] 索引標籤，虛設常式框架和文件會完全初始化。 文件也可以初始化要求文件的資料，藉由存取 RDT 直接以取得文件資料，或藉由下列呼叫的其中一個間接存取 RDT 延伸模組︰

• 視窗框架顯示方法︰顯示。

• 視窗框架 GetProperty 方法GetProperty任何下列屬性︰

  • VSFPROPID_DocView

  • VSFPROPID_ViewHelper

  • VSFPROPID_DocData

  • VSFPROPID_AltDocData

  • VSFPROPID_RDTDocData

  • VSFPROPID_SPProjContext

如果您的擴充功能會使用 managed 程式碼，您不應該呼叫GetDocumentInfo除非您確定文件不是處於暫止的初始化狀態，或您想要完全初始化文件... 這是因為此方法一律會傳回文件資料物件，如有必要，請建立它。 相反地，您應該將其中一個方法呼叫 IVsRunningDocumentTable4 介面上。

如果您的擴充功能會使用 c + +，您可以傳遞null您不想使用的參數。

您可以避免不必要的文件載入您要求相關的屬性之前呼叫下列方法之一︰ 您有要求其他屬性之前。

• GetProperty使用VSFPROPID_PendingInitialization。

• GetDocumentFlags。 這個方法會傳回_VSRDTFLAGS4物件，其中包含的值RDT_PendingInitialization尚未初始化文件時。

藉由訂閱在完全初始化文件時，會引發 RDT 事件已載入文件時，您可以找出。 有兩種可能性︰

• 如果事件接收器實作IVsRunningDocTableEvents2，您可以訂閱OnAfterAttributeChangeEx，

• 否則，您可以訂閱OnAfterAttributeChange。

以下是假設文件存取案例。 Visual Studio 擴充功能要顯示開啟的文件的部分資訊，例如編輯鎖定計數和一些關於文件資料。 它會列舉 RDT 使用中的文件IEnumRunningDocuments，然後呼叫GetDocumentInfo擷取編輯鎖定計數和文件資料的每份文件。 如果文件處於暫止的初始化狀態時，文件資料的要求會使它不必要地初始化。

這是使用更有效率的方式，這種做法GetDocumentEditLockCount來取得編輯鎖定計數，然後使用GetDocumentFlags來判斷是否已初始化文件。 如果未包含旗標RDT_PendingInitialization，文件已經初始化，並要求使用的文件資料GetDocumentData不會造成任何不必要的初始化。 如果包含旗標RDT_PendingInitialization，擴充功能應該避免初始化文件之前，要求文件資料。 這可以偵測 OnAfterAttributeChange(Ex) 事件處理常式中。

測試以查看它們強制執行初始化的擴充功能

沒有可見的提示，指出是否已初始化文件，所以您可能會難以找出初始化時，是否要強制您的擴充功能。 您可以設定登錄機碼，使驗證更容易，因為它會使文字並未完全初始化每個文件的標題[Stub]標題中。

在HKEY_CURRENT_USER\Software\Microsoft\VisualStudio\14.0\BackgroundSolutionLoad]，請將StubTabTitleFormatString至**{0} [Stub]**。