ProvideBindingPathAttribute 類別

這個屬性可讓其他封裝和擴充功能使用您的Visual Studio封裝或擴充功能中的組件。 它會將安裝套件的目錄加入至 Visual Studio 探查清單中，此探查清單用來解析組件參考。

繼承階層架構

System.Object
  System.Attribute
    Microsoft.VisualStudio.Shell.RegistrationAttribute
      Microsoft.VisualStudio.Modeling.Shell.ProvideBindingPathAttribute

命名空間：  Microsoft.VisualStudio.Modeling.Shell
組件：  Microsoft.VisualStudio.Modeling.Sdk.Shell.12.0 (在 Microsoft.VisualStudio.Modeling.Sdk.Shell.12.0.dll 中)

語法

'宣告
<AttributeUsageAttribute(AttributeTargets.Class, AllowMultiple := True, Inherited := True)> _
Public NotInheritable Class ProvideBindingPathAttribute _
    Inherits RegistrationAttribute

[AttributeUsageAttribute(AttributeTargets.Class, AllowMultiple = true, Inherited = true)]
public sealed class ProvideBindingPathAttribute : RegistrationAttribute

ProvideBindingPathAttribute 類型會公開下列成員。

建構函式

	名稱	描述
	ProvideBindingPathAttribute

回頁首

屬性

	名稱	描述
	SubPath	要在 $PackageFolder$ 之後設定的選擇性 SubPath。如果要探查的組件位在與 pkgdef 檔案不同的目錄，就必須使用此項目。
	TypeId	(繼承自 RegistrationAttribute)。

回頁首

方法

	名稱	描述
	Equals	基礎架構。傳回數值，表示這個執行個體是否等於指定的物件。 (繼承自 Attribute)。
	GetHashCode	傳回這個執行個體的雜湊碼。 (繼承自 Attribute)。
	GetType	取得目前執行個體的 Type。 (繼承自 Object)。
	IsDefaultAttribute	在衍生類別中覆寫時，表示這個執行個體的值是否為衍生類別的預設值。 (繼承自 Attribute)。
	Match	在衍生類別中覆寫時，會傳回值，表示這個執行個體是否等於指定物件。 (繼承自 Attribute)。
	Register	註冊元件路徑 (或元件路徑的選擇性子路徑)，作為額外的路徑，Visual Studio 中的組件管理員嘗試解析組件時會進行探查。當封裝已安裝時呼叫。 (覆寫 RegistrationAttribute.Register(RegistrationAttribute.RegistrationContext)。)
	ToString	傳回表示目前物件的字串。 (繼承自 Object)。
	Unregister	移除註冊做為繫結路徑的元件路徑。解除安裝封裝時呼叫。 (覆寫 RegistrationAttribute.Unregister(RegistrationAttribute.RegistrationContext)。)

回頁首

明確介面實作

	名稱	描述
	_Attribute.GetIDsOfNames	將一組名稱對應至一組對應的分派識別項 (Dispatch Identifier)。 (繼承自 Attribute)。
	_Attribute.GetTypeInfo	擷取物件的型別資訊，可以用來取得介面的型別資訊。 (繼承自 Attribute)。
	_Attribute.GetTypeInfoCount	擷取物件提供的型別資訊介面數目 (0 或 1)。 (繼承自 Attribute)。
	_Attribute.Invoke	提供物件所公開的屬性和方法的存取權。 (繼承自 Attribute)。

回頁首

備註

注意事項
這項資訊適用於 Visual Studio 2010。另一個將在以後的版本中可能會提供。

如果您希望您的封裝或擴充功能的組件可以看見其他擴充功能，您應該套用這個屬性設定為您的套件類別或您的組件。 例如：

[ProvideBindingPath] 
public class MyVsPackage : Microsoft.VisualStudio.Shell.Package 
{ ... }

如果您使用視覺化和模型 SDK 建立網域指定的語言 (DSL)，則 DslPackage\Package.cs會自動套用。

如果您未建置 DSL，請將下列檔案加入您的專案:

%VSSDKInstallDir%\VisualStudioIntegration\Common\Source\CSharp\RegistrationAttributes\ProvideBindingPathAttribute.cs

如果您的封裝組件子目錄中相對於 .pkgdef 檔案，您可以使用這個變數:

[ProvideBindingPath(SubPath="SubFolder1")] 
public class MyPackage : Microsoft.VisualStudio.Shell.Package 
{ ... }

如果您要指定數個目錄，您可以使用一個以上的 ProvideBindingPath 屬性。

警告

由於這個屬性來擴充 Visual Studio 尋找組件資料夾的清單，您可能會注意到效能的置放，如果您安裝了這個屬性有許多套件。

封裝繫結路徑屬性的運作方式

這個屬性會在專案的封裝的 .pkgdef 檔案中的項目，您可以在組建資料夾中找到。 當您的封裝在目標電腦上時，安裝這個接著會在登錄中建立項目。 登錄項目提供應該為候選組件探查路徑，當其他組件載入時。

例如， .pkgdef 輸入類似這樣:

[$RootKey$\BindingPaths\您的封裝的 GUID。]"$PackageFolder$"=""

將套件安裝在目標電腦上安裝時，註冊項目將在 HKEY_CURRENT_USER\Software\Microsoft\VisualStudio\11.0_Config\BindingPaths\您的封裝的 GUID。。 輸入包含表示封裝的安裝資料夾的字串屬性。

執行緒安全

這個類型的任何 Public static (在 Visual Basic 中為 Shared) 成員都是安全執行緒。不保證任何執行個體成員是安全執行緒。

請參閱

參考

Microsoft.VisualStudio.Modeling.Shell 命名空間

Package

其他資源

部署網域指定的語言方案