HtmlGenericControl Класс

Ссылка

Определение

Пространство имен:: System.Web.UI.HtmlControls

Сборка:: System.Web.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Определяет методы, свойства и события для всех элементов управления СЕРВЕРА HTML, не представленных определенным классом .NET Framework.

public ref class HtmlGenericControl : System::Web::UI::HtmlControls::HtmlContainerControl

public class HtmlGenericControl : System.Web.UI.HtmlControls.HtmlContainerControl

type HtmlGenericControl = class
    inherit HtmlContainerControl

Public Class HtmlGenericControl
Inherits HtmlContainerControl

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

Control

HtmlControl

HtmlContainerControl
HtmlGenericControl

Производный: System.Web.UI.HtmlControls.HtmlHead

Примеры

В следующем примере кода показано, как использовать класс HtmlGenericControl для представления элемента <body>.

<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

  protected void SubmitBtn_Click(object sender, EventArgs e)
  {
    Body.Attributes["bgcolor"] = ColorSelect.Value;
  }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
  <title>HtmlGenericControl Example</title> 
</head>
 
<body id="Body" 
      runat="server">
 
     <h3>HtmlGenericControl Example</h3>
 
     <form id="form1" runat="server">
     <div>
       <br />
       Select a background color for the page: <br />
       <select id="ColorSelect" 
               runat="server">
           <option>White</option>
           <option>LightBlue</option>
           <option>LightGreen</option>
           <option>Yellow</option>
       </select>
 
       <input type="submit" 
              runat="server" 
              value="Apply" 
              onserverclick="SubmitBtn_Click" id="Submit1" />
     </div>
     </form>
 
 </body>
 </html>

<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
  
  Protected Sub SubmitBtn_Click(ByVal sender As Object, ByVal e As System.EventArgs)

    Body.Attributes("bgcolor") = ColorSelect.Value

  End Sub
  
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
  <title>HtmlGenericControl Example</title> 
</head>
 
<body id="Body" 
      runat="server">
 
     <h3>HtmlGenericControl Example</h3>
 
     <form id="form1" runat="server">
     <div>
       <br />
       Select a background color for the page: <br />
       <select id="ColorSelect" 
               runat="server">
           <option>White</option>
           <option>LightBlue</option>
           <option>LightGreen</option>
           <option>Yellow</option>
       </select>
 
       <input type="submit" 
              runat="server" 
              value="Apply" 
              onserverclick="SubmitBtn_Click" id="Submit1" />
     </div> 
     </form>
 
 </body>
 </html>

Этот класс используется для представления элемента управления сервером HTML, который не представлен непосредственно классом .NET Framework, например <span>, <div>, <body>или <font>.

Список начальных значений свойств для экземпляра HtmlGenericControlсм. в конструкторе HtmlGenericControl.

Осторожность

Этот элемент управления можно использовать для отображения входных данных пользователей, которые могут включать вредоносный скрипт клиента. Проверьте все сведения, отправляемые клиентом для исполняемого скрипта, инструкций SQL или другого кода перед отображением в приложении. ASP.NET предоставляет функцию проверки входных запросов для блокировки скрипта и HTML в входных данных пользователя. Серверные элементы управления проверки также предоставляются для оценки входных данных пользователей. Дополнительные сведения см. в синтаксисе управления сервером проверки и проверке входных данных пользователей в ASP.NET веб-страниц.

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

HtmlGenericControl()	Инициализирует новый экземпляр класса HtmlGenericControl со значениями по умолчанию.
HtmlGenericControl(String)	Инициализирует новый экземпляр класса HtmlGenericControl с указанным тегом.

Свойства

Adapter	Возвращает адаптер, зависящий от браузера, для элемента управления. (Унаследовано от Control)
AppRelativeTemplateSourceDirectory	Возвращает или задает относительный к приложению виртуальный каталог объекта Page или UserControl, содержащего этот элемент управления. (Унаследовано от Control)
Attributes	Возвращает коллекцию всех пар имени атрибута и значений, выраженных на теге элемента управления сервером на странице ASP.NET. (Унаследовано от HtmlControl)
BindingContainer	Возвращает элемент управления, содержащий привязку данных этого элемента управления. (Унаследовано от Control)
ChildControlsCreated	Возвращает значение, указывающее, были ли созданы дочерние элементы управления сервера. (Унаследовано от Control)
ClientID	Возвращает идентификатор элемента управления для разметки HTML, созданной ASP.NET. (Унаследовано от Control)
ClientIDMode	Возвращает или задает алгоритм, используемый для создания значения свойства ClientID. (Унаследовано от Control)
ClientIDSeparator	Возвращает значение символа, представляющее символ разделителя, используемый в свойстве ClientID. (Унаследовано от Control)
Context	Возвращает объект HttpContext, связанный с серверным элементом управления для текущего веб-запроса. (Унаследовано от Control)
Controls	Возвращает объект ControlCollection, представляющий дочерние элементы управления для указанного серверного элемента управления в иерархии пользовательского интерфейса. (Унаследовано от Control)
DataItemContainer	Возвращает ссылку на контейнер именования, если контейнер именования реализует IDataItemContainer. (Унаследовано от Control)
DataKeysContainer	Возвращает ссылку на контейнер именования, если контейнер именования реализует IDataKeysControl. (Унаследовано от Control)
DesignMode	Возвращает значение, указывающее, используется ли элемент управления на поверхности конструктора. (Унаследовано от Control)
Disabled	Возвращает или задает значение, указывающее, отключен ли элемент управления HTML-сервера. (Унаследовано от HtmlControl)
EnableTheming	Возвращает или задает значение, указывающее, применяются ли темы к этому элементу управления. (Унаследовано от Control)
EnableViewState	Возвращает или задает значение, указывающее, сохраняет ли серверный элемент управления состояние представления и состояние представления всех дочерних элементов управления, содержащихся в нем, для запрашивающего клиента. (Унаследовано от Control)
Events	Возвращает список делегатов обработчика событий для элемента управления. Это свойство доступно только для чтения. (Унаследовано от Control)
HasChildViewState	Получает значение, указывающее, имеют ли дочерние элементы управления текущего элемента управления серверным элементом управления какие-либо сохраненные параметры состояния представления. (Унаследовано от Control)
ID	Возвращает или задает программный идентификатор, назначенный элементу управления сервером. (Унаследовано от Control)
IdSeparator	Возвращает символ, используемый для разделения идентификаторов элемента управления. (Унаследовано от Control)
InnerHtml	Возвращает или задает содержимое, найденного между открывающим и закрывающим тегами указанного элемента управления HTML-сервера. (Унаследовано от HtmlContainerControl)
InnerText	Возвращает или задает текст между открывающим и закрывающим тегами указанного элемента управления HTML-сервера. (Унаследовано от HtmlContainerControl)
IsChildControlStateCleared	Возвращает значение, указывающее, имеют ли элементы управления, содержащиеся в этом элементе управления, состояние элемента управления. (Унаследовано от Control)
IsTrackingViewState	Возвращает значение, указывающее, сохраняется ли серверная система управления изменениями в состоянии представления. (Унаследовано от Control)
IsViewStateEnabled	Возвращает значение, указывающее, включено ли состояние представления для этого элемента управления. (Унаследовано от Control)
LoadViewStateByID	Возвращает значение, указывающее, участвует ли элемент управления в загрузке состояния представления по ID вместо индекса. (Унаследовано от Control)
NamingContainer	Возвращает ссылку на контейнер именования серверного элемента управления, который создает уникальное пространство имен для различения между элементами управления сервера с одинаковым значением свойства ID. (Унаследовано от Control)
Page	Возвращает ссылку на экземпляр Page, содержащий серверный элемент управления. (Унаследовано от Control)
Parent	Возвращает ссылку на родительский элемент управления сервера в иерархии элементов управления страницами. (Унаследовано от Control)
RenderingCompatibility	Возвращает значение, указывающее версию ASP.NET, с которым будет совместим отрисованный HTML. (Унаследовано от Control)
Site	Получает сведения о контейнере, на котором размещается текущий элемент управления при отрисовки на поверхности конструктора. (Унаследовано от Control)
SkinID	Возвращает или задает кожу, применяемую к элементу управления. (Унаследовано от Control)
Style	Возвращает коллекцию всех каскадных свойств таблицы стилей (CSS), примененных к указанному элементу управления HTML-сервера в файле ASP.NET. (Унаследовано от HtmlControl)
TagName	Возвращает или задает имя HTML-элемента, представленного элементом управления HtmlGenericControl.
TemplateControl	Возвращает или задает ссылку на шаблон, содержащий этот элемент управления. (Унаследовано от Control)
TemplateSourceDirectory	Возвращает виртуальный каталог Page или UserControl, содержащий текущий серверный элемент управления. (Унаследовано от Control)
UniqueID	Возвращает уникальный иерархический идентификатор для элемента управления сервером. (Унаследовано от Control)
ValidateRequestMode	Возвращает или задает значение, указывающее, проверяет ли элемент управления входные данные клиента из браузера для потенциально опасных значений. (Унаследовано от Control)
ViewState	Получает словарь сведений о состоянии, позволяющий сохранять и восстанавливать состояние представления серверного элемента управления в нескольких запросах на одну и ту же страницу. (Унаследовано от Control)
ViewStateIgnoresCase	Возвращает значение, указывающее, учитывается ли состояние представления HtmlControl регистром. (Унаследовано от HtmlControl)
ViewStateMode	Возвращает или задает режим состояния представления этого элемента управления. (Унаследовано от Control)
Visible	Возвращает или задает значение, указывающее, отображается ли серверный элемент управления в виде пользовательского интерфейса на странице. (Унаследовано от Control)

Методы

AddedControl(Control, Int32)	Вызывается после добавления дочернего элемента управления в коллекцию Controls объекта Control. (Унаследовано от Control)
AddParsedSubObject(Object)	Уведомляет серверный элемент управления о том, что элемент , XML или HTML, был проанализирован, и добавляет элемент в объект ControlCollection элемента управления сервера. (Унаследовано от Control)
ApplyStyleSheetSkin(Page)	Применяет свойства стиля, определенные в таблице стилей страницы, к элементу управления. (Унаследовано от Control)
BeginRenderTracing(TextWriter, Object)	Начинает трассировку данных отрисовки во время разработки. (Унаследовано от Control)
BuildProfileTree(String, Boolean)	Собирает сведения о серверном элементе управления и передает его свойству Trace, которое будет отображаться при включении трассировки для страницы. (Унаследовано от Control)
ClearCachedClientID()	Задает кэшированное значение ClientID значение `null`. (Унаследовано от Control)
ClearChildControlState()	Удаляет сведения о состоянии элемента управления для дочерних элементов управления сервера. (Унаследовано от Control)
ClearChildState()	Удаляет сведения о состоянии представления и состояния элемента управления для всех дочерних элементов управления сервера. (Унаследовано от Control)
ClearChildViewState()	Удаляет сведения о состоянии представления для всех дочерних элементов управления сервера. (Унаследовано от Control)
ClearEffectiveClientIDMode()	Задает свойство ClientIDMode текущего экземпляра элемента управления и всех дочерних элементов управления для Inherit. (Унаследовано от Control)
CreateChildControls()	Вызывается платформой страницы ASP.NET, чтобы уведомить серверные элементы управления, использующие реализацию на основе композиции, чтобы создать все дочерние элементы управления, содержащиеся в подготовке к публикации обратной или отрисовки. (Унаследовано от Control)
CreateControlCollection()	Создает новый объект ControlCollection для хранения дочерних элементов управления (как литерала, так и сервера) элемента управления сервером. (Унаследовано от HtmlContainerControl)
DataBind()	Привязывает источник данных к вызываемой серверной системе управления и всем дочерним элементам управления. (Унаследовано от Control)
DataBind(Boolean)	Привязывает источник данных к вызываемой серверной системе управления и всем дочерним элементам управления с возможностью вызвать событие DataBinding. (Унаследовано от Control)
DataBindChildren()	Привязывает источник данных к дочерним элементам управления сервера. (Унаследовано от Control)
Dispose()	Позволяет элементу управления сервера выполнять окончательную очистку перед освобождением из памяти. (Унаследовано от Control)
EndRenderTracing(TextWriter, Object)	Завершает трассировку времени разработки данных отрисовки. (Унаследовано от Control)
EnsureChildControls()	Определяет, содержит ли серверный элемент управления дочерние элементы управления. Если это не так, он создает дочерние элементы управления. (Унаследовано от Control)
EnsureID()	Создает идентификатор для элементов управления, которым не назначен идентификатор. (Унаследовано от Control)
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
FindControl(String, Int32)	Выполняет поиск текущего контейнера именования для элемента управления сервером с указанным `id` и целым числом, указанным в параметре `pathOffset`, который помогает в поиске. Эту версию метода FindControl не следует переопределять. (Унаследовано от Control)
FindControl(String)	Выполняет поиск текущего контейнера именования для элемента управления сервером с указанным параметром `id`. (Унаследовано от Control)
Focus()	Задает фокус ввода элементу управления. (Унаследовано от Control)
GetAttribute(String)	Возвращает значение именованного атрибута в элементе управления HtmlControl. (Унаследовано от HtmlControl)
GetDesignModeState()	Возвращает данные во время разработки для элемента управления. (Унаследовано от Control)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetRouteUrl(Object)	Возвращает URL-адрес, соответствующий набору параметров маршрута. (Унаследовано от Control)
GetRouteUrl(RouteValueDictionary)	Возвращает URL-адрес, соответствующий набору параметров маршрута. (Унаследовано от Control)
GetRouteUrl(String, Object)	Получает URL-адрес, соответствующий набору параметров маршрута и имени маршрута. (Унаследовано от Control)
GetRouteUrl(String, RouteValueDictionary)	Получает URL-адрес, соответствующий набору параметров маршрута и имени маршрута. (Унаследовано от Control)
GetType()	Возвращает Type текущего экземпляра. (Унаследовано от Object)
GetUniqueIDRelativeTo(Control)	Возвращает префиксированную часть свойства UniqueID указанного элемента управления. (Унаследовано от Control)
HasControls()	Определяет, содержит ли серверный элемент управления какие-либо дочерние элементы управления. (Унаследовано от Control)
HasEvents()	Возвращает значение, указывающее, регистрируются ли события для элемента управления или любых дочерних элементов управления. (Унаследовано от Control)
IsLiteralContent()	Определяет, содержит ли серверный элемент управления только литеральное содержимое. (Унаследовано от Control)
LoadControlState(Object)	Восстанавливает сведения о состоянии элемента управления из предыдущего запроса страницы, сохраненного методом SaveControlState(). (Унаследовано от Control)
LoadViewState(Object)	Восстанавливает состояние представления элемента управления HtmlContainerControl из предыдущего запроса страницы, сохраненного методом SaveViewState(). (Унаследовано от HtmlContainerControl)
MapPathSecure(String)	Извлекает физический путь, с которым сопоставляется виртуальный путь( абсолютный или относительный). (Унаследовано от Control)
MemberwiseClone()	Создает неглубокую копию текущей Object. (Унаследовано от Object)
OnBubbleEvent(Object, EventArgs)	Определяет, передается ли событие для элемента управления сервером пользовательского интерфейса страницы. (Унаследовано от Control)
OnDataBinding(EventArgs)	Вызывает событие DataBinding. (Унаследовано от Control)
OnInit(EventArgs)	Вызывает событие Init. (Унаследовано от Control)
OnLoad(EventArgs)	Вызывает событие Load. (Унаследовано от Control)
OnPreRender(EventArgs)	Вызывает событие PreRender. (Унаследовано от Control)
OnUnload(EventArgs)	Вызывает событие Unload. (Унаследовано от Control)
OpenFile(String)	Получает Stream, используемый для чтения файла. (Унаследовано от Control)
RaiseBubbleEvent(Object, EventArgs)	Назначает любые источники события и ее сведения родительскому элементу управления. (Унаследовано от Control)
RemovedControl(Control)	Вызывается после удаления дочернего элемента управления из коллекции Controls объекта Control. (Унаследовано от Control)
Render(HtmlTextWriter)	Отрисовывает элемент управления HtmlContainerControl в указанный объект HtmlTextWriter. (Унаследовано от HtmlContainerControl)
RenderAttributes(HtmlTextWriter)	Отрисовывает атрибуты элемента управления HtmlContainerControl в указанный объект HtmlTextWriter. (Унаследовано от HtmlContainerControl)
RenderBeginTag(HtmlTextWriter)	Отрисовывает открывающий HTML-тег элемента управления в указанный объект HtmlTextWriter. (Унаследовано от HtmlControl)
RenderChildren(HtmlTextWriter)	Выводит содержимое дочерних элементов управления сервера в предоставленный объект HtmlTextWriter, который записывает содержимое, которое будет отображаться на клиенте. (Унаследовано от Control)
RenderControl(HtmlTextWriter, ControlAdapter)	Выводит содержимое сервера управления в предоставленный объект HtmlTextWriter с помощью предоставленного объекта ControlAdapter. (Унаследовано от Control)
RenderControl(HtmlTextWriter)	Выводит содержимое сервера управления в предоставленный объект HtmlTextWriter и сохраняет сведения о трассировке элемента управления, если трассировка включена. (Унаследовано от Control)
RenderEndTag(HtmlTextWriter)	Отрисовывает закрывающий тег элемента управления HtmlContainerControl указанному объекту HtmlTextWriter. (Унаследовано от HtmlContainerControl)
ResolveAdapter()	Возвращает адаптер управления, отвечающий за отрисовку указанного элемента управления. (Унаследовано от Control)
ResolveClientUrl(String)	Получает URL-адрес, который может использоваться браузером. (Унаследовано от Control)
ResolveUrl(String)	Преобразует URL-адрес в url-адрес, который можно использовать на запрашиваемом клиенте. (Унаследовано от Control)
SaveControlState()	Сохраняет все изменения состояния управления сервером, которые произошли с момента публикации страницы на сервер. (Унаследовано от Control)
SaveViewState()	Сохраняет все изменения состояния представления представления сервера, которые произошли с момента отправки страницы на сервер. (Унаследовано от Control)
SetAttribute(String, String)	Задает значение именованного атрибута в элементе управления HtmlControl. (Унаследовано от HtmlControl)
SetDesignModeState(IDictionary)	Задает данные во время разработки для элемента управления. (Унаследовано от Control)
SetRenderMethodDelegate(RenderMethod)	Назначает делегат обработчика событий для отрисовки элемента управления сервером и его содержимого в родительский элемент управления. (Унаследовано от Control)
SetTraceData(Object, Object, Object)	Задает данные трассировки для трассировки данных отрисовки во время разработки, используя объект трассировки, ключ данных трассировки и значение данных трассировки. (Унаследовано от Control)
SetTraceData(Object, Object)	Задает данные трассировки для трассировки данных отрисовки во время разработки, используя ключ данных трассировки и значение данных трассировки. (Унаследовано от Control)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)
TrackViewState()	Вызывает отслеживание изменений состояния представления в серверном элементе управления, чтобы они могли храниться в StateBag объекте серверного элемента управления. Этот объект доступен через свойство ViewState. (Унаследовано от Control)

События

DataBinding	Происходит, когда серверный элемент управления привязывается к источнику данных. (Унаследовано от Control)
Disposed	Происходит при освобождении серверного элемента управления из памяти, который является последним этапом жизненного цикла управления сервера при запросе страницы ASP.NET. (Унаследовано от Control)
Init	Происходит при инициализации серверного элемента управления, который является первым шагом в его жизненном цикле. (Унаследовано от Control)
Load	Происходит при загрузке серверного элемента управления в объект Page. (Унаследовано от Control)
PreRender	Происходит после загрузки объекта Control, но до отрисовки. (Унаследовано от Control)
Unload	Происходит при выгрузке серверного элемента управления из памяти. (Унаследовано от Control)

Явные реализации интерфейса

IAttributeAccessor.GetAttribute(String)	Описание этого элемента см. в разделе GetAttribute(String). (Унаследовано от HtmlControl)
IAttributeAccessor.SetAttribute(String, String)	Описание этого элемента см. в разделе SetAttribute(String, String). (Унаследовано от HtmlControl)
IControlBuilderAccessor.ControlBuilder	Описание этого элемента см. в разделе ControlBuilder. (Унаследовано от Control)
IControlDesignerAccessor.GetDesignModeState()	Описание этого элемента см. в разделе GetDesignModeState(). (Унаследовано от Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Описание этого элемента см. в разделе SetDesignModeState(IDictionary). (Унаследовано от Control)
IControlDesignerAccessor.SetOwnerControl(Control)	Описание этого элемента см. в разделе SetOwnerControl(Control). (Унаследовано от Control)
IControlDesignerAccessor.UserData	Описание этого элемента см. в разделе UserData. (Унаследовано от Control)
IDataBindingsAccessor.DataBindings	Описание этого элемента см. в разделе DataBindings. (Унаследовано от Control)
IDataBindingsAccessor.HasDataBindings	Описание этого элемента см. в разделе HasDataBindings. (Унаследовано от Control)
IExpressionsAccessor.Expressions	Описание этого элемента см. в разделе Expressions. (Унаследовано от Control)
IExpressionsAccessor.HasExpressions	Описание этого элемента см. в разделе HasExpressions. (Унаследовано от Control)
IParserAccessor.AddParsedSubObject(Object)	Описание этого элемента см. в разделе AddParsedSubObject(Object). (Унаследовано от Control)

Методы расширения

FindDataSourceControl(Control)	Возвращает источник данных, связанный с элементом управления данными для указанного элемента управления.
FindFieldTemplate(Control, String)	Возвращает шаблон поля для указанного столбца в контейнере именования указанного элемента управления.
FindMetaTable(Control)	Возвращает объект метатабли для содержащего элемента управления данными.

Применяется к

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

HtmlContainerControl

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