ProvideProfileAttribute(Type, String, String, Int16, Int16, Boolean) Konstruktor

Definition

Initialisiert eine neue Instanz von provide profileattribute.

public:
 ProvideProfileAttribute(Type ^ objectType, System::String ^ categoryName, System::String ^ objectName, short categoryResourceID, short objectNameResourceID, bool isToolsOptionPage);
public:
 ProvideProfileAttribute(Platform::Type ^ objectType, Platform::String ^ categoryName, Platform::String ^ objectName, short categoryResourceID, short objectNameResourceID, bool isToolsOptionPage);
public ProvideProfileAttribute (Type objectType, string categoryName, string objectName, short categoryResourceID, short objectNameResourceID, bool isToolsOptionPage);
new Microsoft.VisualStudio.Shell.ProvideProfileAttribute : Type * string * string * int16 * int16 * bool -> Microsoft.VisualStudio.Shell.ProvideProfileAttribute
Public Sub New (objectType As Type, categoryName As String, objectName As String, categoryResourceID As Short, objectNameResourceID As Short, isToolsOptionPage As Boolean)

Parameter

objectType
Type

Der Type der Klasse, die die Unterstützung für Visual Studio-Einstellungen implementiert.

categoryName
String

Der kanonische, nicht lokalisierte Name einer Visual Studio-Einstellungs Kategorie.

objectName
String

Der kanonische, nicht lokalisierte Name, mit dem das Objekt identifiziert wird, das eine Visual Studio-Einstellungs Kategorie implementiert.

categoryResourceID
Int16

Die lokalisierte Ressourcen-ID des Namens einer Visual Studio-Einstellungs Kategorie.

objectNameResourceID
Int16

Die lokalisierte Ressourcen-ID des Namens, der zum Identifizieren des Objekts verwendet wird, das eine Visual Studio-Einstellungs Kategorie implementiert.

isToolsOptionPage
Boolean

Dieses Argument ist nicht implementiert.

Beispiele

Das folgende Beispiel zeigt die Registrierung von zwei Klassen, die-Einstellungen bereitstellen Visual Studio , von denen eine ( DesignerOptionsPage ) Unterstützung für Tool Optionen bietet. Die Paket-und kategorieguids werden durch das-Attribut durch Reflektion abgerufen.

Der benutzerdefinierte Einstellungs Punkt für die Seite mit dem Namen "designeroptionspage" lautet wie folgt:

MyDesigner_OptionPage

MyDesigner_OptionPage \ @ = #1003

MyDesigner_OptionPage \Package = {"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"}

MyDesigner_OptionPage \category = {"yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy"}

MyDesigner_OptionPage \abwechselparent = mydesigner

Hinweis

Der letzte obige Eintrag (UserSettings \ MyDesigner_OptionPage \alternativen Parent) ist vorhanden, da isToolsOptionPage ist true .

Der benutzerdefinierte Einstellungs Punkt für die Seite mit dem Namen "persistcurrentdesign" lautet wie folgt:

Currentdesign MyDesigner_

MyDesigner_ currentdesign \ @ = #1005 >

MyDesigner_ currentdesign\Package = {"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"}

MyDesigner_ currentdesign\category = {"zzzzzzzz-zzzz-zzzz-zzzz-zzzzzzzzzzzz"}>

Hinweis

Es ist kein (MyDesigner_ objectName> \alternativen Parent) vorhanden, da isToolsOptionPage ist false .

Der folgende Beispielcode veranschaulicht, wie designeroptionspage mit registriert wird ProvideProfileAttribute .

using Microsoft.VisualStudio.Shell;  
namespace Example  
{  
[DefaultRegistryRoot("Software\\Microsoft\\VisualStudio\\8.0")]   
[ProvideOptionPage(typeof(DesignerOptionsPage), "MyDesigner", "OptionPage", 1000, 1001, true)]   
[ProvideProfileAttribute(typeof(DesignerOptionsPage), "MyDesigner", "OptionPage", 1002, 1003, true)]  
[ProvideProfileAttribute(typeof(PersistCurrentDesign), "MyDesigner","CurrentDesign", 1004, 1005, false)]  
 [Guid("XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX")]  
public class MyPackage : Package  
{  
//Implementation here  
}  

[Guid("YYYYYYYY-YYYY-YYYY-YYYY-YYYYYYYYYYYY")]  
internal class DesignerOptionsPage: DialogPage {  
//Implementation here  
}  

[Guid("ZZZZZZZZ-ZZZZ-ZZZZ-ZZZZ-ZZZZZZZZZZZZ")]  
internal class PersisteDesignerState: IProfileManager {  
//Implementation here  

Hinweise

Der ProvideProfileAttribute Konstruktor verwendet die GUID aus objectType , um die Einstellungs Kategorie eines benutzerdefinierten Einstellungs Punkts eindeutig zu identifizieren Visual Studio .

Wenn isToolsOptionPage ist true , ProvideOptionPageAttribute muss auch auf das VSPackage angewendet werden.

Benutzerdefinierte Einstellungs Punkte werden innerhalb eines Registrierungs Eintrags mit dem kanonischen Namen der Form <CategoryName> _ erstellt <ObjectName> .

Der Registrierungsschlüssel befindet sich unter hklm\software\microsoft\visualstudio \ <Version> \usersettings <Version> , wobei die Version von ist Visual Studio , z. b. 8,0.

Der Registrierungs Eintrag unter _ hat folgendes Format <CategoryName> <ObjectName> :

<CategoryName> _ <ObjectName>

<CategoryName> _ <ObjectName>\@=#<ObjectNameResourceID>

<CategoryName> _ <ObjectName> \Package =<Package>

<CategoryName> _ <ObjectName> \Category =<ObjectTypeGuid>

<CategoryName> _ <ObjectName> \Alternative Parent =<CategoryName >

Hinweis

Der letzte obige Eintrag ( <CategoryName> _ <ObjectName> \alternativen Parent) wird nur erstellt, wenn den Wert hat isToolsOptionPage true .

Gilt für