AutoGeneratedFieldProperties Classe

Definição

Espaço de Nomes:
System.Web.UI.WebControls
Assemblagem:
System.Web.dll

Representa as propriedades de um AutoGeneratedField objeto. Esta classe não pode ser herdada.

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
Herança
Object
AutoGeneratedFieldProperties
Implementações
IStateManager

Exemplos

O exemplo de código seguinte demonstra como usar a AutoGeneratedFieldProperties classe para criar um AutoGeneratedField objeto num controlo personalizado que deriva desse DetailsView controlo.


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

Observações

A AutoGeneratedFieldProperties classe é usada por controlos de dados para especificar as propriedades de um AutoGeneratedField objeto ao criar um campo gerado automaticamente. Por exemplo, quando o controlo DetailsView cria uma linha gerada automaticamente, cria um AutoGeneratedFieldProperties objeto com as propriedades da linha e passa-o para o CreateAutoGeneratedRow método. Da mesma forma, o controlo GridView passa um AutoGeneratedFieldProperties objeto ao CreateAutoGeneratedColumn método ao criar uma coluna gerada automaticamente.

Note

Esta classe é normalmente usada apenas quando se estende o controlo GridView de ou DetailsView .

Podes especificar o nome do campo a vincular a um AutoGeneratedField objeto definindo a DataField propriedade. Para especificar o tipo de dado dos valores dos campos, defina a Type propriedade . Pode impedir que os utilizadores modifiquem os valores dos campos definindo a IsReadOnly propriedade para true. Também pode atribuir um nome a um AutoGeneratedField objeto definindo a Name propriedade.

Construtores

Name Description
AutoGeneratedFieldProperties()

Inicializa uma nova instância da AutoGeneratedFieldProperties classe.

Propriedades

Name Description
DataField

Obtém ou define o nome do campo associado ao AutoGeneratedField objeto.
IsReadOnly

Recebe ou define um valor que indica se os valores exibidos num AutoGeneratedField objeto podem ser modificados em modo de edição.
Name

Obtém ou define o nome do AutoGeneratedField objeto.
Type

Obtém ou define o tipo de dado do valor apresentado num AutoGeneratedFieldProperties objeto.

Métodos

Name Description
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)

Implementações de Interface Explícita

Name Description
IStateManager.IsTrackingViewState

Obtém um valor que indica se o AutoGeneratedFieldProperties objeto está a acompanhar as suas alterações de estado de visualização.
IStateManager.LoadViewState(Object)

Carrega o estado de visualização previamente guardado do AutoGeneratedFieldProperties objeto.
IStateManager.SaveViewState()

Guarda o estado atual da vista do AutoGeneratedFieldProperties objeto.
IStateManager.TrackViewState()

Marca o ponto de partida a partir do qual se deve começar a registar e guardar as alterações de estado de visualização do AutoGeneratedFieldProperties objeto.

Aplica-se a

Ver também