AutoGeneratedField Classe
Definizione
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::BoundFieldpublic sealed class AutoGeneratedField : System.Web.UI.WebControls.BoundFieldtype AutoGeneratedField = class
inherit BoundFieldPublic NotInheritable Class AutoGeneratedField
Inherits BoundField- Ereditarietà
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 DetailsViewGridView controllo e così via.
La AutoGeneratedField classe è destinata all'uso internamente dai controlli associati ai dati. A differenza di altri campi dati (ad BoundFieldesempio , , CheckBoxFieldTemplateFielde 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à |
| 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 |
| 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 |
| 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) |
