AutoGeneratedField Třída

Reference

Definice

Obor názvů:: System.Web.UI.WebControls

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Představuje automaticky vygenerované pole v ovládacím prvku vázaném na data. Tuto třídu nelze dě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 slouží k reprezentaci automaticky generovaného pole v ovládacím prvku vázaném na data, například GridView nebo DetailsView. Automaticky generovaná pole se vytvářejí ovládacím prvekem vázaném na data, když je příslušná vlastnost nastavená 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 pro interní použití ovládacími prvky svázanými daty. 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 objekt do kolekce polí přidat AutoGeneratedField prostřednictvím kódu programu, měli byste se tomuto vzoru návrhu vyhnout.

Protož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

AutoGeneratedField(String)

Inicializuje novou instanci AutoGeneratedField třídy se zadaným datovým polem.

Vlastnosti

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 označující, zda formátovací řetězec zadaný DataFormatString vlastností se použije na hodnoty polí, 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 webových server ovládacích prvků obsažených objektem DataControlField . (Zděděno od DataControlField)
ConvertEmptyStringToNull	Získá nebo nastaví hodnotu určující, zda se hodnoty prázdného řetězce ("") převedou na, když `null` se hodnoty polí načtou 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 je pole ovládacího prvku dat 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, který je zobrazen v záhlaví ovládacího prvku dat. (Zděděno od BoundField)
HtmlEncode	Získá nebo nastaví hodnotu označující, zda hodnoty polí 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á označ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 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, když je hodnota pole null. (Zděděno od BoundField)
ReadOnly	Získá nebo nastaví hodnotu určující, zda lze hodnotu pole 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 je kódování HTML 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 DataControlField zobrazení objektu napříč více požadavky na stejnou stránku. (Zděděno od DataControlField)
Visible	Získá nebo nastaví hodnotu označující, zda je pole ovládacího prvku dat vykresleno. (Zděděno od DataControlField)

Metody

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čí, zda se zadaný objekt rovná 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()	Type Získá aktuální instanci. (Zděděno od Object)
GetValue(Control)	Načte hodnotu pole vázaného BoundField na 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ří použádnou kopii aktuálního souboru Object. (Zděděno od Object)
OnDataBindField(Object, EventArgs)	Vytvoří vazbu na hodnotu pole s objektem BoundField . (Zděděno od BoundField)
OnFieldChanged()	Vyvolá `FieldChanged` událost. (Zděděno od DataControlField)
SaveViewState()	Uloží změny provedené ve DataControlField stavu zobrazení od doby, kdy byla stránka publiková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í, DataControlField že objekt bude sledovat změny ve stavu zobrazení, aby je bylo možné uložit do vlastnosti ovládacího prvku ViewState a zachovat napříč požadavky 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í

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 označující, zda DataControlField objekt ukládá změny do 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 publikována zpět na server. (Zděděno od DataControlField)
IStateManager.TrackViewState()	Způsobí, DataControlField že objekt bude sledovat změny ve stavu zobrazení, aby je bylo možné uložit do vlastnosti ovládacího prvku ViewState a zachovat napříč požadavky na stejnou stránku. (Zděděno od DataControlField)

Platí pro