1<?xml version="1.0" encoding="utf-8"?> 2<Type Name="ButtonColumn" FullName="System.Web.UI.WebControls.ButtonColumn"> 3 <TypeSignature Language="C#" Maintainer="auto" Value="public class ButtonColumn : System.Web.UI.WebControls.DataGridColumn" /> 4 <AssemblyInfo> 5 <AssemblyName>System.Web</AssemblyName> 6 <AssemblyPublicKey> 7 </AssemblyPublicKey> 8 <AssemblyVersion>1.0.5000.0</AssemblyVersion> 9 <AssemblyVersion>2.0.0.0</AssemblyVersion> 10 </AssemblyInfo> 11 <ThreadSafetyStatement>Gtk# is thread aware, but not thread safe; See the <link location="node:gtk-sharp/programming/threads">Gtk# Thread Programming</link> for details.</ThreadSafetyStatement> 12 <Base> 13 <BaseTypeName>System.Web.UI.WebControls.DataGridColumn</BaseTypeName> 14 </Base> 15 <Interfaces> 16 </Interfaces> 17 <Docs> 18 <remarks> 19 <attribution license="cc4" from="Microsoft" modified="false" /> 20 <para>Use the <see cref="T:System.Web.UI.WebControls.ButtonColumn" /> class in a <see cref="T:System.Web.UI.WebControls.DataGrid" /> control to create a button that corresponds with each row in the <see cref="T:System.Web.UI.WebControls.DataGrid" /> control. Specify the caption that is displayed in the buttons by setting the <see cref="P:System.Web.UI.WebControls.ButtonColumn.Text" /> property. If you set the <see cref="P:System.Web.UI.WebControls.ButtonColumn.Text" /> property, all buttons in the <see cref="T:System.Web.UI.WebControls.ButtonColumn" /> object share the same caption. Alternatively, you can bind the <see cref="T:System.Web.UI.WebControls.ButtonColumn" /> buttons to a field in a data source. This allows you to display different captions for each button. The values in the specified field are used for the text caption. Set the <see cref="P:System.Web.UI.WebControls.ButtonColumn.DataTextField" /> property to bind the <see cref="T:System.Web.UI.WebControls.ButtonColumn" /> to a field in a data source.</para> 21 <para>You can format the captions that are displayed in the buttons by setting the <see cref="P:System.Web.UI.WebControls.ButtonColumn.DataTextField" /> property with a formatting string.</para> 22 <para>Clicking the buttons in the <see cref="T:System.Web.UI.WebControls.ButtonColumn" /> raises the <see cref="E:System.Web.UI.WebControls.DataGrid.ItemCommand" /> event. You can programmatically control the action that is performed when the button is clicked by providing an event handler for the <see cref="E:System.Web.UI.WebControls.DataGrid.ItemCommand" /> event.</para> 23 <para>By default, page validation is not performed when a button in the <see cref="T:System.Web.UI.WebControls.ButtonColumn" /> is clicked. Page validation determines whether the input controls that are associated with a validation control on the page all pass the validation rules that are specified by the validation control. To perform page validation when a button is clicked, set the <see cref="P:System.Web.UI.WebControls.ButtonColumn.CausesValidation" /> property to true.</para> 24 </remarks> 25 <summary> 26 <attribution license="cc4" from="Microsoft" modified="false" /> 27 <para>A column type for the <see cref="T:System.Web.UI.WebControls.DataGrid" /> control that contains a user-defined button.</para> 28 </summary> 29 </Docs> 30 <Members> 31 <Member MemberName=".ctor"> 32 <MemberSignature Language="C#" Value="public ButtonColumn ();" /> 33 <MemberType>Constructor</MemberType> 34 <ReturnValue /> 35 <Parameters /> 36 <Docs> 37 <remarks> 38 <attribution license="cc4" from="Microsoft" modified="false" /> 39 <para>Use the <see cref="M:System.Web.UI.WebControls.ButtonColumn.#ctor" /> constructor to create and initialize a new instance of the <see cref="T:System.Web.UI.WebControls.ButtonColumn" /> class.</para> 40 </remarks> 41 <summary> 42 <attribution license="cc4" from="Microsoft" modified="false" /> 43 <para>Initializes a new instance of the <see cref="T:System.Web.UI.WebControls.ButtonColumn" /> class.</para> 44 </summary> 45 </Docs> 46 <AssemblyInfo> 47 <AssemblyVersion>1.0.5000.0</AssemblyVersion> 48 <AssemblyVersion>2.0.0.0</AssemblyVersion> 49 </AssemblyInfo> 50 </Member> 51 <Member MemberName="ButtonType"> 52 <MemberSignature Language="C#" Value="public virtual System.Web.UI.WebControls.ButtonColumnType ButtonType { set; get; }" /> 53 <MemberType>Property</MemberType> 54 <ReturnValue> 55 <ReturnType>System.Web.UI.WebControls.ButtonColumnType</ReturnType> 56 </ReturnValue> 57 <Parameters /> 58 <Docs> 59 <value>To be added: an object of type 'ButtonColumnType'</value> 60 <remarks> 61 <attribution license="cc4" from="Microsoft" modified="false" /> 62 <para>Use the <see cref="P:System.Web.UI.WebControls.ButtonColumn.ButtonType" /> property to specify whether the buttons in the <see cref="T:System.Web.UI.WebControls.ButtonColumn" /> object are displayed as link or push buttons. The following table lists the possible settings.</para> 63 <list type="table"> 64 <listheader> 65 <item> 66 <term> 67 <para>Button type</para> 68 </term> 69 <description> 70 <para>Display</para> 71 </description> 72 </item> 73 </listheader> 74 <item> 75 <term> 76 <para> 77 <see cref="F:System.Web.UI.WebControls.ButtonColumnType.LinkButton" /> </para> 78 </term> 79 <description> 80 <para>A link.</para> 81 </description> 82 </item> 83 <item> 84 <term> 85 <para> 86 <see cref="F:System.Web.UI.WebControls.ButtonColumnType.PushButton" /> </para> 87 </term> 88 <description> 89 <para>A button control.</para> 90 </description> 91 </item> 92 </list> 93 <para>Clicking the buttons in the <see cref="T:System.Web.UI.WebControls.ButtonColumn" /> raises the <see cref="E:System.Web.UI.WebControls.DataGrid.ItemCommand" /> event. You can programmatically control the action that is performed when the button is clicked by providing an event handler for the <see cref="E:System.Web.UI.WebControls.DataGrid.ItemCommand" /> event.</para> 94 <para>The value of this property is stored in view state.</para> 95 </remarks> 96 <summary> 97 <attribution license="cc4" from="Microsoft" modified="false" /> 98 <para>Gets or sets the type of button to display in the <see cref="T:System.Web.UI.WebControls.ButtonColumn" /> object.</para> 99 </summary> 100 </Docs> 101 <AssemblyInfo> 102 <AssemblyVersion>1.0.5000.0</AssemblyVersion> 103 <AssemblyVersion>2.0.0.0</AssemblyVersion> 104 </AssemblyInfo> 105 <Attributes> 106 <Attribute> 107 <AttributeName>System.ComponentModel.DefaultValue(System.Web.UI.WebControls.ButtonColumnType.LinkButton)</AttributeName> 108 </Attribute> 109 </Attributes> 110 </Member> 111 <Member MemberName="CausesValidation"> 112 <MemberSignature Language="C#" Value="public virtual bool CausesValidation { set; get; }" /> 113 <MemberType>Property</MemberType> 114 <AssemblyInfo> 115 <AssemblyVersion>2.0.0.0</AssemblyVersion> 116 </AssemblyInfo> 117 <Attributes> 118 <Attribute> 119 <AttributeName>System.ComponentModel.DefaultValue(false)</AttributeName> 120 </Attribute> 121 </Attributes> 122 <ReturnValue> 123 <ReturnType>System.Boolean</ReturnType> 124 </ReturnValue> 125 <Docs> 126 <value>To be added.</value> 127 <remarks> 128 <attribution license="cc4" from="Microsoft" modified="false" /> 129 <para>By default, page validation is not performed when a button in the <see cref="T:System.Web.UI.WebControls.ButtonColumn" /> object is clicked. Page validation determines whether the input controls that are associated with a validation control on the page all pass the validation rules that are specified by the validation control. To perform page validation when a button in the <see cref="T:System.Web.UI.WebControls.ButtonColumn" /> is clicked, set the <see cref="P:System.Web.UI.WebControls.ButtonColumn.CausesValidation" /> property to true.</para> 130 <para>When the value of the <see cref="P:System.Web.UI.WebControls.ButtonColumn.CausesValidation" /> property is true, you can also use the <see cref="P:System.Web.UI.WebControls.ButtonColumn.ValidationGroup" /> property to specify the name of the validation group for which the <see cref="T:System.Web.UI.WebControls.ButtonColumn" /> causes validation.</para> 131 <para>The value of this property is stored in view state.</para> 132 </remarks> 133 <summary> 134 <attribution license="cc4" from="Microsoft" modified="false" /> 135 <para>Gets or sets a value indicating whether validation is performed when a button in the <see cref="T:System.Web.UI.WebControls.ButtonColumn" /> object is clicked.</para> 136 </summary> 137 </Docs> 138 </Member> 139 <Member MemberName="CommandName"> 140 <MemberSignature Language="C#" Value="public virtual string CommandName { set; get; }" /> 141 <MemberType>Property</MemberType> 142 <ReturnValue> 143 <ReturnType>System.String</ReturnType> 144 </ReturnValue> 145 <Parameters /> 146 <Docs> 147 <value>To be added: an object of type 'string'</value> 148 <remarks> 149 <attribution license="cc4" from="Microsoft" modified="false" /> 150 <para>Use the <see cref="P:System.Web.UI.WebControls.ButtonColumn.CommandName" /> property to associate a command name, such as Add or Remove, with a button. You can set the <see cref="P:System.Web.UI.WebControls.ButtonColumn.CommandName" /> property to any string that identifies the action to perform when a button in the <see cref="T:System.Web.UI.WebControls.ButtonColumn" /> object is clicked. Then, you can determine programmatically the command name in the event handler for the <see cref="E:System.Web.UI.WebControls.DataGrid.ItemCommand" /> event and perform the appropriate actions.</para> 151 <para>The value of this property is stored in view state.</para> 152 </remarks> 153 <summary> 154 <attribution license="cc4" from="Microsoft" modified="false" /> 155 <para>Gets or sets a string that represents the command to perform when a button in the <see cref="T:System.Web.UI.WebControls.ButtonColumn" /> object is clicked.</para> 156 </summary> 157 </Docs> 158 <AssemblyInfo> 159 <AssemblyVersion>1.0.5000.0</AssemblyVersion> 160 <AssemblyVersion>2.0.0.0</AssemblyVersion> 161 </AssemblyInfo> 162 <Attributes> 163 <Attribute> 164 <AttributeName>System.ComponentModel.DefaultValue("")</AttributeName> 165 </Attribute> 166 </Attributes> 167 </Member> 168 <Member MemberName="DataTextField"> 169 <MemberSignature Language="C#" Value="public virtual string DataTextField { set; get; }" /> 170 <MemberType>Property</MemberType> 171 <ReturnValue> 172 <ReturnType>System.String</ReturnType> 173 </ReturnValue> 174 <Parameters /> 175 <Docs> 176 <value>To be added: an object of type 'string'</value> 177 <remarks> 178 <attribution license="cc4" from="Microsoft" modified="false" /> 179 <para>Use the <see cref="P:System.Web.UI.WebControls.ButtonColumn.DataTextField" /> property to specify the field name from the data source to bind to the <see cref="P:System.Web.UI.WebControls.ButtonColumn.Text" /> property of the buttons in the <see cref="T:System.Web.UI.WebControls.ButtonColumn" /> object.</para> 180 <para>Binding the column to a field instead of directly setting the <see cref="P:System.Web.UI.WebControls.ButtonColumn.Text" /> property allows you to display different captions for the buttons in the <see cref="T:System.Web.UI.WebControls.ButtonColumn" /> by using the values in the specified field.</para> 181 <para>The value of this property is stored in view state.</para> 182 </remarks> 183 <summary> 184 <attribution license="cc4" from="Microsoft" modified="false" /> 185 <para>Gets or sets the field name from a data source to bind to the <see cref="T:System.Web.UI.WebControls.ButtonColumn" /> object.</para> 186 </summary> 187 </Docs> 188 <AssemblyInfo> 189 <AssemblyVersion>1.0.5000.0</AssemblyVersion> 190 <AssemblyVersion>2.0.0.0</AssemblyVersion> 191 </AssemblyInfo> 192 <Attributes> 193 <Attribute> 194 <AttributeName>System.ComponentModel.DefaultValue("")</AttributeName> 195 </Attribute> 196 </Attributes> 197 </Member> 198 <Member MemberName="DataTextFormatString"> 199 <MemberSignature Language="C#" Value="public virtual string DataTextFormatString { set; get; }" /> 200 <MemberType>Property</MemberType> 201 <ReturnValue> 202 <ReturnType>System.String</ReturnType> 203 </ReturnValue> 204 <Parameters /> 205 <Docs> 206 <value>To be added: an object of type 'string'</value> 207 <remarks> 208 <attribution license="cc4" from="Microsoft" modified="false" /> 209 <para>Use the <see cref="P:System.Web.UI.WebControls.ButtonColumn.DataTextFormatString" /> property to provide a custom display format for the caption of the buttons in the <see cref="T:System.Web.UI.WebControls.ButtonColumn" /> object.</para> 210 <para>The data format string consists of two parts, separated by a colon, in the form {A:Bxx}. For example, the formatting string {0:F2} formats the cell to display a fixed point number with two decimal places.</para> 211 <block subset="none" type="note"> 212 <para>The entire string must be enclosed in braces to indicate that it is a format string and not a literal string. Any text outside the braces is displayed as literal text.</para> 213 </block> 214 <para>The value before the colon (<paramref name="A" /> in the general example) specifies the parameter index in a zero-based list of parameters.</para> 215 <block subset="none" type="note"> 216 <para>This value can be set only to 0 because there is only one value in each cell.</para> 217 </block> 218 <para>The character after the colon (<paramref name="B" /> in the general example) specifies the format to display the value in. The following table lists the common formats.</para> 219 <list type="table"> 220 <listheader> 221 <item> 222 <term> 223 <para>Format character </para> 224 </term> 225 <description> 226 <para>Displays numeric values in </para> 227 </description> 228 </item> 229 </listheader> 230 <item> 231 <term> 232 <para>C </para> 233 </term> 234 <description> 235 <para>Currency format. </para> 236 </description> 237 </item> 238 <item> 239 <term> 240 <para>D </para> 241 </term> 242 <description> 243 <para>Decimal format. </para> 244 </description> 245 </item> 246 <item> 247 <term> 248 <para>E </para> 249 </term> 250 <description> 251 <para>Scientific (exponential) format. </para> 252 </description> 253 </item> 254 <item> 255 <term> 256 <para>F </para> 257 </term> 258 <description> 259 <para>Fixed format. </para> 260 </description> 261 </item> 262 <item> 263 <term> 264 <para>G </para> 265 </term> 266 <description> 267 <para>General format. </para> 268 </description> 269 </item> 270 <item> 271 <term> 272 <para>N </para> 273 </term> 274 <description> 275 <para>Number format. </para> 276 </description> 277 </item> 278 <item> 279 <term> 280 <para>X </para> 281 </term> 282 <description> 283 <para>Hexadecimal format. </para> 284 </description> 285 </item> 286 </list> 287 <block subset="none" type="note"> 288 <para>The format character is not case sensitive, except for X, which displays the hexadecimal characters in the case specified.</para> 289 </block> 290 <para>The value after the format character (<paramref name="xx" /> in the general example) specifies the number of significant digits or decimal places to display.</para> 291 <para>The value of this property is stored in view state.</para> 292 <para>For more information on formatting strings, see <format type="text/html"><a href="0d1364da-5b30-4d42-8e6b-03378343343f">Formatting Overview</a></format>. </para> 293 </remarks> 294 <summary> 295 <attribution license="cc4" from="Microsoft" modified="false" /> 296 <para>Gets or sets the string that specifies the display format for the caption in each button.</para> 297 </summary> 298 </Docs> 299 <AssemblyInfo> 300 <AssemblyVersion>1.0.5000.0</AssemblyVersion> 301 <AssemblyVersion>2.0.0.0</AssemblyVersion> 302 </AssemblyInfo> 303 <Attributes> 304 <Attribute> 305 <AttributeName>System.ComponentModel.DefaultValue("")</AttributeName> 306 </Attribute> 307 </Attributes> 308 </Member> 309 <Member MemberName="FormatDataTextValue"> 310 <MemberSignature Language="C#" Value="protected virtual string FormatDataTextValue (object dataTextValue);" /> 311 <MemberType>Method</MemberType> 312 <ReturnValue> 313 <ReturnType>System.String</ReturnType> 314 </ReturnValue> 315 <Parameters> 316 <Parameter Name="dataTextValue" Type="System.Object" /> 317 </Parameters> 318 <Docs> 319 <remarks> 320 <attribution license="cc4" from="Microsoft" modified="false" /> 321 <para>Use the <see cref="M:System.Web.UI.WebControls.ButtonColumn.FormatDataTextValue(System.Object)" /> method to convert the specified value to the format that is indicated by the <see cref="P:System.Web.UI.WebControls.ButtonColumn.DataTextFormatString" /> property.</para> 322 <block subset="none" type="note"> 323 <para>The <see cref="M:System.Web.UI.WebControls.ButtonColumn.FormatDataTextValue(System.Object)" /> method returns the string equivalent of the value, if the <see cref="P:System.Web.UI.WebControls.ButtonColumn.DataTextFormatString" /> property is not set.</para> 324 </block> 325 </remarks> 326 <summary> 327 <attribution license="cc4" from="Microsoft" modified="false" /> 328 <para>Converts the specified value to the format that is indicated by the <see cref="P:System.Web.UI.WebControls.ButtonColumn.DataTextFormatString" /> property.</para> 329 </summary> 330 <returns> 331 <attribution license="cc4" from="Microsoft" modified="false" /> 332 <para>The <paramref name="dataTextValue" /> converted to the format indicated by the <see cref="P:System.Web.UI.WebControls.ButtonColumn.DataTextFormatString" />.</para> 333 </returns> 334 <param name="dataTextValue"> 335 <attribution license="cc4" from="Microsoft" modified="false" />The value to format. </param> 336 </Docs> 337 <AssemblyInfo> 338 <AssemblyVersion>1.0.5000.0</AssemblyVersion> 339 <AssemblyVersion>2.0.0.0</AssemblyVersion> 340 </AssemblyInfo> 341 </Member> 342 <Member MemberName="Initialize"> 343 <MemberSignature Language="C#" Value="public override void Initialize ();" /> 344 <MemberType>Method</MemberType> 345 <ReturnValue> 346 <ReturnType>System.Void</ReturnType> 347 </ReturnValue> 348 <Parameters /> 349 <Docs> 350 <remarks> 351 <attribution license="cc4" from="Microsoft" modified="false" /> 352 <para>Use the <see cref="M:System.Web.UI.WebControls.ButtonColumn.Initialize" /> method to reset the <see cref="T:System.Web.UI.WebControls.ButtonColumn" /> object to its initial state.</para> 353 </remarks> 354 <summary> 355 <attribution license="cc4" from="Microsoft" modified="false" /> 356 <para>Resets the <see cref="T:System.Web.UI.WebControls.ButtonColumn" /> object to its initial state.</para> 357 </summary> 358 </Docs> 359 <AssemblyInfo> 360 <AssemblyVersion>1.0.5000.0</AssemblyVersion> 361 <AssemblyVersion>2.0.0.0</AssemblyVersion> 362 </AssemblyInfo> 363 </Member> 364 <Member MemberName="InitializeCell"> 365 <MemberSignature Language="C#" Value="public override void InitializeCell (System.Web.UI.WebControls.TableCell cell, int columnIndex, System.Web.UI.WebControls.ListItemType itemType);" /> 366 <MemberType>Method</MemberType> 367 <ReturnValue> 368 <ReturnType>System.Void</ReturnType> 369 </ReturnValue> 370 <Parameters> 371 <Parameter Name="cell" Type="System.Web.UI.WebControls.TableCell" /> 372 <Parameter Name="columnIndex" Type="System.Int32" /> 373 <Parameter Name="itemType" Type="System.Web.UI.WebControls.ListItemType" /> 374 </Parameters> 375 <Docs> 376 <remarks> 377 <attribution license="cc4" from="Microsoft" modified="false" /> 378 <para>The <see cref="M:System.Web.UI.WebControls.ButtonColumn.InitializeCell(System.Web.UI.WebControls.TableCell,System.Int32,System.Web.UI.WebControls.ListItemType)" /> method resets the specified cell in the <see cref="T:System.Web.UI.WebControls.ButtonColumn" /> object to its initial state.</para> 379 </remarks> 380 <summary> 381 <attribution license="cc4" from="Microsoft" modified="false" /> 382 <para>Resets a cell in the <see cref="T:System.Web.UI.WebControls.ButtonColumn" /> object to its initial state.</para> 383 </summary> 384 <param name="cell"> 385 <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Web.UI.WebControls.TableCell" /> that represents the cell to reset. </param> 386 <param name="columnIndex"> 387 <attribution license="cc4" from="Microsoft" modified="false" />The column number where the cell is located. </param> 388 <param name="itemType"> 389 <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Web.UI.WebControls.ListItemType" /> values. </param> 390 </Docs> 391 <AssemblyInfo> 392 <AssemblyVersion>1.0.5000.0</AssemblyVersion> 393 <AssemblyVersion>2.0.0.0</AssemblyVersion> 394 </AssemblyInfo> 395 </Member> 396 <Member MemberName="Text"> 397 <MemberSignature Language="C#" Value="public virtual string Text { set; get; }" /> 398 <MemberType>Property</MemberType> 399 <ReturnValue> 400 <ReturnType>System.String</ReturnType> 401 </ReturnValue> 402 <Parameters /> 403 <Docs> 404 <value>To be added: an object of type 'string'</value> 405 <remarks> 406 <attribution license="cc4" from="Microsoft" modified="false" /> 407 <para>Use the <see cref="P:System.Web.UI.WebControls.ButtonColumn.Text" /> property to specify or determine the caption that is displayed in the buttons of the <see cref="T:System.Web.UI.WebControls.ButtonColumn" /> object.</para> 408 <block subset="none" type="note"> 409 <para>If you set the <see cref="P:System.Web.UI.WebControls.ButtonColumn.Text" /> property, all buttons in the <see cref="T:System.Web.UI.WebControls.ButtonColumn" /> share the same caption.</para> 410 </block> 411 <para>Alternatively, you can bind the <see cref="T:System.Web.UI.WebControls.ButtonColumn" /> to a field in a data source. This allows you to display different captions for the buttons in the column using the values in the specified field. Set the <see cref="P:System.Web.UI.WebControls.ButtonColumn.DataTextField" /> property to bind the <see cref="T:System.Web.UI.WebControls.ButtonColumn" /> to a field in a data source.</para> 412 <para>The value of this property is stored in view state.</para> 413 <para>The value of this property, when set, can be saved automatically to a resource file by using a designer tool. For more information, see <see cref="T:System.ComponentModel.LocalizableAttribute" /> and <format type="text/html"><a href="8ef3838e-9d05-4236-9dd0-ceecff9df80d">ASP.NET Globalization and Localization</a></format>.</para> 414 </remarks> 415 <summary> 416 <attribution license="cc4" from="Microsoft" modified="false" /> 417 <para>Gets or sets the caption that is displayed in the buttons of the <see cref="T:System.Web.UI.WebControls.ButtonColumn" /> object.</para> 418 </summary> 419 </Docs> 420 <AssemblyInfo> 421 <AssemblyVersion>1.0.5000.0</AssemblyVersion> 422 <AssemblyVersion>2.0.0.0</AssemblyVersion> 423 </AssemblyInfo> 424 <Attributes> 425 <Attribute> 426 <AttributeName>System.ComponentModel.Localizable(true)</AttributeName> 427 </Attribute> 428 <Attribute> 429 <AttributeName>System.ComponentModel.DefaultValue("")</AttributeName> 430 </Attribute> 431 </Attributes> 432 </Member> 433 <Member MemberName="ValidationGroup"> 434 <MemberSignature Language="C#" Value="public virtual string ValidationGroup { set; get; }" /> 435 <MemberType>Property</MemberType> 436 <AssemblyInfo> 437 <AssemblyVersion>2.0.0.0</AssemblyVersion> 438 </AssemblyInfo> 439 <Attributes> 440 <Attribute> 441 <AttributeName>System.ComponentModel.DefaultValue("")</AttributeName> 442 </Attribute> 443 </Attributes> 444 <ReturnValue> 445 <ReturnType>System.String</ReturnType> 446 </ReturnValue> 447 <Docs> 448 <value>To be added.</value> 449 <remarks> 450 <attribution license="cc4" from="Microsoft" modified="false" /> 451 <para>Validation groups allow you to assign validation controls on a page to a specific category. Each validation group can be validated independently of other validation groups on the page. Use the <see cref="P:System.Web.UI.WebControls.ButtonColumn.ValidationGroup" /> property to specify the name of the validation group for which the <see cref="T:System.Web.UI.WebControls.ButtonColumn" /> object causes validation when it posts back to the server.</para> 452 <para>The <see cref="P:System.Web.UI.WebControls.ButtonColumn.ValidationGroup" /> property has an effect only when the value of the <see cref="P:System.Web.UI.WebControls.ButtonColumn.CausesValidation" /> property is set to true. When you specify a value for the <see cref="P:System.Web.UI.WebControls.ButtonColumn.ValidationGroup" /> property, only the validation controls that are part of the specified group are validated when the <see cref="T:System.Web.UI.WebControls.ButtonColumn" /> posts back to the server. If you do not specify a value for the <see cref="P:System.Web.UI.WebControls.ButtonColumn.ValidationGroup" /> property and the <see cref="P:System.Web.UI.WebControls.ButtonColumn.CausesValidation" /> property is set to true, all validation controls on the page that are not assigned to a validation group are validated when the <see cref="T:System.Web.UI.WebControls.ButtonColumn" /> posts back to the server.</para> 453 <para>The value of this property is stored in view state.</para> 454 </remarks> 455 <summary> 456 <attribution license="cc4" from="Microsoft" modified="false" /> 457 <para>Gets or sets the group of validation controls for which the <see cref="T:System.Web.UI.WebControls.ButtonColumn" /> object causes validation when it posts back to the server.</para> 458 </summary> 459 </Docs> 460 </Member> 461 </Members> 462</Type>