Freigeben über


AutoGeneratedField Klasse

Definition

Stellt ein automatisch generiertes Feld in einem datengebundenen Steuerelement dar. Diese Klasse kann nicht vererbt werden.

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
Vererbung
AutoGeneratedField

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie ein AutoGeneratedField -Objekt für ein benutzerdefiniertes Steuerelement erstellt wird, das DetailsView vom -Steuerelement abgeleitet wird.


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

Hinweise

Die AutoGeneratedField -Klasse wird verwendet, um ein automatisch generiertes Feld in einem datengebundenen Steuerelement wie oder DetailsViewGridView darzustellen. Automatisch generierte Felder werden von einem datengebundenen Steuerelement erstellt, wenn die entsprechende Eigenschaft auf true festgelegt ist (z. B. die AutoGenerateColumns -Eigenschaft für das GridView Steuerelement, die AutoGenerateRows -Eigenschaft für das DetailsView Steuerelement usw.).

Hinweis

Automatisch generierte Felder werden der Feldsammlung eines datengebundenen Steuerelements nicht hinzugefügt (z. B. die Columns Auflistung für das GridView Steuerelement, die Fields Auflistung für das DetailsView Steuerelement usw.).

Die AutoGeneratedField -Klasse ist für die interne Verwendung durch datengebundene Steuerelemente vorgesehen. Im Gegensatz zu anderen Datenfeldern (z BoundField. B. , CheckBoxField, TemplateFieldusw.) kann die AutoGeneratedField -Klasse nicht deklarativ auf einer Seite als Teil einer Feldauflistung platziert werden. Obwohl Sie einer Feldauflistung programmgesteuert ein AutoGeneratedField Objekt hinzufügen können, sollte dieses Entwurfsmuster vermieden werden.

Da automatisch generierte Felder das automatische Rendering eines Felds darstellen, ermöglichen datengebundene Steuerelemente benutzern in der Regel nicht, die Eigenschaften der AutoGeneratedField Objekte zu ändern. Wenn das automatische Rendering nicht für Ihre Anforderungen geeignet ist, definieren Sie Ihre eigenen Datenfelder für die Feldsammlung des Steuerelements.

Konstruktoren

AutoGeneratedField(String)

Initialisiert eine neue Instanz der AutoGeneratedField-Klasse mit dem angegebenen Datenfeld.

Eigenschaften

AccessibleHeaderText

Ruft Text ab, der in einigen Steuerelementen als AbbreviatedText-Eigenschaftswert gerendert wird, oder legt diesen fest.

(Geerbt von DataControlField)
ApplyFormatInEditMode

Ruft einen Wert ab, der anzeigt, ob die von der DataFormatString-Eigenschaft angegebene Formatierungszeichenfolge auf Feldwerte angewendet wird, wenn sich das datengebundene Steuerelement, das das BoundField-Objekt enthält, im Bearbeitungsmodus befindet, oder legt diesen fest.

(Geerbt von BoundField)
Control

Ruft einen Verweis auf das Datensteuerelement ab, dem das DataControlField-Objekt zugeordnet ist.

(Geerbt von DataControlField)
ControlStyle

Ruft den Stil aller im DataControlField-Objekt enthaltenen Webserver-Steuerelemente ab.

(Geerbt von DataControlField)
ConvertEmptyStringToNull

Ruft einen Wert ab, oder legt einen Wert fest, der angibt, ob Werte mit einer leeren Zeichenfolge ("") in null konvertiert werden, wenn die Feldwerte aus der Datenquelle abgerufen werden.

DataField

Ruft den Namen des Datenfelds ab, das an das BoundField-Objekt gebunden werden soll, oder legt diesen fest.

(Geerbt von BoundField)
DataFormatString

Ruft die Zeichenfolge ab, oder legt die Zeichenfolge fest, die das Format angibt, mit dem der alternative Text für jedes Bild in einem AutoGeneratedField-Objekt gerendert wird.

DataType

Ruft den Datentyp der Werte ab, die in einem AutoGeneratedField-Objekt angezeigt werden, oder legt ihn fest.

DesignMode

Ruft einen Wert ab, der angibt, ob ein Datensteuerelement-Feld derzeit in einer Entwurfszeitumgebung angezeigt wird.

(Geerbt von DataControlField)
FooterStyle

Ruft den Stil der Fußzeile des Datensteuerelement-Felds ab oder legt diesen fest.

(Geerbt von DataControlField)
FooterText

Ruft den Text ab, der im Fußzeilenelement eines Datensteuerelement-Felds angezeigt werden soll, oder legt diesen fest.

(Geerbt von DataControlField)
HeaderImageUrl

Ruft die URL zu einem Bild ab, das im Headerelement eines Datensteuerelement-Felds angezeigt werden soll, oder legt diese fest.

(Geerbt von DataControlField)
HeaderStyle

Ruft den Stil des Headers des Datensteuerelement-Felds ab oder legt diesen fest.

(Geerbt von DataControlField)
HeaderText

Ruft den Text ab, der im Header eines Datensteuerelements angezeigt wird, oder legt diesen fest.

(Geerbt von BoundField)
HtmlEncode

Ruft einen Wert ab, der angibt, ob die Feldwerte vor dem Anzeigen in einem BoundField-Objekt HTML-codiert werden.

(Geerbt von BoundField)
HtmlEncodeFormatString

Ruft einen Wert ab, der angibt, ob durch Übernehmen der DataFormatString-Eigenschaft für den BoundField-Wert erstellter Text beim Anzeigen HTML-codiert werden soll, oder legt ihn fest.

(Geerbt von BoundField)
InsertVisible

Ruft einen Wert ab, der angibt, ob das AutoGeneratedField-Objekt im Einfügemodus sichtbar ist, oder legt diesen Wert fest.

IsTrackingViewState

Ruft einen Wert ab, der angibt, ob das DataControlField-Objekt Änderungen des Ansichtszustands speichert.

(Geerbt von DataControlField)
ItemStyle

Ruft das Format von allen textbasierten Inhalten ab, die von einem Datensteuerelement-Feld angezeigt werden.

(Geerbt von DataControlField)
NullDisplayText

Ruft die Beschriftung ab, die für ein Feld angezeigt wird, wenn der Wert des Felds NULL ist, oder legt diesen fest.

(Geerbt von BoundField)
ReadOnly

Ruft einen Wert ab, der angibt, ob der Feldwert im Bearbeitungsmodus geändert werden kann, oder legt diesen fest.

(Geerbt von BoundField)
ShowHeader

Ruft einen Wert ab, der angibt, ob das Headerelement eines Datensteuerelementfelds gerendert wird, oder legt diesen fest.

(Geerbt von DataControlField)
SortExpression

Ruft einen Sortierausdruck ab, mit dem ein Datenquellen-Steuerelement Daten sortiert, oder legt diesen fest.

(Geerbt von DataControlField)
SupportsHtmlEncode

Ruft einen Wert ab, der angibt, ob die HTML-Codierung von einem BoundField-Objekt unterstützt wird.

(Geerbt von BoundField)
ValidateRequestMode

Ruft einen Wert ab oder legt einen Wert fest, der bestimmt, ob das Steuerelement Clienteingaben überprüft.

(Geerbt von BoundField)
ViewState

Ruft ein Wörterbuch mit Zustandsinformationen ab, mit dem Sie den Ansichtszustand eines DataControlField-Objekts über mehrere Anforderungen für dieselbe Seite hinweg speichern und wiederherstellen können.

(Geerbt von DataControlField)
Visible

Ruft einen Wert ab, der angibt, ob ein Datensteuerelement-Feld dargestellt werden soll, oder legt diesen fest.

(Geerbt von DataControlField)

Methoden

CloneField()

Erstellt eine doppelte Kopie des aktuellen, von DataControlField abgeleiteten Objekts.

(Geerbt von DataControlField)
CopyProperties(DataControlField)

Kopiert die Eigenschaften des aktuellen BoundField-Objekts in das angegebene DataControlField-Objekt.

(Geerbt von BoundField)
CreateField()

Erstellt ein leeres BoundField-Objekt.

(Geerbt von BoundField)
Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)

Füllt das angegebene IOrderedDictionary-Objekt mit den Werten aus dem angegebenen DataControlFieldCell-Objekt.

FormatDataValue(Object, Boolean)

Formatiert den angegebenen Feldwert für eine Zelle im BoundField-Objekt.

(Geerbt von BoundField)
GetDesignTimeValue()

Ruft beim Rendern des BoundField-Objekts in einem Designer den für den Wert des Felds verwendeten Wert ab.

(Geerbt von BoundField)
GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
GetValue(Control)

Ruft den Wert des Felds ab, das an das BoundField-Objekt gebunden ist.

(Geerbt von BoundField)
Initialize(Boolean, Control)

Initialisiert das BoundField-Objekt.

(Geerbt von BoundField)
InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)

Initialisiert das angegebene TableCell-Objekt mit dem angegebenen Zeilenzustand.

(Geerbt von BoundField)
InitializeDataCell(DataControlFieldCell, DataControlRowState)

Initialisiert das angegebene TableCell-Objekt mit dem angegebenen Zeilenzustand.

(Geerbt von BoundField)
LoadViewState(Object)

Stellt die zuvor gespeicherten Ansichtszustandsinformationen für das Feld wieder her.

(Geerbt von BoundField)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
OnDataBindField(Object, EventArgs)

Bindet den Wert eines Felds an das BoundField-Objekt.

(Geerbt von BoundField)
OnFieldChanged()

Löst das FieldChanged-Ereignis aus.

(Geerbt von DataControlField)
SaveViewState()

Speichert die Änderungen am DataControlField-Ansichtszustand ab dem Zeitpunkt, an dem die Seite an den Server zurückgesendet wurde.

(Geerbt von DataControlField)
ToString()

Gibt eine Zeichenfolge zurück, die dieses DataControlField-Objekt darstellt.

(Geerbt von DataControlField)
TrackViewState()

Bewirkt, dass das DataControlField-Objekt Änderungen an seinem Ansichtszustand nachverfolgt, damit diese in der ViewState-Eigenschaft des Steuerelements gespeichert und über mehrere Anforderungen für dieselbe Seite hinweg beibehalten werden.

(Geerbt von DataControlField)
ValidateSupportsCallback()

Bestimmt, ob die in einem AutoGeneratedField-Objekt enthaltenen Steuerelemente Rückrufe unterstützen.

Explizite Schnittstellenimplementierungen

IDataSourceViewSchemaAccessor.DataSourceViewSchema

Ruft das Schema ab, das diesem DataControlField-Objekt zugeordnet ist, oder legt es fest.

(Geerbt von DataControlField)
IStateManager.IsTrackingViewState

Ruft einen Wert ab, der angibt, ob das DataControlField-Objekt Änderungen des Ansichtszustands speichert.

(Geerbt von DataControlField)
IStateManager.LoadViewState(Object)

Stellt den zuvor gespeicherten Ansichtszustand des Datensteuerelement-Felds wieder her.

(Geerbt von DataControlField)
IStateManager.SaveViewState()

Speichert die Änderungen am DataControlField-Ansichtszustand ab dem Zeitpunkt, an dem die Seite an den Server zurückgesendet wurde.

(Geerbt von DataControlField)
IStateManager.TrackViewState()

Bewirkt, dass das DataControlField-Objekt Änderungen an seinem Ansichtszustand nachverfolgt, damit diese in der ViewState-Eigenschaft des Steuerelements gespeichert und über mehrere Anforderungen für dieselbe Seite hinweg beibehalten werden.

(Geerbt von DataControlField)

Gilt für:

Weitere Informationen