AutoGeneratedField Třída

Definice

Obor názvů:

System.Web.UI.WebControls

Sestavení:

System.Web.dll

Představuje automaticky generované pole v ovládacím prvku vázaném na data. Tuto třídu nelze zdědit.

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

Dědičnost

Object

DataControlField

BoundField

AutoGeneratedField

Příklady

Následující příklad ukazuje, jak vytvořit AutoGeneratedField objekt pro vlastní ovládací prvek, který je odvozen z DetailsView ovládacího prvku.

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

Poznámky

Třída AutoGeneratedField se používá k reprezentaci automaticky generovaného pole v ovládacím prvku vázaném na data, například GridView nebo DetailsView. Automaticky generovaná pole jsou vytvořena ovládacím prvku vázaném na data, pokud je příslušná vlastnost nastavena true (například AutoGenerateColumns vlastnost GridView ovládacího prvku, AutoGenerateRows vlastnost DetailsView ovládacího prvku atd.).

Poznámka:

Automaticky generovaná pole nejsou přidána do kolekce polí ovládacího prvku vázaného na data (například Columns kolekce pro GridView ovládací prvek, Fields kolekce pro DetailsView ovládací prvek atd.).

Třída AutoGeneratedField je určena interně pro ovládací prvky vázané na data. Na rozdíl od jiných datových polí (například BoundField, CheckBoxField, TemplateFieldatd.) AutoGeneratedField nelze třídu deklarativní umístit na stránku jako součást kolekce polí. I když můžete do kolekce polí přidat AutoGeneratedField objekt prostřednictvím kódu programu, měli byste se tomuto vzoru návrhu vyhnout.

Vzhledem k tomu, že automaticky generovaná pole představují automatické vykreslování pole, ovládací prvky vázané na data obvykle neumožňují uživatelům upravovat vlastnosti AutoGeneratedField objektů. Pokud automatické vykreslování není vhodné pro vaše potřeby, definujte vlastní datová pole pro kolekci polí ovládacího prvku.

Konstruktory

Name	Description
AutoGeneratedField(String)	Inicializuje novou instanci AutoGeneratedField třídy se zadaným datovým polem.

Vlastnosti

Name	Description
AccessibleHeaderText	Získá nebo nastaví text, který je vykreslen jako AbbreviatedText hodnota vlastnosti v některých ovládacích prvcích. (Zděděno od DataControlField)
ApplyFormatInEditMode	Získá nebo nastaví hodnotu určující, zda formátovací řetězec určený DataFormatString vlastností je použita na hodnoty pole, když ovládací prvek vázané na data obsahující BoundField objekt je v režimu úprav. (Zděděno od BoundField)
Control	Získá odkaz na ovládací prvek dat, ke kterému DataControlField je objekt přidružen. (Zděděno od DataControlField)
ControlStyle	Získá styl všech ovládacích prvků webového serveru obsažené objektu DataControlField . (Zděděno od DataControlField)
ConvertEmptyStringToNull	Získá nebo nastaví hodnotu označující, zda jsou hodnoty prázdného řetězce ("") převedeny na null při načtení hodnot pole ze zdroje dat.
DataField	Získá nebo nastaví název datového pole pro vazbu k objektu BoundField . (Zděděno od BoundField)
DataFormatString	Získá nebo nastaví řetězec, který určuje formát, ve kterém je vykreslen alternativní text pro každý obrázek v objektu AutoGeneratedField .
DataType	Získá nebo nastaví datový typ hodnot zobrazených v objektu AutoGeneratedField .
DesignMode	Získá hodnotu označující, zda pole ovládacího prvku dat je aktuálně zobrazeno v návrhovém prostředí. (Zděděno od DataControlField)
FooterStyle	Získá nebo nastaví styl zápatí pole ovládacího prvku dat. (Zděděno od DataControlField)
FooterText	Získá nebo nastaví text, který je zobrazen v zápatí položky pole ovládacího prvku dat. (Zděděno od DataControlField)
HeaderImageUrl	Získá nebo nastaví adresu URL obrázku, který se zobrazí v položce záhlaví pole ovládacího prvku dat. (Zděděno od DataControlField)
HeaderStyle	Získá nebo nastaví styl záhlaví pole ovládacího prvku dat. (Zděděno od DataControlField)
HeaderText	Získá nebo nastaví text zobrazený v záhlaví ovládacího prvku dat. (Zděděno od BoundField)
HtmlEncode	Získá nebo nastaví hodnotu určující, zda hodnoty pole jsou kódovány HTML před jejich zobrazením v objektu BoundField . (Zděděno od BoundField)
HtmlEncodeFormatString	Získá nebo nastaví hodnotu, která určuje, zda text, který je vytvořen použitím DataFormatString vlastnosti na BoundField hodnotu by měl být KÓD HTML při zobrazení. (Zděděno od BoundField)
InsertVisible	Získá nebo nastaví hodnotu určující, zda AutoGeneratedField je objekt viditelný v režimu vložení.
IsTrackingViewState	Získá hodnotu určující, zda DataControlField objekt ukládá změny do jeho stavu zobrazení. (Zděděno od DataControlField)
ItemStyle	Získá styl libovolného textového obsahu zobrazeného polem ovládacího prvku dat. (Zděděno od DataControlField)
NullDisplayText	Získá nebo nastaví titulek zobrazený pro pole, pokud hodnota pole je null. (Zděděno od BoundField)
ReadOnly	Získá nebo nastaví hodnotu určující, zda hodnotu pole lze upravit v režimu úprav. (Zděděno od BoundField)
ShowHeader	Získá nebo nastaví hodnotu určující, zda je položka záhlaví pole ovládacího prvku dat vykreslena. (Zděděno od DataControlField)
SortExpression	Získá nebo nastaví výraz řazení, který používá ovládací prvek zdroje dat k řazení dat. (Zděděno od DataControlField)
SupportsHtmlEncode	Získá hodnotu označující, zda kódování HTML je podporováno objektem BoundField . (Zděděno od BoundField)
ValidateRequestMode	Získá nebo nastaví hodnotu, která určuje, zda ovládací prvek ověřuje vstup klienta, nebo ne. (Zděděno od BoundField)
ViewState	Získá slovník informací o stavu, který umožňuje uložit a obnovit stav zobrazení objektu DataControlField napříč více požadavky na stejnou stránku. (Zděděno od DataControlField)
Visible	Získá nebo nastaví hodnotu určující, zda je pole ovládacího prvku dat vykresleno. (Zděděno od DataControlField)

Metody

Name	Description
CloneField()	Vytvoří duplicitní kopii aktuálního DataControlFieldodvozeného objektu. (Zděděno od DataControlField)
CopyProperties(DataControlField)	Zkopíruje vlastnosti aktuálního BoundField objektu do zadaného DataControlField objektu. (Zděděno od BoundField)
CreateField()	Vytvoří prázdný BoundField objekt. (Zděděno od BoundField)
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)	Vyplní zadaný IOrderedDictionary objekt hodnotami ze zadaného DataControlFieldCell objektu.
FormatDataValue(Object, Boolean)	Naformátuje zadanou hodnotu pole pro buňku v objektu BoundField . (Zděděno od BoundField)
GetDesignTimeValue()	Načte hodnotu použitou pro hodnotu pole při vykreslování BoundField objektu v návrháři. (Zděděno od BoundField)
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetType()	Získá Type aktuální instance. (Zděděno od Object)
GetValue(Control)	Načte hodnotu pole vázaného na BoundField objekt. (Zděděno od BoundField)
Initialize(Boolean, Control)	Inicializuje BoundField objekt. (Zděděno od BoundField)
InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)	Inicializuje zadaný TableCell objekt do zadaného stavu řádku. (Zděděno od BoundField)
InitializeDataCell(DataControlFieldCell, DataControlRowState)	Inicializuje zadaný TableCell objekt do zadaného stavu řádku. (Zděděno od BoundField)
LoadViewState(Object)	Obnoví dříve uložené informace o stavu zobrazení pro toto pole. (Zděděno od BoundField)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
OnDataBindField(Object, EventArgs)	Vytvoří vazbu hodnoty pole na BoundField objekt. (Zděděno od BoundField)
OnFieldChanged()	FieldChanged Vyvolá událost. (Zděděno od DataControlField)
SaveViewState()	Uloží změny provedené ve DataControlField stavu zobrazení od doby, kdy byla stránka odeslána zpět na server. (Zděděno od DataControlField)
ToString()	Vrátí řetězec, který představuje tento DataControlField objekt. (Zděděno od DataControlField)
TrackViewState()	Způsobí, že DataControlField objekt bude sledovat změny stavu zobrazení, aby je bylo možné uložit do vlastnosti ovládacího prvku ViewState a zachovat v rámci požadavků na stejnou stránku. (Zděděno od DataControlField)
ValidateSupportsCallback()	Určuje, zda ovládací prvky obsažené v objektu AutoGeneratedField podporují zpětné volání.

Explicitní implementace rozhraní

Name	Description
IDataSourceViewSchemaAccessor.DataSourceViewSchema	Získá nebo nastaví schéma přidružené k tomuto DataControlField objektu. (Zděděno od DataControlField)
IStateManager.IsTrackingViewState	Získá hodnotu určující, zda DataControlField objekt ukládá změny do jeho stavu zobrazení. (Zděděno od DataControlField)
IStateManager.LoadViewState(Object)	Obnoví dříve uložený stav zobrazení pole ovládacího prvku dat. (Zděděno od DataControlField)
IStateManager.SaveViewState()	Uloží změny provedené ve DataControlField stavu zobrazení od doby, kdy byla stránka odeslána zpět na server. (Zděděno od DataControlField)
IStateManager.TrackViewState()	Způsobí, že DataControlField objekt bude sledovat změny stavu zobrazení, aby je bylo možné uložit do vlastnosti ovládacího prvku ViewState a zachovat v rámci požadavků na stejnou stránku. (Zděděno od DataControlField)

Viz také

• DetailsView
• GridView
• AutoGeneratedFieldProperties
• BoundField
• ButtonField
• CheckBoxField
• CommandField
• HyperLinkField
• ImageField
• TemplateField
• Columns
• Fields
• CreateAutoGeneratedColumn(AutoGeneratedFieldProperties)
• CreateAutoGeneratedRow(AutoGeneratedFieldProperties)