Språk

AutoGeneratedField Klass

Definition

Namnområde:
System.Web.UI.WebControls
Sammansättning:
System.Web.dll

Representerar ett automatiskt genererat fält i en databunden kontroll. Det går inte att ärva den här klassen.

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
Arv
Object
DataControlField
BoundField
AutoGeneratedField

Exempel

I följande exempel visas hur du skapar ett AutoGeneratedField objekt för en anpassad kontroll som härleds från DetailsView kontrollen.


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

Kommentarer

Klassen AutoGeneratedField används för att representera ett automatiskt genererat fält i en databunden kontroll, till exempel GridView eller DetailsView. Automatiskt genererade fält skapas av en databunden kontroll när lämplig egenskap är inställd på (till true exempel AutoGenerateColumns egenskapen för GridView kontrollen, AutoGenerateRows egenskapen för DetailsView kontrollen och så vidare).

Note

Automatiskt genererade fält läggs inte till i fältsamlingen för en databunden kontroll (till exempel Columns samlingen för GridView kontrollen, Fields samlingen för DetailsView kontrollen och så vidare).

Klassen AutoGeneratedField är avsedd att användas internt av databundna kontroller. Till skillnad från andra datafält (till exempel BoundField, CheckBoxField, TemplateFieldoch så vidare) AutoGeneratedField kan klassen inte placeras deklarativt på en sida som en del av en fältsamling. Även om du programmatiskt kan lägga till ett AutoGeneratedField objekt i en fältsamling bör du undvika det här designmönstret.

Eftersom automatiskt genererade fält representerar automatisk återgivning av ett fält tillåter databundna kontroller vanligtvis inte användare att ändra egenskaperna för objekten AutoGeneratedField . Om den automatiska återgivningen inte är lämplig för dina behov definierar du dina egna datafält för kontrollens fältsamling.

Konstruktorer

Name Description
AutoGeneratedField(String)

Initierar en ny instans av AutoGeneratedField klassen med det angivna datafältet.

Egenskaper

Name Description
AccessibleHeaderText

Hämtar eller anger text som återges som egenskapsvärdet AbbreviatedText i vissa kontroller.

(Ärvd från DataControlField)
ApplyFormatInEditMode

Hämtar eller anger ett värde som anger om formateringssträngen DataFormatString som anges av egenskapen tillämpas på fältvärden när den databundna kontrollen som innehåller objektet är i redigeringsläge BoundField .

(Ärvd från BoundField)
Control

Hämtar en referens till den datakontroll som DataControlField objektet är associerat med.

(Ärvd från DataControlField)
ControlStyle

Hämtar formatet för alla webbserverkontroller som ingår i DataControlField objektet.

(Ärvd från DataControlField)
ConvertEmptyStringToNull

Hämtar eller anger ett värde som anger om tomma strängvärden ("") konverteras till null när fältvärdena hämtas från datakällan.
DataField

Hämtar eller anger namnet på datafältet som ska bindas till BoundField objektet.

(Ärvd från BoundField)
DataFormatString

Hämtar eller anger strängen som anger i vilket format den alternativa texten för varje bild i ett AutoGeneratedField objekt återges.
DataType

Hämtar eller anger datatypen för de värden som visas i ett AutoGeneratedField objekt.
DesignMode

Hämtar ett värde som anger om ett datakontrollfält för närvarande visas i en designtidsmiljö.

(Ärvd från DataControlField)
FooterStyle

Hämtar eller anger formatet för sidfoten för datakontrollfältet.

(Ärvd från DataControlField)
FooterText

Hämtar eller anger texten som visas i sidfotsobjektet i ett datakontrollfält.

(Ärvd från DataControlField)
HeaderImageUrl

Hämtar eller anger URL:en för en bild som visas i rubrikobjektet i ett datakontrollfält.

(Ärvd från DataControlField)
HeaderStyle

Hämtar eller anger formatet för huvudet i datakontrollfältet.

(Ärvd från DataControlField)
HeaderText

Hämtar eller anger den text som visas i rubriken för en datakontroll.

(Ärvd från BoundField)
HtmlEncode

Hämtar eller anger ett värde som anger om fältvärden är HTML-kodade innan de visas i ett BoundField objekt.

(Ärvd från BoundField)
HtmlEncodeFormatString

Hämtar eller anger ett värde som anger om text som skapas genom att tillämpa DataFormatString egenskapen på BoundField värdet ska vara HTML-kodad när den visas.

(Ärvd från BoundField)
InsertVisible

Hämtar eller anger ett värde som anger om AutoGeneratedField objektet visas i infogningsläge.
IsTrackingViewState

Hämtar ett värde som anger om DataControlField objektet sparar ändringar i visningstillståndet.

(Ärvd från DataControlField)
ItemStyle

Hämtar formatmallen för textbaserat innehåll som visas av ett datakontrollfält.

(Ärvd från DataControlField)
NullDisplayText

Hämtar eller anger bildtexten som visas för ett fält när fältets värde är null.

(Ärvd från BoundField)
ReadOnly

Hämtar eller anger ett värde som anger om värdet för fältet kan ändras i redigeringsläge.

(Ärvd från BoundField)
ShowHeader

Hämtar eller anger ett värde som anger om rubrikobjektet i ett datakontrollfält återges.

(Ärvd från DataControlField)
SortExpression

Hämtar eller anger ett sorteringsuttryck som används av en datakällakontroll för att sortera data.

(Ärvd från DataControlField)
SupportsHtmlEncode

Hämtar ett värde som anger om HTML-kodning stöds av ett BoundField objekt.

(Ärvd från BoundField)
ValidateRequestMode

Hämtar eller anger ett värde som avgör om kontrollen validerar klientindata eller inte.

(Ärvd från BoundField)
ViewState

Hämtar en ordlista med tillståndsinformation som gör att du kan spara och återställa visningstillståndet för ett DataControlField objekt över flera begäranden för samma sida.

(Ärvd från DataControlField)
Visible

Hämtar eller anger ett värde som anger om ett datakontrollfält återges.

(Ärvd från DataControlField)

Metoder

Name Description
CloneField()

Skapar en duplicerad kopia av det aktuella DataControlField-härledda objektet.

(Ärvd från DataControlField)
CopyProperties(DataControlField)

Kopierar egenskaperna för det aktuella BoundField objektet till det angivna DataControlField objektet.

(Ärvd från BoundField)
CreateField()

Skapar ett tomt BoundField objekt.

(Ärvd från BoundField)
Equals(Object)

Avgör om det angivna objektet är lika med det aktuella objektet.

(Ärvd från Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)

Fyller det angivna IOrderedDictionary objektet med värdena från det angivna DataControlFieldCell objektet.
FormatDataValue(Object, Boolean)

Formaterar det angivna fältvärdet för en cell i BoundField objektet.

(Ärvd från BoundField)
GetDesignTimeValue()

Hämtar värdet som används för ett fälts värde när objektet återges BoundField i en designer.

(Ärvd från BoundField)
GetHashCode()

Fungerar som standard-hash-funktion.

(Ärvd från Object)
GetType()

Hämtar den aktuella instansen Type .

(Ärvd från Object)
GetValue(Control)

Hämtar värdet för det fält som är bundet BoundField till objektet.

(Ärvd från BoundField)
Initialize(Boolean, Control)

Initierar BoundField-objektet.

(Ärvd från BoundField)
InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)

Initierar det angivna TableCell objektet till det angivna radtillståndet.

(Ärvd från BoundField)
InitializeDataCell(DataControlFieldCell, DataControlRowState)

Initierar det angivna TableCell objektet till det angivna radtillståndet.

(Ärvd från BoundField)
LoadViewState(Object)

Återställer tidigare lagrad visningstillståndsinformation för det här fältet.

(Ärvd från BoundField)
MemberwiseClone()

Skapar en ytlig kopia av den aktuella Object.

(Ärvd från Object)
OnDataBindField(Object, EventArgs)

Binder värdet för ett fält till objektet BoundField .

(Ärvd från BoundField)
OnFieldChanged()

Genererar händelsen FieldChanged .

(Ärvd från DataControlField)
SaveViewState()

Sparar de ändringar som gjorts i visningstillståndet DataControlField sedan den tid då sidan publicerades tillbaka till servern.

(Ärvd från DataControlField)
ToString()

Returnerar en sträng som representerar det här DataControlField objektet.

(Ärvd från DataControlField)
TrackViewState()

DataControlField Gör att objektet spårar ändringar i visningstillståndet så att de kan lagras i kontrollens ViewState egenskap och sparas mellan begäranden för samma sida.

(Ärvd från DataControlField)
ValidateSupportsCallback()

Avgör om kontrollerna i ett AutoGeneratedField objekt stöder återanrop.

Explicita gränssnittsimplementeringar

Name Description
IDataSourceViewSchemaAccessor.DataSourceViewSchema

Hämtar eller anger schemat som är associerat med det här DataControlField objektet.

(Ärvd från DataControlField)
IStateManager.IsTrackingViewState

Hämtar ett värde som anger om DataControlField objektet sparar ändringar i visningstillståndet.

(Ärvd från DataControlField)
IStateManager.LoadViewState(Object)

Återställer datakontrollfältets tidigare sparade visningstillstånd.

(Ärvd från DataControlField)
IStateManager.SaveViewState()

Sparar de ändringar som gjorts i visningstillståndet DataControlField sedan den tid då sidan publicerades tillbaka till servern.

(Ärvd från DataControlField)
IStateManager.TrackViewState()

DataControlField Gör att objektet spårar ändringar i visningstillståndet så att de kan lagras i kontrollens ViewState egenskap och sparas mellan begäranden för samma sida.

(Ärvd från DataControlField)

Gäller för

Se även