Создание пользовательского элемента управления действием Configuration Manager
В Configuration Manager, чтобы создать настраиваемый элемент управления действием, вы создаете элемент управления Windows с помощью следующих двух классов:
Класс | Описание |
---|---|
SmsOsdEditorPageControl | Настраиваемый элемент управления действием. Наследуется от этого класса для реализации пользовательского элемента управления действием, отображаемого в редакторе последовательности задач. |
TaskSequenceOptionControl | Элемент управления "Параметры" для настраиваемого действия. Наследуется от этого класса для создания страницы параметров настраиваемого действия, отображаемой в редакторе последовательности задач. |
В этих процедурах показано, как создать сборку управления развертыванием Configuration Manager операционной системы с помощью Visual Studio 2005. При загрузке в редактор последовательности задач элемент управления отображает страницу свойств, содержащую текстовое поле, используемое для задания переменной действия имени пользователя для настраиваемого действия.
После выполнения этих действий выполните действия, описанные в следующих разделах, чтобы создать MOF-файл пользовательского управляемого объекта (MOF) и использовать настраиваемый элемент управления действием.
Создание MOF-файла для пользовательского действия Configuration Manager
Использование настраиваемого действия Configuration Manager
Примечание.
Сведения об использовании настраиваемого действия в рамках развертывания см. в разделе Сведения о клиентских приложениях Configuration Manager настраиваемых действий.
Проект Visual Studio для управления
Следующая процедура создает проект пользовательского элемента управления действием.
Создание элемента управления
В Visual Studio 2010 в меню Файл наведите указатель мыши на пункт Создать, а затем щелкните Проект , чтобы открыть диалоговое окно Новый проект .
В списке проектов Visual C#, Windows выберите шаблон проекта Библиотека элементов управления Windows и введите
ConfigMgrTSAction
в поле Имя .Нажмите кнопку ОК , чтобы создать проект Visual Studio.
В Обозреватель решений щелкните правой кнопкой мыши UserControl1.cs, выберите команду Переименовать, а затем измените имя на
ConfigMgrTSActionControl.cs
.В окне Обозреватель решений щелкните правой кнопкой мыши Ссылки, а затем выберите команду Добавить ссылку.
В диалоговом окне Добавление ссылки откройте вкладку Обзор, перейдите в папку %ProgramFiles%\Майкрософт Configuration Manager\AdminUI\bin, а затем выберите следующие сборки:
Adminui.osdcommon.dll
Adminui.tasksequenceeditor.dll
Adminui.wqlqueryengine.dll
Microsoft.configurationmanagement.exe
Microsoft.configurationmanagement.managementprovider.dll
Нажмите кнопку ОК , чтобы добавить сборки в качестве ссылок на проект.
В Обозреватель решений щелкните правой кнопкой мыши файл ConfigMgrTSActionControl.cs и выберите пункт Просмотреть код.
Добавьте следующий код, чтобы включить необходимые пространства имен:
using Microsoft.ConfigurationManagement.AdminConsole; using Microsoft.ConfigurationManagement.AdminConsole.TaskSequenceEditor;
Измените класс ConfigMgrTSActionControl , чтобы он был производным от SmsOsdEditorPageControl.
В файле ConfigMgrTSActionControl.cs добавьте следующий новый конструктор в класс ConfigMgrTSActionControl :
public ConfigMgrTSActionControl(SmsPageData data) : base(data) { InitializeComponent(); }
Добавьте следующий метод для инициализации элемента управления:
public override void InitializePageControl() { base.InitializePageControl(); }
Создание элемента управления "Параметры"
Следующая процедура создает код, объявляющий элемент управления options для настраиваемого действия. В этой реализации используется элемент управления параметрами по умолчанию.
Создание элемента управления options
В конце ConfigMgrTSActionControl.cs добавьте следующий новый класс в пространство имен ConfigMgrTSAction :
public class ConfigureTSActionOptions : TaskSequenceOptionControl { public ConfigureTSActionOptions() : base() { } public ConfigureTSActionOptions(SmsPageData data) : base(data) { } }
Настройка пользовательского интерфейса
Следующая процедура добавляет текстовое поле и код для управления данными действий.
Добавление пользовательского интерфейса
В Обозреватель решений щелкните правой кнопкой мыши файл ConfigMgrTSActionControl.cs и выберите пункт Конструктор представлений.
На панели элементов откройте вкладку Общие элементы управления , а затем дважды щелкните элемент TextBox. Кнопка с именем
textBox1
добавляется в элемент управления в конструкторе пользовательских элементов управления.Дважды щелкните текстовое поле. Обработчик событий с именем
textBox1_TextChanged
добавляется в класс ConfigMgrTSActionControl. Добавьте следующий код, чтобы убедиться, что изменения сохраняются в диспетчере свойств действия:SetDirtyFlag(true);
В классе 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); }
В конструкторе элемента управления дважды щелкните элемент управления, чтобы создать метод ConfigMgrTSActionControl_Load.
Добавьте следующий код в метод . Этот код загружает текстовое поле с существующим значением User. Это происходит, когда действие последовательности задач редактируется после его создания.
textBox1.Text = this.PropertyManager["User"].StringValue;
Строки ресурсов
Следующая процедура добавляет строки ресурсов, которые используются для отображения имени настраиваемого действия в редакторе последовательности задач.
Добавление строк ресурсов
В Обозреватель решений в меню Проект выберите пункт Свойства.
Перейдите на вкладку Ресурсы . Если файл ресурсов не существует, создайте его, выбрав сообщение, которое отображается на вкладке Ресурсы .
На панели инструментов конструктора ресурсов наведите указатель на раскрывающийся список представление ресурсов, щелкните стрелку и убедитесь, что для него задано значение Строки (по умолчанию). Появится сетка параметров, отображающая строки, которые поддерживаются этим экземпляром конструктора ресурсов.
Щелкните столбец Имя последней строки сетки, помеченной звездочкой (*).
В столбце Имя введите
DefaultDisplay_ConfigMgrTSAction
имя строки.В столбце Значение введите строку Настраиваемое действие. Это строка, отображаемая в списке действий последовательности задач.
Щелкните столбец Имя последней строки сетки, помеченной звездочкой (*).
В столбце Имя введите
ConfigMgrTSAction
имя строки.В столбце Значение введите
Custom Action
. Это строка, которая отображается при добавлении настраиваемого действия.
Развертывание сборки
Эта процедура создает и копирует созданную сборку в папку сборки консоли Configuration Manager. Важные сведения о развертывании расширений консоли Configuration Manager см. в разделе Сведения о развертывании расширения консоли администрирования Configuration Manager.
Развертывание сборки
Выполните построение проекта. Visual Studio создает сборку как \Visual Studio 2005\Projects\ConfigMgrControl\ConfigMgrTSAction\bin\Debug\ConfigMgrTSActionControl.dll.
Скопируйте сборку в папку %ProgramFiles%\Майкрософт Configuration Manager\AdminUI\bin.
См. также
Сведения о расширении консоли Configuration Manager
Развертывание расширения консоли Configuration Manager
Создание MOF-файла для пользовательского действия Configuration Manager
Использование настраиваемого действия Configuration Manager