RunInstallerAttribute Класс

Определение

Пространство имен:

System.ComponentModel

Сборки:

netstandard.dll, System.ComponentModel.TypeConverter.dll

Исходный код:

RunInstallerAttribute.cs

Указывает, следует ли вызывать установщик настраиваемых действий Visual Studio или Installutil.exe (средство установщика) при установке сборки.

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

Наследование

Object

Attribute

RunInstallerAttribute

Атрибуты

AttributeUsageAttribute

Примеры

В следующем примере указывается, что установщик должен выполняться для 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

В следующем примере создается экземпляр MyProjectInstaller. Затем он получает атрибуты для класса, извлекает RunInstallerAttributeи выводит, следует ли запускать установщик.

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

Комментарии

Если класс, наследуемый от Installer, помечается параметром RunInstallerAttribute значение true, то при установке сборки вызывается настраиваемый установщик действия Visual Studio или InstallUtil.exe. Члены, помеченные набором RunInstallerAttribute , false не вызывают установщик. Значение по умолчанию — true.

Note

При помечаете свойство с RunInstallerAttribute заданным значением true, значение этого атрибута присваивается постоянному члену Yes. Для свойства, помеченного набором RunInstallerAttributefalse, значение равно No. Таким образом, если вы хотите проверить значение этого атрибута в коде, необходимо указать атрибут как RunInstallerAttribute.Yes или RunInstallerAttribute.No.

Дополнительные сведения см. в разделе Атрибуты.

Конструкторы

Имя	Описание
RunInstallerAttribute(Boolean)	Инициализирует новый экземпляр класса RunInstallerAttribute.

Поля

Имя	Описание
Default	Указывает видимость по умолчанию, то есть No. Это static поле доступно только для чтения.
No	Указывает, что установщик пользовательских действий Visual Studio или Installutil.exe (средство установщика) не следует вызывать при установке сборки. Это static поле доступно только для чтения.
Yes	Указывает, что установщик пользовательских действий Visual Studio или Installutil.exe (средство установщика) следует вызывать при установке сборки. Это static поле доступно только для чтения.

Свойства

Имя	Описание
RunInstaller	Возвращает значение, указывающее, следует ли вызывать установщик во время установки сборки.
TypeId	При реализации в производном классе получает уникальный идентификатор для этого Attribute. (Унаследовано от Attribute)

Методы

Имя	Описание
Equals(Object)	Определяет, эквивалентно ли значение указанного значения RunInstallerAttribute текущему RunInstallerAttribute.
GetHashCode()	Создает хэш-код для текущего RunInstallerAttribute.
GetType()	Возвращает Type текущего экземпляра. (Унаследовано от Object)
IsDefaultAttribute()	Определяет, является ли этот атрибут значением по умолчанию.
Match(Object)	При переопределении в производном классе возвращает значение, указывающее, равен ли этот экземпляр указанному объекту. (Унаследовано от Attribute)
MemberwiseClone()	Создает неглубокую копию текущей Object. (Унаследовано от Object)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

См. также раздел

• Attribute
• Installer