1<?xml version="1.0" encoding="utf-8"?>
2<Type Name="FormParameter" FullName="System.Web.UI.WebControls.FormParameter">
3  <TypeSignature Language="C#" Value="public class FormParameter : System.Web.UI.WebControls.Parameter" />
4  <AssemblyInfo>
5    <AssemblyName>System.Web</AssemblyName>
6    <AssemblyVersion>2.0.0.0</AssemblyVersion>
7  </AssemblyInfo>
8  <Base>
9    <BaseTypeName>System.Web.UI.WebControls.Parameter</BaseTypeName>
10  </Base>
11  <Interfaces />
12  <Attributes>
13    <Attribute>
14      <AttributeName>System.ComponentModel.DefaultProperty("FormField")</AttributeName>
15    </Attribute>
16  </Attributes>
17  <Docs>
18    <since version=".NET 2.0" />
19    <remarks>
20      <attribution license="cc4" from="Microsoft" modified="false" />
21      <para>You can use the <see cref="T:System.Web.UI.WebControls.FormParameter" /> class to bind the value of a form variable in the <see cref="P:System.Web.HttpRequest.Form" /> collection to a parameter used in a parameterized query or command. Controls that bind data to the parameter might throw an exception if a <see cref="T:System.Web.UI.WebControls.FormParameter" /> is specified but no corresponding form variable is passed. They might also display no data if the form variable is passed with no corresponding value. Set the <see cref="P:System.Web.UI.WebControls.Parameter.DefaultValue" /> to avoid these situations where appropriate.</para>
22      <para>The <see cref="T:System.Web.UI.WebControls.FormParameter" /> class provides the <see cref="P:System.Web.UI.WebControls.FormParameter.FormField" /> property, which identifies the name of the form variable to bind to, in addition to those inherited from the <see cref="T:System.Web.UI.WebControls.Parameter" /> class.</para>
23      <block subset="none" type="note">
24        <para>The <see cref="T:System.Web.UI.WebControls.FormParameter" /> does not validate the value passed by the form element in any way; it uses the raw value. In most cases you can validate the value of the <see cref="T:System.Web.UI.WebControls.FormParameter" /> before it is used by a data source control by handling an event, such as the Selecting, Updating, Inserting, or Deleting event exposed by the data source control you are using. If the value of the parameter does not pass your validation tests, you can cancel the data operation by setting the <see cref="P:System.ComponentModel.CancelEventArgs.Cancel" /> property of the associated <see cref="T:System.ComponentModel.CancelEventArgs" /> class to true.</para>
25      </block>
26    </remarks>
27    <summary>
28      <attribution license="cc4" from="Microsoft" modified="false" />
29      <para>Binds the value of an HTTP request <see cref="P:System.Web.HttpRequest.Form" /> field to a parameter object.</para>
30    </summary>
31  </Docs>
32  <Members>
33    <Member MemberName=".ctor">
34      <MemberSignature Language="C#" Value="public FormParameter ();" />
35      <MemberType>Constructor</MemberType>
36      <Parameters />
37      <Docs>
38        <since version=".NET 2.0" />
39        <remarks>
40          <attribution license="cc4" from="Microsoft" modified="false" />
41          <para>A <see cref="T:System.Web.UI.WebControls.FormParameter" /> object created with the <see cref="M:System.Web.UI.WebControls.FormParameter.#ctor" /> constructor is initialized with default values for all its properties. The <see cref="P:System.Web.UI.WebControls.FormParameter.FormField" /> is initialized to <see cref="F:System.String.Empty" />. Additionally, the <see cref="P:System.Web.UI.WebControls.Parameter.Name" /> property is initialized to <see cref="F:System.String.Empty" />, the <see cref="P:System.Web.UI.WebControls.Parameter.Type" /> property is initialized to <see cref="F:System.TypeCode.Object" />, the <see cref="P:System.Web.UI.WebControls.Parameter.Direction" /> property is initialized to <see cref="F:System.Data.ParameterDirection.Input" />, and the <see cref="P:System.Web.UI.WebControls.Parameter.DefaultValue" /> property is initialized to null (Nothing in Visual Basic).</para>
42        </remarks>
43        <summary>
44          <attribution license="cc4" from="Microsoft" modified="false" />
45          <para>Initializes a new unnamed instance of the <see cref="T:System.Web.UI.WebControls.FormParameter" /> class.</para>
46        </summary>
47      </Docs>
48      <AssemblyInfo>
49        <AssemblyVersion>2.0.0.0</AssemblyVersion>
50      </AssemblyInfo>
51    </Member>
52    <Member MemberName=".ctor">
53      <MemberSignature Language="C#" Value="protected FormParameter (System.Web.UI.WebControls.FormParameter original);" />
54      <MemberType>Constructor</MemberType>
55      <Parameters>
56        <Parameter Name="original" Type="System.Web.UI.WebControls.FormParameter" />
57      </Parameters>
58      <Docs>
59        <since version=".NET 2.0" />
60        <remarks>
61          <attribution license="cc4" from="Microsoft" modified="false" />
62          <para>The <see cref="M:System.Web.UI.WebControls.FormParameter.#ctor(System.Web.UI.WebControls.FormParameter)" /> constructor is a protected copy constructor used to clone a <see cref="T:System.Web.UI.WebControls.FormParameter" /> instance. The values of the <see cref="T:System.Web.UI.WebControls.FormParameter" />, including <see cref="P:System.Web.UI.WebControls.FormParameter.FormField" />, <see cref="P:System.Web.UI.WebControls.Parameter.Name" />, and <see cref="P:System.Web.UI.WebControls.Parameter.Type" /> are all transferred to the new instance.</para>
63        </remarks>
64        <summary>
65          <attribution license="cc4" from="Microsoft" modified="false" />
66          <para>Initializes a new instance of the <see cref="T:System.Web.UI.WebControls.FormParameter" /> class with the values of the instance specified by the <paramref name="original" /> parameter.</para>
67        </summary>
68        <param name="original">
69          <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Web.UI.WebControls.FormParameter" /> instance that the current instance is initialized from. </param>
70      </Docs>
71      <AssemblyInfo>
72        <AssemblyVersion>2.0.0.0</AssemblyVersion>
73      </AssemblyInfo>
74    </Member>
75    <Member MemberName=".ctor">
76      <MemberSignature Language="C#" Value="public FormParameter (string name, string formField);" />
77      <MemberType>Constructor</MemberType>
78      <Parameters>
79        <Parameter Name="name" Type="System.String" />
80        <Parameter Name="formField" Type="System.String" />
81      </Parameters>
82      <Docs>
83        <since version=".NET 2.0" />
84        <remarks>
85          <attribution license="cc4" from="Microsoft" modified="false" />
86          <para>A <see cref="T:System.Web.UI.WebControls.FormParameter" /> object created with the <see cref="M:System.Web.UI.WebControls.FormParameter.#ctor(System.String,System.String)" /> constructor is initialized with the specified parameter name and string that identifies the form variable that the parameter binds to. The <see cref="P:System.Web.UI.WebControls.Parameter.Type" /> and <see cref="P:System.Web.UI.WebControls.Parameter.Direction" /> properties are initialized with default values.</para>
87        </remarks>
88        <summary>
89          <attribution license="cc4" from="Microsoft" modified="false" />
90          <para>Initializes a new named instance of the <see cref="T:System.Web.UI.WebControls.FormParameter" /> class, using the specified string to identify which form variable field to bind to.</para>
91        </summary>
92        <param name="name">
93          <attribution license="cc4" from="Microsoft" modified="false" />The name of the parameter. </param>
94        <param name="formField">
95          <attribution license="cc4" from="Microsoft" modified="false" />The name of the form variable that the parameter object is bound to. The default is <see cref="F:System.String.Empty" />. </param>
96      </Docs>
97      <AssemblyInfo>
98        <AssemblyVersion>2.0.0.0</AssemblyVersion>
99      </AssemblyInfo>
100    </Member>
101    <Member MemberName=".ctor">
102      <MemberSignature Language="C#" Value="public FormParameter (string name, TypeCode type, string formField);" />
103      <MemberType>Constructor</MemberType>
104      <Parameters>
105        <Parameter Name="name" Type="System.String" />
106        <Parameter Name="type" Type="System.TypeCode" />
107        <Parameter Name="formField" Type="System.String" />
108      </Parameters>
109      <Docs>
110        <since version=".NET 2.0" />
111        <remarks>
112          <attribution license="cc4" from="Microsoft" modified="false" />
113          <para>A <see cref="T:System.Web.UI.WebControls.FormParameter" /> object created with the <see cref="M:System.Web.UI.WebControls.FormParameter.#ctor(System.String,System.TypeCode,System.String)" /> constructor is initialized with the specified parameter name, <see cref="P:System.Web.UI.WebControls.Parameter.Type" />, and string that identifies the form variable that the parameter binds to. Only the <see cref="P:System.Web.UI.WebControls.Parameter.Direction" /> and <see cref="P:System.Web.UI.WebControls.Parameter.ConvertEmptyStringToNull" /> properties are initialized with default values.</para>
114        </remarks>
115        <summary>
116          <attribution license="cc4" from="Microsoft" modified="false" />
117          <para>Initializes a new named and strongly typed instance of the <see cref="T:System.Web.UI.WebControls.FormParameter" /> class, using the specified string to identify which form variable to bind to.</para>
118        </summary>
119        <param name="name">
120          <attribution license="cc4" from="Microsoft" modified="false" />The name of the parameter. </param>
121        <param name="type">
122          <attribution license="cc4" from="Microsoft" modified="false" />The type that the parameter represents. The default is <see cref="F:System.TypeCode.Object" />. </param>
123        <param name="formField">
124          <attribution license="cc4" from="Microsoft" modified="false" />The name of the form variable that the parameter object is bound to. The default is <see cref="F:System.String.Empty" />. </param>
125      </Docs>
126      <AssemblyInfo>
127        <AssemblyVersion>2.0.0.0</AssemblyVersion>
128      </AssemblyInfo>
129    </Member>
130    <Member MemberName="Clone">
131      <MemberSignature Language="C#" Value="protected override System.Web.UI.WebControls.Parameter Clone ();" />
132      <MemberType>Method</MemberType>
133      <ReturnValue>
134        <ReturnType>System.Web.UI.WebControls.Parameter</ReturnType>
135      </ReturnValue>
136      <Parameters />
137      <Docs>
138        <since version=".NET 2.0" />
139        <remarks>
140          <attribution license="cc4" from="Microsoft" modified="false" />
141          <para>The <see cref="M:System.Web.UI.WebControls.FormParameter.Clone" /> method calls the <see cref="M:System.Web.UI.WebControls.FormParameter.#ctor(System.Web.UI.WebControls.FormParameter)" /> copy constructor to initialize a new instance of the <see cref="T:System.Web.UI.WebControls.FormParameter" /> class with the values of the current instance.</para>
142        </remarks>
143        <summary>
144          <attribution license="cc4" from="Microsoft" modified="false" />
145          <para>Returns a duplicate of the current <see cref="T:System.Web.UI.WebControls.FormParameter" /> instance.</para>
146        </summary>
147        <returns>
148          <attribution license="cc4" from="Microsoft" modified="false" />
149          <para>A <see cref="T:System.Web.UI.WebControls.FormParameter" /> that is an exact duplicate of the current one.</para>
150        </returns>
151      </Docs>
152      <AssemblyInfo>
153        <AssemblyVersion>2.0.0.0</AssemblyVersion>
154      </AssemblyInfo>
155    </Member>
156    <Member MemberName="Evaluate">
157      <MemberSignature Language="C#" Value="protected override object Evaluate (System.Web.HttpContext ctx, System.Web.UI.Control control);" />
158      <MemberType>Method</MemberType>
159      <ReturnValue>
160        <ReturnType>System.Object</ReturnType>
161      </ReturnValue>
162      <Parameters>
163        <Parameter Name="ctx" Type="System.Web.HttpContext" />
164        <Parameter Name="control" Type="System.Web.UI.Control" />
165      </Parameters>
166      <Docs>
167        <param name="ctx">To be added.</param>
168        <since version=".NET 2.0" />
169        <remarks>
170          <attribution license="cc4" from="Microsoft" modified="false" />
171          <para>The <see cref="T:System.Web.UI.WebControls.FormParameter" /> attempts to bind to the form variable every time the <see cref="M:System.Web.UI.WebControls.FormParameter.Evaluate(System.Web.HttpContext,System.Web.UI.Control)" /> method is called.</para>
172          <para>The <paramref name="context" /> parameter is used by the <see cref="M:System.Web.UI.WebControls.FormParameter.Evaluate(System.Web.HttpContext,System.Web.UI.Control)" /> method to retrieve the value of the specified form field from the request. The <paramref name="control" /> parameter is ignored.</para>
173        </remarks>
174        <summary>
175          <attribution license="cc4" from="Microsoft" modified="false" />
176          <para>Updates and returns the value of the <see cref="T:System.Web.UI.WebControls.FormParameter" /> object.</para>
177        </summary>
178        <returns>
179          <attribution license="cc4" from="Microsoft" modified="false" />
180          <para>An object that represents the updated and current value of the parameter. If the context or the request is null (Nothing in Visual Basic), the <see cref="M:System.Web.UI.WebControls.FormParameter.Evaluate(System.Web.HttpContext,System.Web.UI.Control)" /> method returns null.</para>
181        </returns>
182        <param name="control">
183          <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Web.UI.Control" /> that is associated with the page where the <see cref="T:System.Web.UI.WebControls.FormParameter" /> is used. </param>
184      </Docs>
185      <AssemblyInfo>
186        <AssemblyVersion>2.0.0.0</AssemblyVersion>
187      </AssemblyInfo>
188    </Member>
189    <Member MemberName="FormField">
190      <MemberSignature Language="C#" Value="public string FormField { set; get; }" />
191      <MemberType>Property</MemberType>
192      <Attributes>
193        <Attribute>
194          <AttributeName>System.ComponentModel.DefaultValue("")</AttributeName>
195        </Attribute>
196      </Attributes>
197      <ReturnValue>
198        <ReturnType>System.String</ReturnType>
199      </ReturnValue>
200      <Docs>
201        <value>To be added.</value>
202        <since version=".NET 2.0" />
203        <remarks>
204          <attribution license="cc4" from="Microsoft" modified="false" />
205          <para>The <see cref="P:System.Web.UI.WebControls.FormParameter.FormField" /> identifies a name/value pair that is passed in the <see cref="P:System.Web.HttpRequest.Form" /> collection. While the <see cref="P:System.Web.UI.WebControls.FormParameter.FormField" /> property identifies the name of the pair, the <see cref="T:System.Web.UI.WebControls.FormParameter" /> binds to its corresponding value at run time. If the expected form variable string name/value pair is not passed to the ASP.NET Web page in the collection, the <see cref="M:System.Web.UI.WebControls.FormParameter.Evaluate(System.Web.HttpContext,System.Web.UI.Control)" /> method binds the parameter to the value of the <see cref="P:System.Web.UI.WebControls.Parameter.DefaultValue" /> property, if it is set. If the <see cref="P:System.Web.UI.WebControls.Parameter.DefaultValue" /> is not set, the <see cref="M:System.Web.UI.WebControls.FormParameter.Evaluate(System.Web.HttpContext,System.Web.UI.Control)" /> method fails to bind the parameter to a value.</para>
206        </remarks>
207        <summary>
208          <attribution license="cc4" from="Microsoft" modified="false" />
209          <para>Gets or sets the name of the form variable that the parameter binds to.</para>
210        </summary>
211      </Docs>
212      <AssemblyInfo>
213        <AssemblyVersion>2.0.0.0</AssemblyVersion>
214      </AssemblyInfo>
215    </Member>
216  </Members>
217</Type>