AutoGeneratedField Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.UI.WebControls

Zestaw:: System.Web.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Reprezentuje automatycznie wygenerowane pole w kontrolce powiązanej z danymi. Klasa ta nie może być dziedziczona.

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

Dziedziczenie: Object

DataControlField

BoundField
AutoGeneratedField

Przykłady

W poniższym przykładzie pokazano, jak utworzyć AutoGeneratedField obiekt dla kontrolki niestandardowej pochodzącej z kontrolki DetailsView .


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

Uwagi

Klasa AutoGeneratedField jest używana do reprezentowania automatycznie wygenerowanego pola w kontrolce powiązanej z danymi, takiej jak GridView lub DetailsView. Pola generowane automatycznie są tworzone przez kontrolkę powiązaną z danymi, gdy właściwość jest ustawiona na true (na przykład AutoGenerateColumns właściwość GridView kontrolki, AutoGenerateRows właściwość kontrolki DetailsView itd.).

Uwaga

Pola generowane automatycznie nie są dodawane do kolekcji pól kontrolki powiązanej z danymi (na przykład Columns kolekcji kontrolki GridView , Fields kolekcji kontrolki DetailsView itd.).

Klasa jest przeznaczona AutoGeneratedField do użytku wewnętrznie przez kontrolki powiązane z danymi. W przeciwieństwie do innych pól danych (takich jak BoundField, CheckBoxField, TemplateFieldi tak dalej) AutoGeneratedField nie można deklaratywnie umieścić klasy na stronie w ramach kolekcji pól. Mimo że można programowo dodać AutoGeneratedField obiekt do kolekcji pól, należy unikać tego wzorca projektowego.

Ponieważ pola generowane automatycznie reprezentują automatyczne renderowanie pola, kontrolki powiązane z danymi zwykle nie zezwalają użytkownikom na modyfikowanie właściwości AutoGeneratedField obiektów. Jeśli automatyczne renderowanie nie jest odpowiednie dla Twoich potrzeb, zdefiniuj własne pola danych dla kolekcji pól kontrolki.

Konstruktory

AutoGeneratedField(String)

Inicjuje AutoGeneratedField nowe wystąpienie klasy z określonym polem danych.

Właściwości

AccessibleHeaderText	Pobiera lub ustawia tekst renderowany jako `AbbreviatedText` wartość właściwości w niektórych kontrolkach. (Odziedziczone po DataControlField)
ApplyFormatInEditMode	Pobiera lub ustawia wartość wskazującą, czy ciąg formatowania określony przez DataFormatString właściwość jest stosowany do wartości pól, gdy kontrolka powiązana z danymi zawierająca BoundField obiekt jest w trybie edycji. (Odziedziczone po BoundField)
Control	Pobiera odwołanie do kontrolki danych skojarzonej DataControlField z obiektem. (Odziedziczone po DataControlField)
ControlStyle	Pobiera styl wszystkich kontrolek serwera sieci Web zawartych w DataControlField obiekcie. (Odziedziczone po DataControlField)
ConvertEmptyStringToNull	Pobiera lub ustawia wartość wskazującą, czy wartości ciągu pustego ("") są konwertowane na `null` podczas pobierania wartości pól ze źródła danych.
DataField	Pobiera lub ustawia nazwę pola danych, które ma być powiązane z obiektem BoundField . (Odziedziczone po BoundField)
DataFormatString	Pobiera lub ustawia ciąg określający format renderowania tekstu alternatywnego dla każdego obrazu w AutoGeneratedField obiekcie.
DataType	Pobiera lub ustawia typ danych wartości wyświetlanych w AutoGeneratedField obiekcie.
DesignMode	Pobiera wartość wskazującą, czy pole kontrolki danych jest obecnie wyświetlane w środowisku czasu projektowania. (Odziedziczone po DataControlField)
FooterStyle	Pobiera lub ustawia styl stopki pola kontrolki danych. (Odziedziczone po DataControlField)
FooterText	Pobiera lub ustawia tekst wyświetlany w elemencie stopki pola kontrolki danych. (Odziedziczone po DataControlField)
HeaderImageUrl	Pobiera lub ustawia adres URL obrazu wyświetlanego w elemencie nagłówka pola kontrolki danych. (Odziedziczone po DataControlField)
HeaderStyle	Pobiera lub ustawia styl nagłówka pola kontrolki danych. (Odziedziczone po DataControlField)
HeaderText	Pobiera lub ustawia tekst wyświetlany w nagłówku kontrolki danych. (Odziedziczone po BoundField)
HtmlEncode	Pobiera lub ustawia wartość wskazującą, czy wartości pól są zakodowane w formacie HTML przed ich wyświetleniem BoundField w obiekcie. (Odziedziczone po BoundField)
HtmlEncodeFormatString	Pobiera lub ustawia wartość wskazującą, czy tekst, który jest tworzony przez zastosowanie DataFormatString właściwości do BoundField wartości, powinien być zakodowany w formacie HTML podczas jego wyświetlania. (Odziedziczone po BoundField)
InsertVisible	Pobiera lub ustawia wartość wskazującą, czy AutoGeneratedField obiekt jest widoczny w trybie wstawiania.
IsTrackingViewState	Pobiera wartość wskazującą, czy DataControlField obiekt zapisuje zmiany w stanie widoku. (Odziedziczone po DataControlField)
ItemStyle	Pobiera styl dowolnej zawartości tekstowej wyświetlanej przez pole kontrolki danych. (Odziedziczone po DataControlField)
NullDisplayText	Pobiera lub ustawia podpis wyświetlany dla pola, gdy wartość pola ma wartość null. (Odziedziczone po BoundField)
ReadOnly	Pobiera lub ustawia wartość wskazującą, czy wartość pola można zmodyfikować w trybie edycji. (Odziedziczone po BoundField)
ShowHeader	Pobiera lub ustawia wartość wskazującą, czy element nagłówka pola kontrolki danych jest renderowany. (Odziedziczone po DataControlField)
SortExpression	Pobiera lub ustawia wyrażenie sortowania używane przez kontrolkę źródła danych do sortowania danych. (Odziedziczone po DataControlField)
SupportsHtmlEncode	Pobiera wartość wskazującą, czy kodowanie HTML jest obsługiwane przez BoundField obiekt. (Odziedziczone po BoundField)
ValidateRequestMode	Pobiera lub ustawia wartość, która określa, czy kontrolka weryfikuje dane wejściowe klienta, czy nie. (Odziedziczone po BoundField)
ViewState	Pobiera słownik informacji o stanie, który umożliwia zapisanie i przywrócenie stanu DataControlField widoku obiektu na wielu żądaniach dla tej samej strony. (Odziedziczone po DataControlField)
Visible	Pobiera lub ustawia wartość wskazującą, czy pole kontrolki danych jest renderowane. (Odziedziczone po DataControlField)

Metody

CloneField()	Tworzy zduplikowaną kopię bieżącego DataControlFieldobiektu pochodnego. (Odziedziczone po DataControlField)
CopyProperties(DataControlField)	Kopiuje właściwości bieżącego BoundField obiektu do określonego DataControlField obiektu. (Odziedziczone po BoundField)
CreateField()	Tworzy pusty BoundField obiekt. (Odziedziczone po BoundField)
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)	Wypełnia określony IOrderedDictionary obiekt wartościami z określonego DataControlFieldCell obiektu.
FormatDataValue(Object, Boolean)	Formatuje określoną wartość pola dla komórki w BoundField obiekcie. (Odziedziczone po BoundField)
GetDesignTimeValue()	Pobiera wartość używaną dla wartości pola podczas renderowania BoundField obiektu w projektancie. (Odziedziczone po BoundField)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
GetValue(Control)	Pobiera wartość pola powiązanego z obiektem BoundField . (Odziedziczone po BoundField)
Initialize(Boolean, Control)	Inicjuje BoundField obiekt. (Odziedziczone po BoundField)
InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)	Inicjuje określony TableCell obiekt do określonego stanu wiersza. (Odziedziczone po BoundField)
InitializeDataCell(DataControlFieldCell, DataControlRowState)	Inicjuje określony TableCell obiekt do określonego stanu wiersza. (Odziedziczone po BoundField)
LoadViewState(Object)	Przywraca wcześniej przechowywane informacje o stanie widoku dla tego pola. (Odziedziczone po BoundField)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
OnDataBindField(Object, EventArgs)	Wiąże wartość pola z obiektem BoundField . (Odziedziczone po BoundField)
OnFieldChanged()	`FieldChanged` Zgłasza zdarzenie. (Odziedziczone po DataControlField)
SaveViewState()	Zapisuje zmiany wprowadzone w DataControlField stanie widoku od czasu opublikowania strony z powrotem na serwerze. (Odziedziczone po DataControlField)
ToString()	Zwraca ciąg reprezentujący ten DataControlField obiekt. (Odziedziczone po DataControlField)
TrackViewState()	DataControlField Powoduje, że obiekt będzie śledzić zmiany w stanie widoku, dzięki czemu można je przechowywać we właściwości kontrolki ViewState i utrwalać w żądaniach dla tej samej strony. (Odziedziczone po DataControlField)
ValidateSupportsCallback()	Określa, czy kontrolki zawarte w AutoGeneratedField obiekcie obsługują wywołania zwrotne.

Jawne implementacje interfejsu

IDataSourceViewSchemaAccessor.DataSourceViewSchema	Pobiera lub ustawia schemat skojarzony z tym DataControlField obiektem. (Odziedziczone po DataControlField)
IStateManager.IsTrackingViewState	Pobiera wartość wskazującą, czy DataControlField obiekt zapisuje zmiany w stanie widoku. (Odziedziczone po DataControlField)
IStateManager.LoadViewState(Object)	Przywraca wcześniej zapisany stan widoku pola kontroli danych. (Odziedziczone po DataControlField)
IStateManager.SaveViewState()	Zapisuje zmiany wprowadzone w DataControlField stanie widoku od czasu opublikowania strony z powrotem na serwerze. (Odziedziczone po DataControlField)
IStateManager.TrackViewState()	DataControlField Powoduje, że obiekt będzie śledzić zmiany w stanie widoku, dzięki czemu można je przechowywać we właściwości kontrolki ViewState i utrwalać w żądaniach dla tej samej strony. (Odziedziczone po DataControlField)

Dotyczy