RunInstallerAttribute Klasa

Definicja

Określa, czy Instalator akcji niestandardowej programu Visual Studio lub Installutil.exe (Narzędzie instalatora) powinien zostać wywołany podczas instalacji zestawu.Specifies whether the Visual Studio Custom Action Installer or the Installutil.exe (Installer Tool) should be invoked when the assembly is installed.

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
Dziedziczenie
RunInstallerAttribute
Atrybuty

Przykłady

Poniższy przykład określa, że Instalator powinien być uruchamiany dla programu MyProjectInstaller .The following example specifies that the installer should be run for 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

Następny przykład tworzy wystąpienie MyProjectInstaller .The next example creates an instance of MyProjectInstaller. Następnie pobiera atrybuty klasy, wyodrębnia RunInstallerAttribute i drukuje, czy ma być uruchamiany Instalator.Then it gets the attributes for the class, extracts the RunInstallerAttribute, and prints whether to run the installer.

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

Uwagi

Jeśli klasa, która dziedziczy z Installer , jest oznaczona RunInstallerAttribute zestawem do true , Instalator akcji niestandardowej programu Visual Studio lub InstallUtil.exe zostanie wywołana podczas instalacji zestawu.If a class that inherits from Installer is marked with the RunInstallerAttribute set to true, Visual Studio's Custom Action Installer or the InstallUtil.exe will be invoked when the assembly is installed. Elementy członkowskie oznaczone RunInstallerAttribute zestawem do false nie będą wywoływać Instalatora.Members marked with the RunInstallerAttribute set to false will not invoke an installer. Wartość domyślna to true.The default is true.

Uwaga

Po oznaczeniu właściwości RunInstallerAttribute zestawem do true , wartość tego atrybutu jest ustawiana na stałą składową Yes .When you mark a property with the RunInstallerAttribute set to true, the value of this attribute is set to the constant member Yes. Dla właściwości oznaczonej RunInstallerAttribute ustawieniem na false , wartość jest No .For a property marked with the RunInstallerAttribute set to false, the value is No. W związku z tym, jeśli chcesz sprawdzić wartość tego atrybutu w kodzie, musisz określić atrybut jako RunInstallerAttribute.Yes lub RunInstallerAttribute.No .Therefore, when you want to check the value of this attribute in your code, you must specify the attribute as RunInstallerAttribute.Yes or RunInstallerAttribute.No.

Aby uzyskać więcej informacji, zobacz atrybuty.For more information, see Attributes.

Konstruktory

RunInstallerAttribute(Boolean)

Inicjuje nowe wystąpienie klasy RunInstallerAttribute.Initializes a new instance of the RunInstallerAttribute class.

Pola

Default

Określa domyślną widoczność, która jest No .Specifies the default visibility, which is No. To static pole jest tylko do odczytu.This static field is read-only.

No

Określa, że Instalator niestandardowej akcji programu Visual Studio lub Installutil.exe (Narzędzie instalatora) nie powinien być wywoływany podczas instalacji zestawu.Specifies that the Visual Studio Custom Action Installer or the Installutil.exe (Installer Tool) should not be invoked when the assembly is installed. To static pole jest tylko do odczytu.This static field is read-only.

Yes

Określa, że Instalator akcji niestandardowej programu Visual Studio lub Installutil.exe (Narzędzie instalatora) powinien zostać wywołany podczas instalacji zestawu.Specifies that the Visual Studio Custom Action Installer or the Installutil.exe (Installer Tool) should be invoked when the assembly is installed. To static pole jest tylko do odczytu.This static field is read-only.

Właściwości

RunInstaller

Pobiera wartość wskazującą, czy Instalator ma być wywoływany podczas instalacji zestawu.Gets a value indicating whether an installer should be invoked during installation of an assembly.

TypeId

Po zaimplementowaniu w klasie pochodnej pobiera unikatowy identyfikator dla tego elementu Attribute .When implemented in a derived class, gets a unique identifier for this Attribute.

(Odziedziczone po Attribute)

Metody

Equals(Object)

Określa, czy wartość określona RunInstallerAttribute jest równoważna z bieżącym RunInstallerAttribute .Determines whether the value of the specified RunInstallerAttribute is equivalent to the current RunInstallerAttribute.

GetHashCode()

Generuje kod skrótu dla bieżącego RunInstallerAttribute .Generates a hash code for the current RunInstallerAttribute.

GetType()

Pobiera Type bieżące wystąpienie.Gets the Type of the current instance.

(Odziedziczone po Object)
IsDefaultAttribute()

Określa, czy ten atrybut jest wartością domyślną.Determines if this attribute is the default.

Match(Object)

Gdy jest zastępowany w klasie pochodnej, zwraca wartość wskazującą, czy to wystąpienie jest zgodne z określonym obiektem.When overridden in a derived class, returns a value that indicates whether this instance equals a specified object.

(Odziedziczone po Attribute)
MemberwiseClone()

Tworzy skróconą kopię bieżącego elementu Object .Creates a shallow copy of the current Object.

(Odziedziczone po Object)
ToString()

Zwraca ciąg reprezentujący bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)

Jawne implementacje interfejsu

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Zestaw nazw jest mapowany na odpowiedni zestaw identyfikatorów wysyłania.Maps a set of names to a corresponding set of dispatch identifiers.

(Odziedziczone po Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Pobiera informacje o typie dla obiektu, którego można użyć do uzyskania informacji o typie dla interfejsu.Retrieves the type information for an object, which can be used to get the type information for an interface.

(Odziedziczone po Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Pobiera informację o liczbie typów interfejsów, jakie zawiera obiekt (0 lub 1).Retrieves the number of type information interfaces that an object provides (either 0 or 1).

(Odziedziczone po Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Umożliwia dostęp do właściwości i metod udostępnianych przez obiekt.Provides access to properties and methods exposed by an object.

(Odziedziczone po Attribute)

Dotyczy

Zobacz też