ProvideProfileAttribute(Type, String, String, Int16, Int16, Boolean) Konstruktor
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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 .