AutoGeneratedFieldProperties Classe

Referência

Definição

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Representa as propriedades de um objeto AutoGeneratedField. Essa 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 a seguir demonstra como usar a AutoGeneratedFieldProperties classe para criar um AutoGeneratedField objeto em um controle personalizado que deriva do DetailsView controle.


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

Comentários

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

Observação

Normalmente, essa classe é usada somente ao estender o controle ou DetailsView o GridView controle.

Você pode especificar o nome do campo a ser associado a um AutoGeneratedField objeto definindo a DataField propriedade. Para especificar o tipo de dados dos valores de campo, defina a Type propriedade. Você pode impedir que os usuários modifiquem os valores de campo definindo a IsReadOnly propriedade como true. Você também pode atribuir um nome a um AutoGeneratedField objeto definindo a Name propriedade.

Construtores

AutoGeneratedFieldProperties()

Inicializa uma nova instância da classe AutoGeneratedFieldProperties.

Propriedades

DataField	Obtém ou define o nome do campo associado ao objeto AutoGeneratedField.
IsReadOnly	Obtém ou define um valor que indica se os valores exibidos em um objeto AutoGeneratedField podem ser modificado no modo de edição.
Name	Obtém ou define o nome do objeto AutoGeneratedField.
Type	Obtém ou define o tipo de dados do valor exibido em um objeto AutoGeneratedFieldProperties.

Métodos

Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Implantações explícitas de interface

IStateManager.IsTrackingViewState	Obtém um valor que indica se o objeto AutoGeneratedFieldProperties está controlando suas alterações de estado de exibição.
IStateManager.LoadViewState(Object)	Carrega o estado de exibição salvo anteriormente do objeto AutoGeneratedFieldProperties.
IStateManager.SaveViewState()	Salva o estado de exibição atual do objeto AutoGeneratedFieldProperties.
IStateManager.TrackViewState()	Marca o ponto inicial no qual começar a acompanhar e salvar as alterações de estado de exibição no objeto AutoGeneratedFieldProperties.

Aplica-se a

Partilhar via