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.11.0 (在 Microsoft.VisualStudio.Modeling.Sdk.Shell.11.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$ 之後設定選擇性子路徑。只有能夠探查的組件位於不同的目錄，比 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 會尋找組件的資料夾清單，如果您安裝了許多具有這個屬性的套件可能會注意到的效能。

封裝繫結的 Path 屬性的運作方式

這個屬性會產生您的套裝中的項目**.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

其他資源

部署網域指定的語言方案