ControlParser.ParseControl Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Создает элемент управления из указанной разметки.
Перегрузки
ParseControl(IDesignerHost, String) |
Создает элемент управления из заданной разметки, используя указанный сайт конструктора. |
ParseControl(IDesignerHost, String, String) |
Создает элемент управления из заданной разметки, используя указанный сайт конструктора и директивы. |
ParseControl(IDesignerHost, String)
Создает элемент управления из заданной разметки, используя указанный сайт конструктора.
public:
static System::Web::UI::Control ^ ParseControl(System::ComponentModel::Design::IDesignerHost ^ designerHost, System::String ^ controlText);
public static System.Web.UI.Control ParseControl (System.ComponentModel.Design.IDesignerHost designerHost, string controlText);
static member ParseControl : System.ComponentModel.Design.IDesignerHost * string -> System.Web.UI.Control
Public Shared Function ParseControl (designerHost As IDesignerHost, controlText As String) As Control
Параметры
- designerHost
- IDesignerHost
Экземпляр IDesignerHost, являющийся сайтом конструктора для страницы.
- controlText
- String
Разметка HTML для элемента управления.
Возвращаемое значение
Элемент управления Control, представляемый свойством controlText; в противном случае значение null
, если средство синтаксического разбора не может построить элемент управления.
Исключения
Недействительный параметр.
Примеры
В следующем примере кода показано, как создать элемент управления из текста разметки HTML. Этот пример входит в состав более крупного примера использования класса ControlParser.
// Create a Web control from the persisted control String*.
System::Web::UI::Control^ ctrl = ControlParser::ParseControl( host, inputForm->tbox->Text->Trim() );
// Create a Web control from the HTML markup.
System.Web.UI.Control ctrl =
ControlParser.ParseControl(host, inputForm.TBox.Text.Trim());
' Create a Web control from the persisted control string.
Dim ctrl As System.Web.UI.Control = ControlParser.ParseControl(host, inputForm.TxBox.Text.Trim())
Комментарии
Метод ParseControl обращается к строке, представляющей директивы register на веб-странице ASP.NET, используя службы узла конструктора. Службы узла конструктора ReferenceManager получаются с помощью свойства RootDesigner объекта или, если это недоступно, IWebFormReferenceManager службы.
Метод ParseControl создает исключение, если средство синтаксического анализа не может создать элемент управления .
См. также раздел
- Расширение поддержки времени разработки
- Практическое руководство. Расширение внешнего вида и функциональности элементов управления в режиме конструктора
Применяется к
ParseControl(IDesignerHost, String, String)
Создает элемент управления из заданной разметки, используя указанный сайт конструктора и директивы.
public:
static System::Web::UI::Control ^ ParseControl(System::ComponentModel::Design::IDesignerHost ^ designerHost, System::String ^ controlText, System::String ^ directives);
public static System.Web.UI.Control ParseControl (System.ComponentModel.Design.IDesignerHost designerHost, string controlText, string directives);
static member ParseControl : System.ComponentModel.Design.IDesignerHost * string * string -> System.Web.UI.Control
Public Shared Function ParseControl (designerHost As IDesignerHost, controlText As String, directives As String) As Control
Параметры
- designerHost
- IDesignerHost
Экземпляр IDesignerHost, являющийся сайтом конструктора для страницы.
- controlText
- String
Текст разметки HTML для элемента управления.
- directives
- String
Директивы страницы, включаемые в код элемента управления.
Возвращаемое значение
Объект Control, представляемый параметром controlText
.
Исключения
Недействительный параметр.
Примеры
В следующем примере кода показано, как создать элемент управления из текста разметки HTML. Этот пример входит в состав более крупного примера использования класса ControlParser.
// Create a Web control from the persisted control String*.
System::Web::UI::Control^ ctrl = ControlParser::ParseControl( host, inputForm->tbox->Text->Trim() );
// Create a Web control from the HTML markup.
System.Web.UI.Control ctrl =
ControlParser.ParseControl(host, inputForm.TBox.Text.Trim());
' Create a Web control from the persisted control string.
Dim ctrl As System.Web.UI.Control = ControlParser.ParseControl(host, inputForm.TxBox.Text.Trim())
Комментарии
Метод ParseControl обращается к строке, представляющей директивы register на веб-странице ASP.NET, используя службы узла конструктора. Службы узла конструктора ReferenceManager получаются с помощью свойства RootDesigner объекта или, если это недоступно, IWebFormReferenceManager службы.
Метод ParseControl создает исключение, если средство синтаксического анализа не может создать элемент управления .
См. также раздел
- Расширение поддержки времени разработки
- Практическое руководство. Расширение внешнего вида и функциональности элементов управления в режиме конструктора