AutoGeneratedField Classe

Riferimento

Definizione

Spazio dei nomi:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Rappresenta un campo generato automaticamente in un controllo associato a dati. La classe non può essere ereditata.

public ref class AutoGeneratedField sealed : System::Web::UI::WebControls::BoundField

public sealed class AutoGeneratedField : System.Web.UI.WebControls.BoundField

type AutoGeneratedField = class
    inherit BoundField

Public NotInheritable Class AutoGeneratedField
Inherits BoundField

Ereditarietà: Object

DataControlField

BoundField
AutoGeneratedField

Esempio

Nell'esempio seguente viene illustrato come creare un oggetto per un AutoGeneratedField controllo personalizzato che deriva dal DetailsView controllo.


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

Commenti

La AutoGeneratedField classe viene usata per rappresentare un campo generato automaticamente in un controllo associato a dati, ad esempio GridView o DetailsView. I campi generati automaticamente vengono creati da un controllo associato a dati quando la proprietà appropriata è impostata su true (ad esempio, la AutoGenerateColumns proprietà per il GridView controllo, la AutoGenerateRows proprietà per il DetailsView controllo e così via).

Nota

I campi generati automaticamente non vengono aggiunti alla raccolta di campi di un controllo associato a dati, ad esempio la Columns raccolta per il controllo, la Fields raccolta per il DetailsView GridView controllo e così via.

La AutoGeneratedField classe è destinata all'uso internamente dai controlli associati ai dati. A differenza di altri campi dati (ad BoundFieldesempio , , CheckBoxField TemplateFielde così via), la AutoGeneratedField classe non può essere inserita in modo dichiarativo in una pagina come parte di una raccolta di campi. Anche se è possibile aggiungere a livello di codice un AutoGeneratedField oggetto a un insieme di campi, questo modello di progettazione deve essere evitato.

Poiché i campi generati automaticamente rappresentano il rendering automatico di un campo, i controlli associati ai dati non consentono in genere agli utenti di modificare le proprietà degli AutoGeneratedField oggetti. Se il rendering automatico non è adatto alle esigenze, definire i propri campi dati per la raccolta di campi del controllo.

Costruttori

AutoGeneratedField(String)

Inizializza una nuova istanza della classe AutoGeneratedField con il campo dati specificato.

Proprietà

AccessibleHeaderText	Ottiene o imposta il testo che viene sottoposto a rendering come valore della proprietà `AbbreviatedText` in alcuni controlli. (Ereditato da DataControlField)
ApplyFormatInEditMode	Ottiene o imposta un valore che indica se la stringa di formattazione specificata dalla proprietà DataFormatString è applicata a valori di campo quando il controllo con associazione a dati che contiene l'oggetto BoundField è in modalità di modifica. (Ereditato da BoundField)
Control	Ottiene un riferimento al controllo dati a cui l'oggetto DataControlField è associato. (Ereditato da DataControlField)
ControlStyle	Ottiene lo stile di tutti i controlli server Web contenuti nell'oggetto DataControlField. (Ereditato da DataControlField)
ConvertEmptyStringToNull	Ottiene o imposta un valore che indica se i valori stringa vuota ("") devono essere convertiti in `null` quando i valori dei campi vengono recuperati dall'origine dati.
DataField	Ottiene o imposta il nome del campo dati da associare all'oggetto BoundField. (Ereditato da BoundField)
DataFormatString	Ottiene o imposta la stringa che specifica il formato per il rendering del testo alternativo di ciascuna immagine di un oggetto AutoGeneratedField.
DataType	Ottiene o imposta il tipo di dati dei valori visualizzati in un oggetto AutoGeneratedField.
DesignMode	Ottiene un valore che indica se un campo di controllo dati è attualmente visualizzato in un ambiente di progettazione. (Ereditato da DataControlField)
FooterStyle	Ottiene o imposta lo stile del piè di pagina del campo di controllo dati. (Ereditato da DataControlField)
FooterText	Ottiene o imposta il testo visualizzato nell'elemento del piè di pagina del campo di controllo dati. (Ereditato da DataControlField)
HeaderImageUrl	Ottiene o imposta l'URL di un'immagine che viene visualizzata nell'elemento di intestazione di un campo di controlli dati. (Ereditato da DataControlField)
HeaderStyle	Ottiene o imposta lo stile dell'intestazione del campo di controllo dati. (Ereditato da DataControlField)
HeaderText	Ottiene o imposta il testo visualizzato nell'intestazione di un controllo dati. (Ereditato da BoundField)
HtmlEncode	Ottiene o imposta un valore che indica se i valori di campo sono codificati in HTML prima di essere visualizzati in un oggetto BoundField. (Ereditato da BoundField)
HtmlEncodeFormatString	Ottiene o imposta un valore che indica se il testo creato applicando la proprietà DataFormatString al valore BoundField deve essere codificato in formato HTML al momento della visualizzazione. (Ereditato da BoundField)
InsertVisible	Ottiene o imposta un valore che indica se l'oggetto AutoGeneratedField è visibile in modalità di inserimento.
IsTrackingViewState	Ottiene un valore che indica se l'oggetto DataControlField sta salvando le modifiche apportate al relativo stato di visualizzazione. (Ereditato da DataControlField)
ItemStyle	Ottiene lo stile di tutti i contenuti basati sul testo visualizzati da un campo di controllo dati. (Ereditato da DataControlField)
NullDisplayText	Ottiene o imposta la didascalia visualizzata per un campo quando il valore del campo è null. (Ereditato da BoundField)
ReadOnly	Ottiene o imposta un valore che indica se il valore del campo può essere modificato in modalità di modifica. (Ereditato da BoundField)
ShowHeader	Ottiene o imposta un valore che indica se viene eseguito il rendering dell'elemento di intestazione di un campo di controllo dati. (Ereditato da DataControlField)
SortExpression	Ottiene o imposta l'espressione di ordinamento che viene utilizzata da un controllo origine dati per ordinare i dati. (Ereditato da DataControlField)
SupportsHtmlEncode	Ottiene un valore che indica se la codifica in HTML è supportata da un oggetto BoundField. (Ereditato da BoundField)
ValidateRequestMode	Ottiene o imposta un valore che determina se il controllo convalida l'input del client. (Ereditato da BoundField)
ViewState	Ottiene un dizionario di informazioni sullo stato che consente di salvare e ripristinare lo stato di visualizzazione di un oggetto DataControlField tra più richieste per la stessa pagina. (Ereditato da DataControlField)
Visible	Ottiene o imposta un valore che indica se viene eseguito il rendering di un campo di controllo dati. (Ereditato da DataControlField)

Metodi

CloneField()	Crea una copia duplicata dell'oggetto corrente derivato da DataControlField. (Ereditato da DataControlField)
CopyProperties(DataControlField)	Copia le proprietà dell'oggetto BoundField corrente nell'oggetto DataControlField specificato. (Ereditato da BoundField)
CreateField()	Crea un oggetto BoundField vuoto. (Ereditato da BoundField)
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)	Inserisce nell'oggetto IOrderedDictionary specificato i valori dell'oggetto DataControlFieldCell specificato.
FormatDataValue(Object, Boolean)	Esegue la formattazione del valore di campo specificato per una cella nell'oggetto BoundField. (Ereditato da BoundField)
GetDesignTimeValue()	Recupera il valore utilizzato per il valore di un campo quando si esegue il rendering dell'oggetto BoundField in una finestra di progettazione. (Ereditato da BoundField)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
GetValue(Control)	Recupera il valore del campo associato all'oggetto BoundField. (Ereditato da BoundField)
Initialize(Boolean, Control)	Inizializza l'oggetto BoundField. (Ereditato da BoundField)
InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)	Inizializza l'oggetto TableCell specificato nello stato della riga specificata. (Ereditato da BoundField)
InitializeDataCell(DataControlFieldCell, DataControlRowState)	Inizializza l'oggetto TableCell specificato nello stato della riga specificata. (Ereditato da BoundField)
LoadViewState(Object)	Ripristina le informazioni sullo stato di visualizzazione precedentemente archiviate per questo campo. (Ereditato da BoundField)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
OnDataBindField(Object, EventArgs)	Associa il valore di un campo all'oggetto BoundField. (Ereditato da BoundField)
OnFieldChanged()	Genera l'evento `FieldChanged`. (Ereditato da DataControlField)
SaveViewState()	Salva le modifiche apportate allo stato di visualizzazione DataControlField dal momento in cui è stato eseguito il postback della pagina al server. (Ereditato da DataControlField)
ToString()	Restituisce una stringa che rappresenta questo oggetto DataControlField. (Ereditato da DataControlField)
TrackViewState()	Mediante questo metodo l'oggetto DataControlField tiene traccia delle modifiche apportate al relativo stato di visualizzazione in modo che possano essere memorizzate nella proprietà ViewState del controllo e mantenute nelle richieste della stessa pagina. (Ereditato da DataControlField)
ValidateSupportsCallback()	Determina se i controlli contenuti in un oggetto AutoGeneratedField supportano i callback.

Implementazioni dell'interfaccia esplicita

IDataSourceViewSchemaAccessor.DataSourceViewSchema	Ottiene o imposta lo schema associato all'oggetto DataControlField. (Ereditato da DataControlField)
IStateManager.IsTrackingViewState	Ottiene un valore che indica se l'oggetto DataControlField sta salvando le modifiche apportate al relativo stato di visualizzazione. (Ereditato da DataControlField)
IStateManager.LoadViewState(Object)	Ripristina lo stato di visualizzazione del campo del controllo dati salvato in precedenza. (Ereditato da DataControlField)
IStateManager.SaveViewState()	Salva le modifiche apportate allo stato di visualizzazione DataControlField dal momento in cui è stato eseguito il postback della pagina al server. (Ereditato da DataControlField)
IStateManager.TrackViewState()	Mediante questo metodo l'oggetto DataControlField tiene traccia delle modifiche apportate al relativo stato di visualizzazione in modo che possano essere memorizzate nella proprietà ViewState del controllo e mantenute nelle richieste della stessa pagina. (Ereditato da DataControlField)

Si applica a

Condividi tramite