HiddenField Класс

Ссылка

Определение

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

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

Важно!

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

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

public ref class HiddenField : System::Web::UI::Control, System::Web::UI::IPostBackDataHandler

[System.Web.UI.ControlValueProperty("Value")]
public class HiddenField : System.Web.UI.Control, System.Web.UI.IPostBackDataHandler

[<System.Web.UI.ControlValueProperty("Value")>]
type HiddenField = class
    inherit Control
    interface IPostBackDataHandler

Public Class HiddenField
Inherits Control
Implements IPostBackDataHandler

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

Control
HiddenField

Атрибуты: ControlValuePropertyAttribute

Реализации: IPostBackDataHandler

Примеры

В следующих примерах показано, как использовать HiddenField элемент управления для хранения значения TextBox элемента управления между записями на сервере.

Важно!

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


<%@ 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">
 
  void ValueHiddenField_ValueChanged (Object sender, EventArgs e)
  {
    
    // Display the value of the HiddenField control.
    Message.Text = "The value of the HiddenField control is " + ValueHiddenField.Value + ".";
    
  }
  
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
    <head runat="server">
    <title>HiddenField Example</title>
</head>
<body>
        <form id="Form1" runat="server">
        
            <h3>HiddenField Example</h3>

            Please enter a value and click the submit button.<br/>
            
            <asp:Textbox id="ValueTextBox"
              runat="server"/>
              
            <br/>  
              
            <input type="submit" name="SubmitButton"
             value="Submit"
             onclick="PageLoad()" />
             
            <br/>
            
            <asp:label id="Message" runat="server"/>    
            
            <asp:hiddenfield id="ValueHiddenField"
              onvaluechanged="ValueHiddenField_ValueChanged"
              value="" 
              runat="server"/>
            
        </form>
    </body>
</html>

<script type="text/javascript">

  <!--
  function PageLoad()
  {
  
    // Set the value of the HiddenField control with the
    // value from the TextBox.
    Form1.ValueHiddenField.value = Form1.ValueTextBox.value;
    
  }
  -->
  
</script>


<%@ 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">
 
  Sub ValueHiddenField_ValueChanged(ByVal sender As Object, ByVal e As EventArgs)
    
    ' Display the value of the HiddenField control.
    Message.Text = "The value of the HiddenField control is " & ValueHiddenField.Value & "."
    
  End Sub
  
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
    <head runat="server">
    <title>HiddenField Example</title>
</head>
<body>
        <form id="Form1" runat="server">
        
            <h3>HiddenField Example</h3>

            Please enter a value and click the submit button.<br/>
            
            <asp:textbox id="ValueTextBox"
              runat="server"/>
              
            <br/>  
              
            <input type="submit" name="SubmitButton"
             value="Submit"
             onclick="PageLoad()" />
             
            <br/>
            
            <asp:label id="Message" runat="server"/>    
            
            <asp:hiddenfield id="ValueHiddenField"
              onvaluechanged="ValueHiddenField_ValueChanged"
              value="" 
              runat="server"/>
            
        </form>
    </body>
</html>

<script type="text/javascript">

  <!--
  function PageLoad()
  {
  
    // Set the value of the HiddenField control with the
    // value from the TextBox.
    Form1.ValueHiddenField.value = Form1.ValueTextBox.value;
    
  }
  -->
  
</script>

<asp:HiddenField id="HiddenField1" runat="server" value="1"/>

<asp:HiddenField id="HiddenField1" runat="server" value="1"/>

Обычно просмотр состояния, состояние сеанса и файлы cookie используются для поддержания состояния страницы веб-форм. Однако если эти методы отключены или недоступны, можно использовать элемент управления для хранения значений HiddenField состояния.

Чтобы указать значение для HiddenField элемента управления, используйте Value свойство . Вы можете предоставить подпрограмму, которая вызывается каждый раз, когда значение HiddenField элемента управления изменяется между записями на сервере, путем создания обработчика ValueChanged событий для события.

Декларативный синтаксис

<asp:HiddenField
    EnableTheming="True|False"
    EnableViewState="True|False"
    ID="string"
    OnDataBinding="DataBinding event handler"
    OnDisposed="Disposed event handler"
    OnInit="Init event handler"
    OnLoad="Load event handler"
    OnPreRender="PreRender event handler"
    OnUnload="Unload event handler"
    OnValueChanged="ValueChanged event handler"
    runat="server"
    SkinID="string"
    Value="string"
    Visible="True|False"
/>

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

HiddenField()

Инициализирует новый экземпляр класса HiddenField.

Свойства

Adapter	Возвращает конкретный адаптер браузера для элемента управления. (Унаследовано от Control)
AppRelativeTemplateSourceDirectory	Возвращает или задает относительно приложения виртуальный каталог объекта Page или UserControl, который содержит этот элемент управления. (Унаследовано от Control)
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)
EnableTheming	Возвращает или задает значение, указывающее, применяются ли темы к этому элементу управления.
EnableViewState	Получает или задает значение, указывающее запрашивающему клиенту, сохраняет ли серверный элемент управления состояние представления и состояние представления своих дочерних элементов управления. (Унаследовано от Control)
Events	Возвращает список делегатов обработчиков событий элемента управления. Это свойство доступно только для чтения. (Унаследовано от Control)
HasChildViewState	Возвращает значение, которое указывает на наличие сохраненных параметров состояния представления у дочернего элемента серверного элемента управления. (Унаследовано от Control)
ID	Возвращает или задает программный идентификатор, назначенный серверному элементу управления. (Унаследовано от Control)
IdSeparator	Возвращает символ, используемый для разделения идентификаторов элементов управления. (Унаследовано от Control)
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	Возвращает или задает обложку, применяемую к элементу управления.
TemplateControl	Возвращает или задает ссылку на шаблон, содержащий этот элемент управления. (Унаследовано от Control)
TemplateSourceDirectory	Возвращает виртуальный каталог Page или UserControl, содержащий текущий серверный элемент управления. (Унаследовано от Control)
UniqueID	Возвращает уникальный идентификатор серверного элемента управления в иерархии. (Унаследовано от Control)
ValidateRequestMode	Возвращает или задает значение, указывающее, проверяет ли элемент управления полученный из браузера клиентский ввод на предмет потенциально опасных значений. (Унаследовано от Control)
Value	Получает или задает значение скрытого поля.
ViewState	Возвращает словарь сведений о состоянии, позволяющих сохранять и восстанавливать состояние представления серверного элемента управления при нескольких запросах одной и той же страницы. (Унаследовано от Control)
ViewStateIgnoresCase	Возвращает значение, указывающее, является ли объект StateBag нечувствительным к регистру. (Унаследовано от Control)
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()	Создает объект EmptyControlCollection, с помощью которого можно указать, что дочерний объект запрещен.
DataBind()	Привязывает источник данных к вызываемому серверному элементу управления и всем его дочерним элементам управления. (Унаследовано от Control)
DataBind(Boolean)	Привязывает источник данных к вызванному серверному элементу управления и всем его дочерними элементами управления с возможностью вызова события DataBinding. (Унаследовано от Control)
DataBindChildren()	Привязывает источник данных к дочерним элементам управления серверного элемента управления. (Унаследовано от Control)
Dispose()	Включает серверный элемент управления для выполнения окончательной чистки до освобождения памяти. (Унаследовано от Control)
EndRenderTracing(TextWriter, Object)	Завершает трассировку во время разработки данных отрисовки. (Унаследовано от Control)
EnsureChildControls()	Определяет наличие у серверного элемента управления дочерних элементов управления. Если дочерних элементов управления нет, они будут созданы. (Унаследовано от Control)
EnsureID()	Создает идентификатор для элементов управления, которые не имеют назначенного идентификатора. (Унаследовано от Control)
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
FindControl(String)	Выполняет поиск серверного элемента управления с заданным параметром `id` в текущем контейнере именования. (Унаследовано от Control)
FindControl(String, Int32)	Выполняет поиск в текущем контейнере именования серверного элемента управления с указанным `id` и целым числом, указанным в параметре `pathOffset`, который содействует поиску. Эту версию метода FindControl не следует переопределять. (Унаследовано от Control)
Focus()	Устанавливает фокус на этот элемент управления.
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)
LoadPostData(String, NameValueCollection)	Процессы выполняют обратную передачу данных для элемента управления HiddenField.
LoadViewState(Object)	Восстанавливает сведения о состоянии представления из предыдущего запроса страницы, сохраненного методом SaveViewState(). (Унаследовано от Control)
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.
OnUnload(EventArgs)	Вызывает событие Unload. (Унаследовано от Control)
OnValueChanged(EventArgs)	Вызывает событие ValueChanged.
OpenFile(String)	Возвращает Stream, используемое для чтения файла. (Унаследовано от Control)
RaiseBubbleEvent(Object, EventArgs)	Присваивает родительскому элементу управления все источники события и сведения о них. (Унаследовано от Control)
RaisePostDataChangedEvent()	Уведомляет приложение ASP.NET об изменении состояния элемента управления HiddenField.
RemovedControl(Control)	Вызывается после удаления дочернего элемента управления из коллекции Controls объекта Control. (Унаследовано от Control)
Render(HtmlTextWriter)	Отрисовывает содержимое элемента управления веб-сервера в клиентском браузере с использованием указанного объекта HtmlTextWriter.
RenderChildren(HtmlTextWriter)	Выводит содержимое дочерних элементов серверного элемента управления в предоставленный объект HtmlTextWriter, который записывает это содержимое для подготовки к просмотру на клиенте. (Унаследовано от Control)
RenderControl(HtmlTextWriter)	Выводит содержимое серверного элемента управления в указанный объект HtmlTextWriter и сохраняет сведения о трассировке элемента управления, если трассировка включена. (Унаследовано от Control)
RenderControl(HtmlTextWriter, ControlAdapter)	Выводит серверный элемент управления в указанный объект HtmlTextWriter, используя указанный объект ControlAdapter. (Унаследовано от Control)
ResolveAdapter()	Возвращает адаптер элемента управления, отвечающий за отрисовку определенного элемента управления. (Унаследовано от Control)
ResolveClientUrl(String)	Возвращает URL-адрес, который может использоваться браузером. (Унаследовано от Control)
ResolveUrl(String)	Преобразует URL-адрес в адрес, доступный для клиента. (Унаследовано от Control)
SaveControlState()	Сохраняет любые изменения состояния серверного элемента управления, произошедшие после отправки страницы обратно на сервер. (Унаследовано от Control)
SaveViewState()	Сохраняет любые изменения состояния просмотра серверного элемента управления, произошедшие после отправки страницы обратно на сервер. (Унаследовано от Control)
SetDesignModeState(IDictionary)	Задает данные времени разработки для элемента управления. (Унаследовано от Control)
SetRenderMethodDelegate(RenderMethod)	Назначает делегата обработчика событий для преобразования серверного элемента управления и его содержимого для просмотра в родительский элемент управления. (Унаследовано от Control)
SetTraceData(Object, Object)	Задает данные трассировки для трассировки данных отрисовки во время разработки, используя ключ данных трассировки и значение данных трассировки. (Унаследовано от Control)
SetTraceData(Object, 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)
ValueChanged	Происходит, если значение элемента управления HiddenField изменяется между передачами на сервер.

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

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)
IPostBackDataHandler.LoadPostData(String, NameValueCollection)	Описание этого элемента содержится в методе LoadPostData(String, NameValueCollection).
IPostBackDataHandler.RaisePostDataChangedEvent()	Описание этого элемента содержится в методе RaisePostDataChangedEvent().

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

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

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

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