RunInstallerAttribute Classe

Définition

Espace de noms:

System.ComponentModel

Assembly:

System.dll

Spécifie si le programme d’installation d’actions personnalisées Visual Studio ou l'Installutil.exe (outil Programme d’installation) doit être appelé lorsque l’assembly est installé.

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

Héritage

Object

Attribute

RunInstallerAttribute

Attributs

AttributeUsageAttribute

Exemples

L’exemple suivant spécifie que le programme d’installation doit être exécuté pour MyProjectInstaller.

[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

L’exemple suivant crée une instance de MyProjectInstaller. Ensuite, il obtient les attributs de la classe, extrait le RunInstallerAttribute, et imprime s’il faut exécuter le programme d’installation.

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

Remarques

Si une classe qui hérite de Installer est marquée avec le RunInstallerAttribute défini sur true, le programme d'installation d'action personnalisée de Visual Studio ou le InstallUtil.exe sera appelé lors de l'installation de l'assembly. Les membres marqués avec le RunInstallerAttribute jeu à false ne pas appeler un programme d’installation. La valeur par défaut est true.

Note

Lorsque vous marquez une propriété avec la RunInstallerAttributetruevaleur définie sur , la valeur de cet attribut est définie sur le membre Yesconstant . Pour une propriété marquée avec la RunInstallerAttribute valeur définie false, la valeur est No. Par conséquent, lorsque vous souhaitez vérifier la valeur de cet attribut dans votre code, vous devez spécifier l’attribut en tant que RunInstallerAttribute.Yes ou RunInstallerAttribute.No.

Pour plus d’informations, consultez Attributs.

Constructeurs

Nom	Description
RunInstallerAttribute(Boolean)	Initialise une nouvelle instance de la classe RunInstallerAttribute.

Champs

Nom	Description
Default	Spécifie la visibilité par défaut, qui est No. Ce static champ est en lecture seule.
No	Spécifie que le programme d’installation d’actions personnalisées Visual Studio ou l'Installutil.exe (outil Programme d’installation) ne doit pas être appelé lorsque l’assembly est installé. Ce static champ est en lecture seule.
Yes	Spécifie que le programme d’installation d’actions personnalisées Visual Studio ou l'Installutil.exe (outil Programme d’installation) doit être appelé lors de l’installation de l’assembly. Ce static champ est en lecture seule.

Propriétés

Nom	Description
RunInstaller	Obtient une valeur indiquant si un programme d’installation doit être appelé pendant l’installation d’un assembly.
TypeId	En cas d’implémentation dans une classe dérivée, obtient un identificateur unique pour cette Attribute. (Hérité de Attribute)

Méthodes

Nom	Description
Equals(Object)	Détermine si la valeur du spécifié RunInstallerAttribute est équivalente à la valeur actuelle RunInstallerAttribute.
GetHashCode()	Génère un code de hachage pour le code de hachage actuel RunInstallerAttribute.
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
IsDefaultAttribute()	Détermine si cet attribut est la valeur par défaut.
Match(Object)	En cas de substitution dans une classe dérivée, retourne une valeur qui indique si cette instance est égale à un objet spécifié. (Hérité de Attribute)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
ToString()	Retourne une chaîne qui représente l’objet actuel. (Hérité de Object)

Implémentations d’interfaces explicites

Nom	Description
_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Mappe un jeu de noms avec un jeu correspondant d'identificateurs de dispatch. (Hérité de Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Récupère les informations de type d’un objet, qui peuvent être utilisées pour obtenir les informations de type d’une interface. (Hérité de Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Récupère le nombre d'interfaces d'informations de type fourni par un objet (0 ou 1). (Hérité de Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Fournit l’accès aux propriétés et méthodes exposées par un objet. (Hérité de Attribute)

Voir aussi

• Attribute
• Installer