Diese Dokumentation wurde archiviert und wird nicht länger gepflegt.

RunInstallerAttribute-Klasse

Aktualisiert: November 2007

Gibt an, ob bei der Installation der Assembly der Installer für benutzerdefinierte Aktionen von Visual Studio oder Installer-Tool (Installutil.exe) aufgerufen werden soll.

Namespace:  System.ComponentModel
Assembly:  System (in System.dll)

[AttributeUsageAttribute(AttributeTargets.Class)]
public class RunInstallerAttribute : Attribute
/** @attribute AttributeUsageAttribute(AttributeTargets.Class) */
public class RunInstallerAttribute extends Attribute
public class RunInstallerAttribute extends Attribute

Wenn eine Klasse, die von Installer erbt, mit RunInstallerAttribute mit dem Wert true markiert ist, wird beim Installieren der Assembly der Installer für benutzerdefinierte Aktionen von Visual Studio oder InstallUtil.exe aufgerufen. Mit RunInstallerAttribute mit dem Wert false markierte Member rufen keinen Installer auf. Der Standardwert ist false.

2ya9dxy9.alert_note(de-de,VS.90).gifHinweis:

Wenn Sie eine Eigenschaft mit RunInstallerAttribute mit dem Wert true markieren, wird der Wert dieses Attributs auf den konstanten Member Yes festgelegt. Für eine mit RunInstallerAttribute mit dem Wert false markierte Eigenschaft ist der Wert No. Wenn Sie den Wert dieses Attributs im Code überprüfen möchten, müssen Sie deshalb das Attribut als RunInstallerAttribute.Yes oder RunInstallerAttribute.No angeben.

Weitere Informationen finden Sie unter Übersicht über Attribute und Erweitern von Metadaten mithilfe von Attributen.

Im folgenden Beispiel wird angegeben, dass der Installer für MyProjectInstaller ausgeführt werden soll.

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


/** @attribute RunInstallerAttribute(true)
 */
public static class MyProjectInstaller extends Installer
{
    // Insert code here.
} //MyProjectInstaller


Im folgenden Beispiel wird eine Instanz von MyProjectInstaller erstellt. Anschließend werden die Attribute für die Klasse abgerufen, RunInstallerAttribute extrahiert und ausgegeben, ob der Installer ausgeführt werden soll.

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 static void main(String[] args)
{
    // 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.get_Item(
        RunInstallerAttribute.class.ToType())));

    Console.WriteLine(("Run the installer? " 
        + System.Convert.ToString(myAttribute.get_RunInstaller())));
} //main


System.Object
  System.Attribute
    System.ComponentModel.RunInstallerAttribute

Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

.NET Framework

Unterstützt in: 3.5, 3.0, 2.0, 1.1, 1.0
Anzeigen: