Поделиться через


Создание пользовательского элемента управления действием Configuration Manager

В Configuration Manager, чтобы создать настраиваемый элемент управления действием, вы создаете элемент управления Windows с помощью следующих двух классов:

Класс Описание
SmsOsdEditorPageControl Настраиваемый элемент управления действием. Наследуется от этого класса для реализации пользовательского элемента управления действием, отображаемого в редакторе последовательности задач.
TaskSequenceOptionControl Элемент управления "Параметры" для настраиваемого действия. Наследуется от этого класса для создания страницы параметров настраиваемого действия, отображаемой в редакторе последовательности задач.

В этих процедурах показано, как создать сборку управления развертыванием Configuration Manager операционной системы с помощью Visual Studio 2005. При загрузке в редактор последовательности задач элемент управления отображает страницу свойств, содержащую текстовое поле, используемое для задания переменной действия имени пользователя для настраиваемого действия.

После выполнения этих действий выполните действия, описанные в следующих разделах, чтобы создать MOF-файл пользовательского управляемого объекта (MOF) и использовать настраиваемый элемент управления действием.

Создание MOF-файла для пользовательского действия Configuration Manager

Использование настраиваемого действия Configuration Manager

Примечание.

Сведения об использовании настраиваемого действия в рамках развертывания см. в разделе Сведения о клиентских приложениях Configuration Manager настраиваемых действий.

Проект Visual Studio для управления

Следующая процедура создает проект пользовательского элемента управления действием.

Создание элемента управления

  1. В Visual Studio 2010 в меню Файл наведите указатель мыши на пункт Создать, а затем щелкните Проект , чтобы открыть диалоговое окно Новый проект .

  2. В списке проектов Visual C#, Windows выберите шаблон проекта Библиотека элементов управления Windows и введите ConfigMgrTSAction в поле Имя .

  3. Нажмите кнопку ОК , чтобы создать проект Visual Studio.

  4. В Обозреватель решений щелкните правой кнопкой мыши UserControl1.cs, выберите команду Переименовать, а затем измените имя на ConfigMgrTSActionControl.cs.

  5. В окне Обозреватель решений щелкните правой кнопкой мыши Ссылки, а затем выберите команду Добавить ссылку.

  6. В диалоговом окне Добавление ссылки откройте вкладку Обзор, перейдите в папку %ProgramFiles%\Майкрософт Configuration Manager\AdminUI\bin, а затем выберите следующие сборки:

    • Adminui.osdcommon.dll

    • Adminui.tasksequenceeditor.dll

    • Adminui.wqlqueryengine.dll

    • Microsoft.configurationmanagement.exe

    • Microsoft.configurationmanagement.managementprovider.dll

  7. Нажмите кнопку ОК , чтобы добавить сборки в качестве ссылок на проект.

  8. В Обозреватель решений щелкните правой кнопкой мыши файл ConfigMgrTSActionControl.cs и выберите пункт Просмотреть код.

  9. Добавьте следующий код, чтобы включить необходимые пространства имен:

    using Microsoft.ConfigurationManagement.AdminConsole;  
    using Microsoft.ConfigurationManagement.AdminConsole.TaskSequenceEditor;  
    
  10. Измените класс ConfigMgrTSActionControl , чтобы он был производным от SmsOsdEditorPageControl.

  11. В файле ConfigMgrTSActionControl.cs добавьте следующий новый конструктор в класс ConfigMgrTSActionControl :

    public ConfigMgrTSActionControl(SmsPageData data) : base(data)   
    {   
        InitializeComponent();   
    }  
    
  12. Добавьте следующий метод для инициализации элемента управления:

    public override void InitializePageControl()  
    {  
       base.InitializePageControl();  
    }  
    

Создание элемента управления "Параметры"

Следующая процедура создает код, объявляющий элемент управления options для настраиваемого действия. В этой реализации используется элемент управления параметрами по умолчанию.

Создание элемента управления options

  • В конце ConfigMgrTSActionControl.cs добавьте следующий новый класс в пространство имен ConfigMgrTSAction :

    public class ConfigureTSActionOptions : TaskSequenceOptionControl  
    {  
        public ConfigureTSActionOptions() : base()   
        {  
        }  
        public ConfigureTSActionOptions(SmsPageData data) : base(data)   
        {  
        }  
    }  
    
    

Настройка пользовательского интерфейса

Следующая процедура добавляет текстовое поле и код для управления данными действий.

Добавление пользовательского интерфейса

  1. В Обозреватель решений щелкните правой кнопкой мыши файл ConfigMgrTSActionControl.cs и выберите пункт Конструктор представлений.

  2. На панели элементов откройте вкладку Общие элементы управления , а затем дважды щелкните элемент TextBox. Кнопка с именем textBox1 добавляется в элемент управления в конструкторе пользовательских элементов управления.

  3. Дважды щелкните текстовое поле. Обработчик событий с именем textBox1_TextChanged добавляется в класс ConfigMgrTSActionControl. Добавьте следующий код, чтобы убедиться, что изменения сохраняются в диспетчере свойств действия:

    SetDirtyFlag(true);  
    
  4. В классе ConfigMgrTSActionControl добавьте следующий метод, чтобы записать значение User текстового поля в свойство, определенное в MOF пользовательского действия. Вызывается при нажатии кнопки ОК или Применить .

    protected override bool ApplyChanges(out Control errorControl, out bool showError)  
    {  
        // You can check the error here and return false.  
        if (this.HasError(out errorControl) == true)  
        {  
            this.ShowMessageBox(  
                this.GetErrorString(),  
                "Error",  
                MessageBoxButtons.OK,  
                MessageBoxIcon.Warning);  
            errorControl = null;  
            showError = true;  
            return false;  
        }  
        this.PropertyManager["User"].StringValue = textBox1.Text;  
    
        return base.ApplyChanges(out errorControl, out showError);  
    }  
    
  5. В конструкторе элемента управления дважды щелкните элемент управления, чтобы создать метод ConfigMgrTSActionControl_Load.

  6. Добавьте следующий код в метод . Этот код загружает текстовое поле с существующим значением User. Это происходит, когда действие последовательности задач редактируется после его создания.

    textBox1.Text = this.PropertyManager["User"].StringValue;  
    

Строки ресурсов

Следующая процедура добавляет строки ресурсов, которые используются для отображения имени настраиваемого действия в редакторе последовательности задач.

Добавление строк ресурсов

  1. В Обозреватель решений в меню Проект выберите пункт Свойства.

  2. Перейдите на вкладку Ресурсы . Если файл ресурсов не существует, создайте его, выбрав сообщение, которое отображается на вкладке Ресурсы .

  3. На панели инструментов конструктора ресурсов наведите указатель на раскрывающийся список представление ресурсов, щелкните стрелку и убедитесь, что для него задано значение Строки (по умолчанию). Появится сетка параметров, отображающая строки, которые поддерживаются этим экземпляром конструктора ресурсов.

  4. Щелкните столбец Имя последней строки сетки, помеченной звездочкой (*).

  5. В столбце Имя введите DefaultDisplay_ConfigMgrTSAction имя строки.

  6. В столбце Значение введите строку Настраиваемое действие. Это строка, отображаемая в списке действий последовательности задач.

  7. Щелкните столбец Имя последней строки сетки, помеченной звездочкой (*).

  8. В столбце Имя введите ConfigMgrTSAction имя строки.

  9. В столбце Значение введите Custom Action. Это строка, которая отображается при добавлении настраиваемого действия.

Развертывание сборки

Эта процедура создает и копирует созданную сборку в папку сборки консоли Configuration Manager. Важные сведения о развертывании расширений консоли Configuration Manager см. в разделе Сведения о развертывании расширения консоли администрирования Configuration Manager.

Развертывание сборки

  1. Выполните построение проекта. Visual Studio создает сборку как \Visual Studio 2005\Projects\ConfigMgrControl\ConfigMgrTSAction\bin\Debug\ConfigMgrTSActionControl.dll.

  2. Скопируйте сборку в папку %ProgramFiles%\Майкрософт Configuration Manager\AdminUI\bin.

См. также

Сведения о расширении консоли Configuration Manager
Развертывание расширения консоли Configuration Manager
Создание MOF-файла для пользовательского действия Configuration Manager
Использование настраиваемого действия Configuration Manager