AutoGeneratedFieldProperties 類別

  • 參考

定義

命名空間:
System.Web.UI.WebControls
組件:
System.Web.dll

表示 AutoGeneratedField 物件的屬性。 此類別無法獲得繼承。

public ref class AutoGeneratedFieldProperties sealed : System::Web::UI::IStateManager
public sealed class AutoGeneratedFieldProperties : System.Web.UI.IStateManager
type AutoGeneratedFieldProperties = class
    interface IStateManager
Public NotInheritable Class AutoGeneratedFieldProperties
Implements IStateManager
繼承
Object
AutoGeneratedFieldProperties
實作
IStateManager

範例

下列程式碼範例示範如何使用 AutoGeneratedFieldProperties 類別，在衍生自 控制項的 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

備註

資料 AutoGeneratedFieldProperties 繫結控制項會使用 類別，在建立自動產生的欄位時指定物件的屬性 AutoGeneratedField 。 例如，當控制項建立自動產生的資料列時 DetailsView ，它會建立 AutoGeneratedFieldProperties 具有資料列屬性的物件，並將它傳遞至 CreateAutoGeneratedRow 方法。 同樣地，控制項會在 GridView 建立自動產生的資料行時，將物件傳遞 AutoGeneratedFieldProperties 至 CreateAutoGeneratedColumn 方法。

注意

只有在擴充 GridView 或 DetailsView 控制項時，才會使用這個類別。

您可以藉由設定 DataField 屬性，指定要系結至 AutoGeneratedField 物件的功能變數名稱。 若要指定域值的資料類型，請設定 Type 屬性。 您可以將 屬性設定 IsReadOnly 為 true ，以防止使用者修改域值。 您也可以藉由設定 Name 屬性，將名稱指派給 AutoGeneratedField 物件。

建構函式

AutoGeneratedFieldProperties()

初始化 AutoGeneratedFieldProperties 類別的新執行個體。

屬性

DataField

取得或設定要繫結至 AutoGeneratedField 物件的欄位名稱。
IsReadOnly

取得或設定值，指出 AutoGeneratedField 物件中顯示的值是否可以編輯模式進行修改。
Name

取得或設定 AutoGeneratedField 物件的名稱。
Type

取得或設定在 AutoGeneratedFieldProperties 物件中顯示之值的資料型別。

方法

Equals(Object)

判斷指定的物件是否等於目前的物件。

(繼承來源 Object)
GetHashCode()

做為預設雜湊函式。

(繼承來源 Object)
GetType()

取得目前執行個體的 Type。

(繼承來源 Object)
MemberwiseClone()

建立目前 Object 的淺層複製。

(繼承來源 Object)
ToString()

傳回代表目前物件的字串。

(繼承來源 Object)

明確介面實作

IStateManager.IsTrackingViewState

取得值，指出 AutoGeneratedFieldProperties 物件是否正在追蹤它的檢視狀態變更。
IStateManager.LoadViewState(Object)

載入先前儲存的 AutoGeneratedFieldProperties 物件檢視狀態。
IStateManager.SaveViewState()

儲存 AutoGeneratedFieldProperties 物件的目前檢視狀態。
IStateManager.TrackViewState()

標示起點，在開始追蹤並儲存檢視狀態變更至 AutoGeneratedFieldProperties 物件。

適用於

另請參閱