AutoGeneratedField Klasse

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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: Object

DataControlField

BoundField
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 DetailsView GridView 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: