Syntax
CSharp
public static void RegisterHiddenField (
Control control,
string hiddenFieldName,
string hiddenFieldInitialValue
)
VisualBasic
Public Shared Sub RegisterHiddenField ( _
control As Control, _
hiddenFieldName As String, _
hiddenFieldInitialValue As String _
)
ManagedCPlusPlus
public:
static void RegisterHiddenField (
Control^ control,
String^ hiddenFieldName,
String^ hiddenFieldInitialValue
)
JSharp
public static void RegisterHiddenField (
Control control,
String hiddenFieldName,
String hiddenFieldInitialValue
)
Parameters
- control (Control)
The control that is registering the hidden field.
- hiddenFieldName (String)
The name of the hidden field to register.
- hiddenFieldInitialValue (String)
The initial value of the hidden field to register.
Remarks
The RegisterHiddenField method is used to register a hidden field that is compatible with partial-page rendering and that has no Microsoft AJAX Library dependencies. This method registers the hidden field when the control that is registering the field is inside an UpdatePanel control that is updated. To register a hidden field each time an asynchronous postback occurs, use the RegisterHiddenField(Page, String, String) overload of this method. If you are registering a hidden field that does not pertain to partial-page updates and you want to register an array only one time during initial page rendering, use the RegisterHiddenField(String, String) method of the ClientScriptManager class. You can get a reference to the ClientScriptManager object from the ClientScript property of the page.
The RegisterHiddenField method creates a hidden <input> element on the rendered HTML page.
Exceptions
| Exception | Condition |
|---|
| ArgumentNullException | The control that is registering the hidden field is null. - or - hiddenFieldName is null. |
| ArgumentException | The control that is registering the hidden field is not in the page's control tree. |
Assembly: System.Web.Extensions (Module: System.Web.Extensions)