InstalledProductRegistrationAttribute クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
この属性は、パッケージの 'インストール済み製品' を登録します。
これにより、パッケージで VS Splash Screen または Help About に情報を表示できます。
public ref class InstalledProductRegistrationAttribute sealed : Microsoft::VisualStudio::Shell::RegistrationAttribute
public ref class InstalledProductRegistrationAttribute sealed : Microsoft::VisualStudio::Shell::RegistrationAttribute
[System.AttributeUsage(System.AttributeTargets.Class, Inherited=false)]
public sealed class InstalledProductRegistrationAttribute : Microsoft.VisualStudio.Shell.RegistrationAttribute
[<System.AttributeUsage(System.AttributeTargets.Class, Inherited=false)>]
type InstalledProductRegistrationAttribute = class
inherit RegistrationAttribute
Public NotInheritable Class InstalledProductRegistrationAttribute
Inherits RegistrationAttribute
- 継承
- 属性
注釈
呼び出すタイミング
この属性を VSPackage クラスに適用して、Visual Studio のスプラッシュ画面と [ ヘルプの概要 ] ダイアログ ボックスに表示される情報を提供します。
基本的な使用方法
オブジェクトをInstalledProductRegistrationAttribute
Createして、VSPackage を [ヘルプの概要] ダイアログ ボックスに登録します。 さまざまなコンストラクターは、インターフェイス (パッケージによって実装される) を使用 IVsInstalledProduct して情報を収集し、Visual Studio のスプラッシュ画面に表示するオプションを提供します。 この属性を使用するには、VSPackage クラス (から Package 派生したクラスまたは を実装するクラス) に配置します IVsPackage。
この属性は、regpkg.exe などの外部登録ツールのデータを提供するためにのみ使用されます。 VSPackage のランタイム動作には影響しません。 詳細については、「 VSPackage の登録」を参照してください。
注意
Visual C# では、属性クラスの名前に " 属性 " という単語が自動的に追加されます。 Visual C# コードで、この属性を InstalledProductRegistration と参照します。
レジストリ エントリ
によって次のレジストリ エントリが作成 InstalledProductRegistrationAttribute
されます。
<VSROOT>\CLSID\{PackageGuid}
<VSROOT>\CLSID\{PackageGuid}\@=ObjectType.FullName
<VSROOT>\CLSID\{PackageGuid}\InprocServer32=mscoree.dll
<VSROOT>\CLSID\{PackageGuid}\Class=ObjectType.FullName
<VSROOT>\CLSID\{PackageGuid}\Assembly=ObjectType.Assembly.FullName
<VSROOT>\CLSID\{PackageGuid}\ThreadingModel=Both
<VSROOT>\CLSID\{PackageGuid}\CodeBase=context。コードベース
<VSROOT>\CLSID\{PackageGuid}\SatelliteDll
<VSROOT>\CLSID\{PackageGuid}\SatelliteDll\Path=SatelliteDllPath
<VSROOT>\CLSID\{PackageGuid}\SatelliteDll\DllName=SatelliteDllName
サンプル
この属性と自動登録に使用されるその他すべての属性の標準の場所は、サンプルで使用される言語に応じて、VsPkg.cs、VsPkg.vb、またはVsPkg.cppでの の実装 Package に隣接しています。
コンストラクター
InstalledProductRegistrationAttribute(String, String, String) |
新しい InstalledProductRegistrationAttribute を作成して、ヘルプ/バージョン情報ダイアログにパッケージを登録します。 これは、サード パーティ製パッケージに必要な最も簡単な登録情報です。 製品の詳細を指定することは要件ではありませんが、推奨されます。 |
プロパティ
IconResourceID |
アイコンのリソース ID。 |
LanguageIndependentName |
製品の名前。 |
ProductDetails |
製品の詳細な説明。 |
ProductDetailsResourceID |
詳細のリソース ID。 |
ProductId |
製品 ID。 |
ProductName |
製品の名前。 |
ProductNameResourceID |
製品名に対応するリソース ID。 |
TypeId |
RegistrationAttribute 派生クラスが System.ComponentModel.TypeDescriptor.GetAttributes(...) と連携できるように、TypeID プロパティをオーバーライドします。このプロパティから派生した属性は、クラスに適用できるインスタンスをより適切に制御する必要がある場合にのみ、このプロパティをオーバーライドする必要があります。 (継承元 RegistrationAttribute) |
UseInterface |
IVsInstalledProduct を使用して、ダイアログに関するヘルプを入力します。 パッケージは、IVsInstalledProduct を実装する必要があります。 |
UsePackage |
True を指定すると、製品のインストールでパッケージ ID が使用されます |
UseVsProductId |
True は、製品 ID が VisualStudio ID と同じであり、Microsoft の内部使用のために予約されています。 サード パーティ製パッケージは、クラスの構築時に独自の製品 ID を提供する必要があります。 |
メソッド
GetPackageRegKeyPath(Guid) |
VSPackage のレジストリ パス (アプリケーションのレジストリ ルートに対する相対パス) を取得します。 (継承元 RegistrationAttribute) |
Register(RegistrationAttribute+RegistrationContext) |
指定されたコンテキストでこの属性を登録します。 |
Unregister(RegistrationAttribute+RegistrationContext) |
この InstalledProducts エントリの登録を解除します。 |