RunInstallerAttribute Klasse

Definition

Namespace:

System.ComponentModel

Assembly:

System.dll

Gibt an, ob das Visual Studio benutzerdefinierte Aktionsinstallationsprogramm oder das Installutil.exe (Installer Tool) beim Installieren der Assembly aufgerufen werden soll.

public ref class RunInstallerAttribute : Attribute

[System.AttributeUsage(System.AttributeTargets.Class)]
public class RunInstallerAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Class)>]
type RunInstallerAttribute = class
    inherit Attribute

Public Class RunInstallerAttribute
Inherits Attribute

Vererbung

Object

Attribute

RunInstallerAttribute

Attribute

AttributeUsageAttribute

Beispiele

Im folgenden Beispiel wird angegeben, dass das Installationsprogramm ausgeführt MyProjectInstallerwerden soll.

[RunInstallerAttribute(true)]
ref class MyProjectInstaller: public Installer{
   // Insert code here.
};

[RunInstallerAttribute(true)]
 public class MyProjectInstaller : Installer {
    // Insert code here.
 }

<RunInstallerAttribute(True)> _
Public Class MyProjectInstaller
    Inherits Installer

    ' Insert code here.
End Class

Im nächsten Beispiel wird eine Instanz von MyProjectInstaller. Anschließend werden die Attribute für die Klasse extrahiert RunInstallerAttributeund gedruckt, ob das Installationsprogramm ausgeführt werden soll.

int main()
{
   // Creates a new installer.
   MyProjectInstaller^ myNewProjectInstaller = gcnew MyProjectInstaller;

   // Gets the attributes for the collection.
   AttributeCollection^ attributes = TypeDescriptor::GetAttributes( myNewProjectInstaller );

   /* Prints whether to run the installer by retrieving the 
       * RunInstallerAttribute from the AttributeCollection. */
   RunInstallerAttribute^ myAttribute = dynamic_cast<RunInstallerAttribute^>(attributes[ RunInstallerAttribute::typeid ]);
   Console::WriteLine( "Run the installer? {0}", myAttribute->RunInstaller );
   return 0;
}

public static int Main() {
    // Creates a new installer.
    MyProjectInstaller myNewProjectInstaller = new MyProjectInstaller();
 
    // Gets the attributes for the collection.
    AttributeCollection attributes = TypeDescriptor.GetAttributes(myNewProjectInstaller);
 
    /* Prints whether to run the installer by retrieving the 
     * RunInstallerAttribute from the AttributeCollection. */
    RunInstallerAttribute myAttribute = 
       (RunInstallerAttribute)attributes[typeof(RunInstallerAttribute)];
    Console.WriteLine("Run the installer? " + myAttribute.RunInstaller.ToString());
  
    return 0;
 }

Public Shared Function Main() As Integer
    ' Creates a new installer.
    Dim myNewProjectInstaller As New MyProjectInstaller()
    
    ' Gets the attributes for the collection.
    Dim attributes As AttributeCollection = TypeDescriptor.GetAttributes(myNewProjectInstaller)
    
    ' Prints whether to run the installer by retrieving the
    ' RunInstallerAttribute from the AttributeCollection. 
    Dim myAttribute As RunInstallerAttribute = _
        CType(attributes(GetType(RunInstallerAttribute)), RunInstallerAttribute)

    Console.WriteLine(("Run the installer? " & myAttribute.RunInstaller.ToString()))
    Return 0
End Function 'Main

Hinweise

Wenn eine Klasse, die von Installer erbt, mit dem RunInstallerAttribute auf true festgelegt ist, wird das installationsprogramm für benutzerdefinierte Aktionen Visual Studio oder die InstallUtil.exe aufgerufen, wenn die Assembly installiert ist. Elemente, die mit der RunInstallerAttribute Einstellung gekennzeichnet sind, false rufen kein Installationsprogramm auf. Der Standardwert lautet true.

Note

Wenn Sie eine Eigenschaft mit dem RunInstallerAttribute Wert auf "Set" truemarkieren, wird der Wert dieses Attributs auf das konstante Element Yesfestgelegt. Bei einer Eigenschaft, die mit dem RunInstallerAttribute Satz auf false" markiert ist , lautet Noder Wert . Wenn Sie daher den Wert dieses Attributs in Ihrem Code überprüfen möchten, müssen Sie das Attribut als RunInstallerAttribute.Yes oder RunInstallerAttribute.No.

Weitere Informationen finden Sie unter Attribute.

Konstruktoren

Name	Beschreibung
RunInstallerAttribute(Boolean)	Initialisiert eine neue Instanz der RunInstallerAttribute-Klasse.

Felder

Name	Beschreibung
Default	Gibt die Standardsichtbarkeit an. Dies ist No. Dieses static Feld ist schreibgeschützt.
No	Gibt an, dass das Visual Studio benutzerdefinierte Aktionsinstallationsprogramm oder das Installutil.exe (Installer Tool) nicht aufgerufen werden soll, wenn die Assembly installiert ist. Dieses static Feld ist schreibgeschützt.
Yes	Gibt an, dass das Visual Studio benutzerdefinierte Aktionsinstallationsprogramm oder das Installutil.exe (Installer Tool) aufgerufen werden soll, wenn die Assembly installiert ist. Dieses static Feld ist schreibgeschützt.

Eigenschaften

Name	Beschreibung
RunInstaller	Ruft einen Wert ab, der angibt, ob ein Installationsprogramm während der Installation einer Assembly aufgerufen werden soll.
TypeId	Wenn sie in einer abgeleiteten Klasse implementiert wird, wird ein eindeutiger Bezeichner für diese Attribute. (Geerbt von Attribute)

Methoden

Name	Beschreibung
Equals(Object)	Bestimmt, ob der Wert des angegebenen RunInstallerAttribute Werts dem aktuellen RunInstallerAttributeentspricht.
GetHashCode()	Generiert einen Hashcode für den aktuellen RunInstallerAttribute.
GetType()	Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
IsDefaultAttribute()	Bestimmt, ob dieses Attribut die Standardeinstellung ist.
Match(Object)	Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird ein Wert zurückgegeben, der angibt, ob diese Instanz einem angegebenen Objekt entspricht. (Geerbt von Attribute)
MemberwiseClone()	Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Explizite Schnittstellenimplementierungen

Name	Beschreibung
_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Ordnet eine Reihe von Namen einer entsprechenden Reihe von Dispatchbezeichnern zu. (Geerbt von Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Ruft die Typinformationen für ein Objekt ab, mit denen die Typinformationen für eine Schnittstelle abgerufen werden können. (Geerbt von Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Ruft die Anzahl der Schnittstellen mit Typinformationen ab, die von einem Objekt bereitgestellt werden (0 oder 1). (Geerbt von Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Bietet Zugriff auf Eigenschaften und Methoden, die von einem Objekt verfügbar gemacht werden. (Geerbt von Attribute)

Weitere Informationen

• Attribute
• Installer