載入 Vspackage

發行項
03/24/2017

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

只有需要其功能時，只有 VSPackages 會載入 Visual Studio。比方說，Visual Studio 會使用專案工廠或 VSPackage 實作的服務時，會載入 VSPackage。這項功能稱為延遲的載入，盡可能使用來改善效能。

注意

Visual Studio 可以判斷特定的 VSPackage 資訊，例如 VSPackage 提供，而不載入 VSPackage 的命令。

VSPackages 可以例如設定自動載入在特定的使用者介面 (UI) 內容中，開啟方案時。 ProvideAutoLoadAttribute屬性來設定此內容。

自動載入 VSPackage 中特定的內容

新增ProvideAutoLoad屬性設定為 VSPackage 屬性︰

[DefaultRegistryRoot(@"Software\Microsoft\VisualStudio\14.0")]  
[PackageRegistration(UseManagedResourcesOnly = true)]  
[ProvideAutoLoad(UIContextGuids80.SolutionExists)]  
[Guid("00000000-0000-0000-0000-000000000000")] // your specific package GUID  
public class MyAutoloadedPackage : Package  
{. . .}

請參閱列舉的欄位UIContextGuids80 UI 內容及其 GUID 值的清單。

在設定中斷點初始化方法。
建置 VSPackage 並開始偵錯。
載入方案或建立一個。

VSPackage 載入，並在中斷點停止。

強制載入 VSPackage

在某些情況下 VSPackage 可能強制另一個要載入的 VSPackage。例如，輕量型 VSPackage 可能會載入大 VSPackage 中不是 CMDUIContext 可用的內容。

您可以使用LoadPackage方法，以強制載入 VSPackage。

插入此程式碼至初始化VSPackage 可強制另一個載入 VSPackage 的方法︰

IVsShell shell = GetService(typeof(SVsShell)) as IVsShell;  
if (shell == null) return;  

IVsPackage package = null;  
Guid PackageToBeLoadedGuid =   
    new Guid(Microsoft.PackageToBeLoaded.GuidList.guidPackageToBeLoadedPkgString);  
shell.LoadPackage(ref PackageToBeLoadedGuid, out package);

當初始化 VSPackage 時，它會強制PackageToBeLoaded載入。

強制載入不應該用於 VSPackage 通訊。使用使用和提供服務改。

若要註冊的 VSPackage 中使用自訂屬性

在某些情況下，您可能需要建立新的註冊屬性，您的擴充功能。您可以使用註冊屬性，加入新的登錄機碼，或將新值加入至現有的索引鍵。新的屬性必須衍生自RegistrationAttribute，必須覆寫和註冊和取消註冊方法。

建立登錄機碼

下列程式碼，建立自訂屬性自訂VSPackage 所註冊之機碼下的子機碼。

public override void Register(RegistrationAttribute.RegistrationContext context)  
{  
    Key packageKey = null;  
    try  
    {   
        packageKey = context.CreateKey(@"Packages\{" + context.ComponentType.GUID + @"}\Custom");  
        packageKey.SetValue("NewCustom", 1);  
    }  
    finally  
    {  
        if (packageKey != null)  
            packageKey.Close();  
    }  
}  
  
public override void Unregister(RegistrationContext context)  
{  
    context.RemoveKey(@"Packages\" + context.ComponentType.GUID + @"}\Custom");  
}

建立現有的登錄機碼下的新值

您可以新增自訂值到現有的金鑰。下列程式碼示範如何將新值加入至 VSPackage 註冊金鑰。

public override void Register(RegistrationAttribute.RegistrationContext context)  
{  
    Key packageKey = null;  
    try  
    {   
        packageKey = context.CreateKey(@"Packages\{" + context.ComponentType.GUID + "}");  
        packageKey.SetValue("NewCustom", 1);  
    }  
    finally  
    {  
        if (packageKey != null)  
            packageKey.Close();  
                }  
}  
  
public override void Unregister(RegistrationContext context)  
{  
    context.RemoveValue(@"Packages\" + context.ComponentType.GUID, "NewCustom");  
}

另請參閱

Vspackage

共用方式為