AutoGeneratedField 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
代表資料繫結控制項中自動產生的欄位。 此類別無法獲得繼承。
public ref class AutoGeneratedField sealed : System::Web::UI::WebControls::BoundFieldpublic sealed class AutoGeneratedField : System.Web.UI.WebControls.BoundFieldtype AutoGeneratedField = class
inherit BoundFieldPublic NotInheritable Class AutoGeneratedField
Inherits BoundField- 繼承
範例
下列範例示範如何為衍生自 控制項的 DetailsView 自訂控制項建立 AutoGeneratedField 物件。
using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Text;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Security.Permissions;
using System.Web;
namespace Samples.AspNet.CS.Controls
{
[AspNetHostingPermission(SecurityAction.Demand, Level=AspNetHostingPermissionLevel.Minimal)]
[AspNetHostingPermission(SecurityAction.InheritanceDemand, Level=AspNetHostingPermissionLevel.Minimal)]
public class SimpleCustomControl : DetailsView
{
protected override AutoGeneratedField CreateAutoGeneratedRow(AutoGeneratedFieldProperties fieldProperties)
{
// Create an AutoGeneratedField object.
AutoGeneratedField field = new AutoGeneratedField(fieldProperties.DataField);
// Set the properties of the AutoGeneratedField using
// the values from the AutoGeneratedFieldProperties
// object contained in the fieldProperties parameter.
((IStateManager)field).TrackViewState();
field.HeaderText = fieldProperties.Name;
field.SortExpression = fieldProperties.Name;
field.ReadOnly = fieldProperties.IsReadOnly;
field.DataType = fieldProperties.Type;
return field;
}
}
}
Imports System.ComponentModel
Imports System.Web.UI
Imports System.Web.UI.WebControls
Imports System.Security.Permissions
Imports System.Web
Namespace Samples.AspNet.VB.Controls
<AspNetHostingPermission(SecurityAction.Demand, Level:=AspNetHostingPermissionLevel.Minimal), AspNetHostingPermission(SecurityAction.InheritanceDemand, Level:=AspNetHostingPermissionLevel.Minimal)> Public Class SimpleCustomControl
Inherits System.Web.UI.WebControls.DetailsView
Protected Overrides Function CreateAutoGeneratedRow(ByVal fieldProperties As AutoGeneratedFieldProperties) As AutoGeneratedField
' Create an AutoGeneratedField object.
Dim field As New AutoGeneratedField(fieldProperties.DataField)
' Set the properties of the AutoGeneratedField using
' the values from the AutoGeneratedFieldProperties
' object contained in the fieldProperties parameter.
CType(field, IStateManager).TrackViewState()
field.HeaderText = fieldProperties.Name
field.SortExpression = fieldProperties.Name
field.ReadOnly = fieldProperties.IsReadOnly
field.DataType = fieldProperties.Type
Return field
End Function
End Class
End Namespace
備註
類別 AutoGeneratedField 是用來表示資料繫結控制項中自動產生的欄位，例如 GridView 或 DetailsView 。 當適當的屬性設定為 true (、控制項的 屬性、 AutoGenerateRows 控制項的 屬性 GridView DetailsView) 等等時， AutoGenerateColumns 會自動產生的欄位是由資料繫結控制項所建立。
注意
自動產生的欄位不會新增至資料繫結控制項的欄位集合 (，例如控制項 Columns 的集合、 Fields 控制項的 DetailsView 集合 GridView 等等) 。
類別 AutoGeneratedField 適用于資料繫結控制項在內部使用。 不同于其他資料欄位 (例如 BoundField 、 CheckBoxField 、 TemplateField 等等) ， AutoGeneratedField 類別不能以宣告方式放置在頁面上做為欄位集合的一部分。 雖然您可以以程式設計方式將物件新增 AutoGeneratedField 至欄位集合，但應該避免此設計模式。
由於自動產生的欄位代表欄位的自動轉譯，因此資料繫結控制項通常不允許使用者修改物件的屬性 AutoGeneratedField 。 如果自動轉譯不適合您的需求，請為控制項的欄位集合定義您自己的資料欄位。
建構函式
| AutoGeneratedField(String) |
使用指定的資料欄位，初始化 AutoGeneratedField 類別的新執行個體。 |
屬性
| AccessibleHeaderText |
取得或設定在部分控制項中呈現為 |
| ApplyFormatInEditMode |
取得或設定值，表示當包含 DataFormatString 物件的資料繫結控制項處於編輯模式時，是否將 BoundField 屬性指定的格式字串套用至欄位值。 (繼承來源 BoundField) |
| Control |
取得與 DataControlField 物件關聯之資料控制項的參考。 (繼承來源 DataControlField) |
| ControlStyle |
取得 DataControlField 物件內含之任何 Web 伺服器控制項的樣式。 (繼承來源 DataControlField) |
| ConvertEmptyStringToNull |
取得或設定值，指出從資料來源擷取欄位值時，是否將空字串 ("") 值轉換成 |
| DataField |
取得或設定要繫結至 BoundField 物件之資料欄位的名稱。 (繼承來源 BoundField) |
| DataFormatString |
取得或設定字串，指定 AutoGeneratedField 物件中每個影像之替代文字的呈現格式。 |
| DataType |
取得或設定 AutoGeneratedField 物件中顯示之值的資料類型。 |
| DesignMode |
取得值，指示目前是否在設計階段環境中檢視資料控制項欄位。 (繼承來源 DataControlField) |
| FooterStyle |
取得或設定資料控制項欄位的頁尾樣式。 (繼承來源 DataControlField) |
| FooterText |
取得或設定顯示在資料控制項欄位之頁尾項目中的文字。 (繼承來源 DataControlField) |
| HeaderImageUrl |
取得或設定顯示在資料控制項欄位的標頭項目中之影像的 URL。 (繼承來源 DataControlField) |
| HeaderStyle |
取得或設定資料控制項欄位的標頭樣式。 (繼承來源 DataControlField) |
| HeaderText |
取得或設定顯示在資料控制項標頭中的文字。 (繼承來源 BoundField) |
| HtmlEncode |
取得或設定值，表示在 BoundField 物件中顯示欄位值之前，是否對其進行 HTML 編碼。 (繼承來源 BoundField) |
| HtmlEncodeFormatString |
取得或設定值，這個值表示透過將 DataFormatString 屬性套用至 BoundField 值來建立的文字在顯示時，是否應該經過 HTML 編碼。 (繼承來源 BoundField) |
| InsertVisible |
取得或設定值，指出 AutoGeneratedField 物件在插入模式中是否可見。 |
| IsTrackingViewState |
取得值，指出 DataControlField 物件是否正在將變更儲存到它的檢視狀態。 (繼承來源 DataControlField) |
| ItemStyle |
取得由資料控制項欄位顯示之任何文字基礎內容的樣式。 (繼承來源 DataControlField) |
| NullDisplayText |
取得或設定欄位值為 null 時所顯示的欄位標題。 (繼承來源 BoundField) |
| ReadOnly |
取得或設定值，表示是否可以在編輯模式下修改欄位值。 (繼承來源 BoundField) |
| ShowHeader |
取得或設定值，指示是否呈現資料控制項欄位的標頭項目。 (繼承來源 DataControlField) |
| SortExpression |
取得或設定資料來源控制項用於排序資料的排序運算式。 (繼承來源 DataControlField) |
| SupportsHtmlEncode |
取得值，表示 BoundField 物件是否支援 HTML 編碼。 (繼承來源 BoundField) |
| ValidateRequestMode |
取得或設定值，決定控制項是否驗證用戶端輸入。 (繼承來源 BoundField) |
| ViewState |
取得狀態資訊的字典，允許您在相同頁面的多個要求之間，儲存和還原 DataControlField 物件的檢視狀態。 (繼承來源 DataControlField) |
| Visible |
取得或設定值，指示是否呈現資料控制項欄位。 (繼承來源 DataControlField) |
方法
明確介面實作
| IDataSourceViewSchemaAccessor.DataSourceViewSchema |
取得或設定與此 DataControlField 物件相關聯的結構描述。 (繼承來源 DataControlField) |
| IStateManager.IsTrackingViewState |
取得值，指出 DataControlField 物件是否正在將變更儲存到它的檢視狀態。 (繼承來源 DataControlField) |
| IStateManager.LoadViewState(Object) |
將資料控制項欄位還原成先前儲存的檢視狀態。 (繼承來源 DataControlField) |
| IStateManager.SaveViewState() |
儲存自頁面回傳至伺服器以來對 DataControlField 檢視狀態所做的變更。 (繼承來源 DataControlField) |
| IStateManager.TrackViewState() |
會造成 DataControlField 物件追蹤其檢視狀態變更，以將這些變更儲存在控制項的 ViewState 屬性中，並持續存取相同頁面的其他要求。 (繼承來源 DataControlField) |