DataControlField DataControlField DataControlField DataControlField Class

Definition

Dient als Basisklasse für alle Feldtypen von Datensteuerelementen, die eine Datenspalte in tabellarischen datengebundenen Steuerelementen darstellen, z. B. DetailsView und GridView.Serves as the base class for all data control field types, which represent a column of data in tabular data-bound controls such as DetailsView and GridView.

public ref class DataControlField abstract : System::Web::UI::IDataSourceViewSchemaAccessor, System::Web::UI::IStateManager
[System.ComponentModel.TypeConverter(typeof(System.ComponentModel.ExpandableObjectConverter))]
public abstract class DataControlField : System.Web.UI.IDataSourceViewSchemaAccessor, System.Web.UI.IStateManager
type DataControlField = class
    interface IStateManager
    interface IDataSourceViewSchemaAccessor
Public MustInherit Class DataControlField
Implements IDataSourceViewSchemaAccessor, IStateManager
Vererbung
DataControlFieldDataControlFieldDataControlFieldDataControlField
Abgeleitet
Attribute
Implementiert

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie BoundField - ButtonField Objekte und-Objekte, die DataControlFieldvon abgeleitet werden, zum Anzeigen DetailsView von Zeilen in einem-Steuerelement verwendet werden.The following code example demonstrates how to use BoundField and ButtonField objects, which are derived from DataControlField, to display rows in a DetailsView control. Für DetailsView das-Steuer AutoGenerateRows Element ist die false-Eigenschaft auf festgelegt, sodass eine Teilmenge der Daten angezeigt werden kann SelectCommand , die von der-Eigenschaft zurückgegeben werden.The DetailsView control has the AutoGenerateRows property set to false, which enables it to display a subset of the data returned by the SelectCommand property.

<%@ page language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
  <form id="form1" runat="server">

    <asp:sqldatasource
      id="SqlDataSource1"
      runat="server"
      connectionstring="<%$ ConnectionStrings:MyNorthwind%>"
      selectcommand="Select * From Employees">
    </asp:sqldatasource>

    <asp:detailsview
      id="DetailsView1"
      runat="server"
      allowpaging="True"
      datasourceid="SqlDataSource1"
      height="208px"
      width="264px"
      autogeneraterows="False">
        <fields>

          <asp:boundfield
            sortexpression="LastName"
            datafield="LastName"
            headertext="LastName">
              <itemstyle backcolor="Yellow">
              </itemstyle>
          </asp:boundfield>

          <asp:boundfield
            sortexpression="FirstName"
            datafield="FirstName"
            headertext="FirstName">
              <itemstyle forecolor="#C00000">
              </itemstyle>
          </asp:boundfield>

          <asp:buttonfield
            text="TestButton"
            buttontype="Button">
          </asp:buttonfield>

        </fields>
    </asp:detailsview>

  </form>
</body>
</html>
<%@ page language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
  <form id="form1" runat="server">

    <asp:sqldatasource
      id="SqlDataSource1"
      runat="server"
      connectionstring="<%$ ConnectionStrings:MyNorthwind%>"
      selectcommand="Select * From Employees">
    </asp:sqldatasource>

    <asp:detailsview
      id="DetailsView1"
      runat="server"
      allowpaging="True"
      datasourceid="SqlDataSource1"
      height="208px"
      width="264px"
      autogeneraterows="False">
        <fields>

          <asp:boundfield
            sortexpression="LastName"
            datafield="LastName"
            headertext="LastName">
              <itemstyle backcolor="Yellow">
              </itemstyle>
          </asp:boundfield>

          <asp:boundfield
            sortexpression="FirstName"
            datafield="FirstName"
            headertext="FirstName">
              <itemstyle forecolor="#C00000">
              </itemstyle>
          </asp:boundfield>

          <asp:buttonfield
            text="TestButton"
            buttontype="Button">
          </asp:buttonfield>

        </fields>
    </asp:detailsview>

  </form>
</body>
</html>

Im folgenden Codebeispiel wird veranschaulicht, wie die BoundField -Klasse erweitert wird, um ein benutzerdefiniertes Feld zu erstellen GridView , das in einem-Steuerelement verwendet werden kann.The following code example demonstrates how to extend the BoundField class to create a custom bound field that can be used in a GridView control. Ähnlich wie bei CheckBoxField der-Klasse RadioButtonField stellt die-Klasse eine true - false Spalte mit-oder-Daten dar.Similar to the CheckBoxField class, the RadioButtonField class represents a column of true or false data. Obwohl es sich bei den Daten, CheckBoxField an die die-Klasse gebunden ist, um true einen false beliebigen Satz von-oder-Werten handeln RadioButtonField kann, kann der Satz von Daten, true an den die Klasse gebunden ist, jeweils nur einen Wert aufweisen.However, although the data that the CheckBoxField class is bound to can be any set of true or false values, the set of data that the RadioButtonField class is bound to can have only one true value at any given time. In diesem Beispiel wird veranschaulicht, wie ExtractValuesFromCell die InitializeCell -Methode und die-Methode implementiert werden, zwei DataControlFieldwichtige Methoden aller von abgeleiteten Klassen.This example demonstrates how to implement the ExtractValuesFromCell and InitializeCell methods, two important methods of all classes derived from DataControlField.

namespace Samples.AspNet.CS {

  using System;
  using System.Collections;
  using System.Collections.Specialized;
  using System.ComponentModel;
  using System.Security.Permissions;
  using System.Web;
  using System.Web.UI;
  using System.Web.UI.WebControls;

  [AspNetHostingPermission(SecurityAction.Demand, 
      Level=AspNetHostingPermissionLevel.Minimal)]
  public sealed class RadioButtonField : CheckBoxField {

    public RadioButtonField() {
    }

    // Gets a default value for a basic design-time experience. 
    // Since it would look odd, even at design time, to have 
    // more than one radio button selected, make sure that none
    // are selected.
    protected override object GetDesignTimeValue() {
        return false;
    }
    // This method is called by the ExtractRowValues methods of 
    // GridView and DetailsView. Retrieve the current value of the 
    // cell from the Checked state of the Radio button.
    public override void ExtractValuesFromCell(IOrderedDictionary dictionary,
                                               DataControlFieldCell cell,
                                               DataControlRowState rowState,
                                               bool includeReadOnly)
    {

      // Determine whether the cell contains a RadioButton 
      // in its Controls collection.
      if (cell.Controls.Count > 0) {
        RadioButton radio = cell.Controls[0] as RadioButton;

        object checkedValue = null;
        if (null == radio) {
          // A RadioButton is expected, but a null is encountered.
          // Add error handling.
          throw new InvalidOperationException
              ("RadioButtonField could not extract control.");
        }
        else {
            checkedValue = radio.Checked;
        }


        // Add the value of the Checked attribute of the
        // RadioButton to the dictionary.
        if (dictionary.Contains(DataField))
          dictionary[DataField] = checkedValue;
        else
          dictionary.Add(DataField, checkedValue);
      }
    }
    // This method adds a RadioButton control and any other 
    // content to the cell's Controls collection.
    protected override void InitializeDataCell
        (DataControlFieldCell cell, DataControlRowState rowState) {

      RadioButton radio = new RadioButton();

      // If the RadioButton is bound to a DataField, add
      // the OnDataBindingField method event handler to the
      // DataBinding event.
      if (DataField.Length != 0) {
        radio.DataBinding += new EventHandler(this.OnDataBindField);
      }

      radio.Text = this.Text;

      // Because the RadioButtonField is a BoundField, it only
      // displays data. Therefore, unless the row is in edit mode,
      // the RadioButton is displayed as disabled.
      radio.Enabled = false;
      // If the row is in edit mode, enable the button.
      if ((rowState & DataControlRowState.Edit) != 0 ||
          (rowState & DataControlRowState.Insert) != 0) {
        radio.Enabled = true;
      }

      cell.Controls.Add(radio);
    }
  }
}
Imports System.Collections.Specialized
Imports System.Collections
Imports System.ComponentModel
Imports System.Security.Permissions
Imports System.Web
Imports System.Web.UI
Imports System.Web.UI.WebControls

Namespace Samples.AspNet.VB

    <AspNetHostingPermission(SecurityAction.Demand, _
        Level:=AspNetHostingPermissionLevel.Minimal)> _
    Public NotInheritable Class RadioButtonField
        Inherits CheckBoxField

        Public Sub New()
        End Sub 'New

        ' Gets a default value for a basic design-time experience. Since
        ' it would look odd, even at design time, to have more than one
        ' radio button selected, make sure that none are selected.
        Protected Overrides Function GetDesignTimeValue() As Object
            Return False
        End Function

        ' This method is called by the ExtractRowValues methods of
        ' GridView and DetailsView. Retrieve the current value of the 
        ' cell from the Checked state of the Radio button.
        Public Overrides Sub ExtractValuesFromCell( _
            ByVal dictionary As IOrderedDictionary, _
            ByVal cell As DataControlFieldCell, _
            ByVal rowState As DataControlRowState, _
            ByVal includeReadOnly As Boolean)
            ' Determine whether the cell contain a RadioButton 
            ' in its Controls collection.
            If cell.Controls.Count > 0 Then
                Dim radio As RadioButton = CType(cell.Controls(0), RadioButton)

                Dim checkedValue As Object = Nothing
                If radio Is Nothing Then
                    ' A RadioButton is expected, but a null is encountered.
                    ' Add error handling.
                    Throw New InvalidOperationException( _
                        "RadioButtonField could not extract control.")
                Else
                    checkedValue = radio.Checked
                End If


                ' Add the value of the Checked attribute of the
                ' RadioButton to the dictionary.
                If dictionary.Contains(DataField) Then
                    dictionary(DataField) = checkedValue
                Else
                    dictionary.Add(DataField, checkedValue)
                End If
            End If
        End Sub
        ' This method adds a RadioButton control and any other 
        ' content to the cell's Controls collection.
        Protected Overrides Sub InitializeDataCell( _
            ByVal cell As DataControlFieldCell, _
            ByVal rowState As DataControlRowState)

            Dim radio As New RadioButton()

            ' If the RadioButton is bound to a DataField, add
            ' the OnDataBindingField method event handler to the
            ' DataBinding event.
            If DataField.Length <> 0 Then
                AddHandler radio.DataBinding, AddressOf Me.OnDataBindField
            End If

            radio.Text = Me.Text

            ' Because the RadioButtonField is a BoundField, it only 
            ' displays data. Therefore, unless the row is in edit mode, 
            ' the RadioButton is displayed as disabled.
            radio.Enabled = False
            ' If the row is in edit mode, enable the button.
            If (rowState And DataControlRowState.Edit) <> 0 _
                OrElse (rowState And DataControlRowState.Insert) <> 0 Then
                radio.Enabled = True
            End If

            cell.Controls.Add(radio)
        End Sub

    End Class

End Namespace

Im folgenden Codebeispiel wird veranschaulicht, wie die RadioButtonField -Klasse, die im vorherigen Beispiel bereitgestellt wird, in GridView einem-Steuerelement verwendet wird.The following code example demonstrates how to use the RadioButtonField class, which is provided in the previous example, in a GridView control. In diesem Beispiel zeigt das GridView -Steuerelement Daten für ein Sport Team an.In this example, the GridView control displays data for a sports team. Die Player Daten werden in einer Datentabelle verwaltet, die eine ID-Spalte, Spalten für die Player Namen und eine true-oder false-Spalte enthält, die den Kapitän des Teams identifiziert.The player data is maintained in a data table that includes an ID column, columns for the player names, and a true or false column that identifies the captain of the team. Die RadioButtonField -Klasse wird verwendet, um anzuzeigen, welches Teammitglied der aktuelle Team-Kapitän ist.The RadioButtonField class is used to display which team member is the current team captain. Das GridView Steuerelement kann bearbeitet werden, um einen neuen Team-Kapitän auszuwählen oder andere Player Informationen zu ändern.The GridView control can be edited to choose a new team captain or to change other player information.

<%@ page language="C#" %>
<%@ Register Tagprefix="aspSample"
             Namespace="Samples.AspNet.CS"
             Assembly="Samples.AspNet.CS" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
        <asp:gridview
          id="GridView1"
          runat="server"
          allowpaging="True"
          datasourceid="SqlDataSource1"
          allowsorting="True"
          autogeneratecolumns="False"
          autogenerateeditbutton="True"
          datakeynames="AnID">
            <columns>

                <aspSample:radiobuttonfield
                  headertext="RadioButtonField"
                  text="TeamLeader"
                  datafield="TrueFalse">
                </aspSample:radiobuttonfield>

                <asp:boundfield
                  insertvisible="False"
                  sortexpression="AnID"
                  datafield="AnID"
                  readonly="True"
                  headertext="AnID">
                </asp:boundfield>

                <asp:boundfield
                  sortexpression="FirstName"
                  datafield="FirstName"
                  headertext="FirstName">
                </asp:boundfield>

                <asp:boundfield
                  sortexpression="LastName"
                  datafield="LastName"
                  headertext="LastName">
                </asp:boundfield>

              </columns>
        </asp:gridview>
        <asp:sqldatasource
          id="SqlDataSource1"
          runat="server"
          connectionstring="<%$ ConnectionStrings:MyNorthwind%>"
          selectcommand="SELECT AnID,FirstName,LastName,TeamLeader FROM Players"
          updatecommand="UPDATE Players SET TrueFalse='false';UPDATE Players SET TrueFalse='true' WHERE AnID=@anID">
        </asp:sqldatasource>

    </form>
</body>
</html>
<%@ page language="VB" %>
<%@ Register Tagprefix="aspSample"
             Namespace="Samples.AspNet.VB"
             Assembly="Samples.AspNet.VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">

        <asp:gridview
          id="GridView1"
          runat="server"
          allowpaging="True"
          datasourceid="SqlDataSource1"
          allowsorting="True"
          autogeneratecolumns="False"
          autogenerateeditbutton="True"
          datakeynames="AnID">
            <columns>
                <aspSample:radiobuttonfield
                  headertext="RadioButtonField"
                  text="TeamLeader"
                  datafield="TrueFalse">
                </aspSample:radiobuttonfield>

                <asp:boundfield
                  insertvisible="False"
                  sortexpression="AnID"
                  datafield="AnID"
                  readonly="True"
                  headertext="AnID">
                </asp:boundfield>

                <asp:boundfield
                  sortexpression="FirstName"
                  datafield="FirstName"
                  headertext="FirstName">
                </asp:boundfield>

                <asp:boundfield
                  sortexpression="LastName"
                  datafield="LastName"
                  headertext="LastName">
                </asp:boundfield>

              </columns>
        </asp:gridview>
        <asp:sqldatasource
          id="SqlDataSource1"
          runat="server"
          connectionstring="<%$ ConnectionStrings:MyNorthwind%>"
          selectcommand="SELECT AnID,FirstName,LastName,TeamLeader FROM Players"
          updatecommand="UPDATE Players SET TrueFalse='false';UPDATE Players SET TrueFalse='true' WHERE AnID=@anID">
        </asp:sqldatasource>

    </form>
</body>
</html>

Hinweise

Die DataControlField -Klasse fungiert als Basisklasse für alle Daten Steuerungs Feldtypen.The DataControlField class serves as the base class for all data control field types. Daten Steuerungs Felder werden von Daten gebundenen Steuerelementen zur Darstellung eines Daten Felds verwendet, ähnlich wie ein DataGridColumn -Objekt einen Typ von Spalte DataGrid im-Steuerelement darstellt.Data control fields are used by data-bound controls to represent a field of data, similar to how a DataGridColumn object represents a type of column in the DataGrid control.

Verwenden Sie die Klassen, die von DataControlField abgeleitet werden, um zu steuern, wie ein Daten Feld in einem Daten gebundenen Steuerelement DetailsView wie GridViewoder angezeigt wird.Use the classes that are derived from DataControlField to control how a field of data is displayed in a data-bound control such as DetailsView or GridView. In der folgenden Tabelle werden die verschiedenen von ASP.NET bereitgestellten Daten Steuerungs Feldtypen aufgelistet.The following table lists the different data control field types provided by ASP.NET.

Spalten FeldtypColumn field type BeschreibungDescription
BoundField Zeigt den Wert eines Felds in einer Datenquelle als Text an.Displays the value of a field in a data source as text.
ButtonField Zeigt eine Befehls Schaltfläche in einem Daten gebundenen Steuerelement an.Displays a command button in a data-bound control. Abhängig vom Steuerelement können Sie dadurch entweder eine Zeile oder eine Spalte mit einem benutzerdefinierten Schaltflächen-Steuerelement anzeigen, z. b. eine Schaltfläche zum Hinzufügen oder entfernen.Depending on the control, this allows you to display either a row or a column with a custom button control, such as an Add or a Remove button.
CheckBoxField Zeigt ein Kontrollkästchen in einem Daten gebundenen Steuerelement an.Displays a check box in a data-bound control. Dieser Daten Steuerelement-Feldtyp wird häufig verwendet, um Felder mit einem booleschen Wert anzuzeigen.This data control field type is commonly used to display fields with a Boolean value.
CommandField Zeigt integrierte Befehls Schaltflächen zum Ausführen von Bearbeitungs-, Einfüge-oder Lösch Vorgängen in einem Daten gebundenen Steuerelement an.Displays built-in command buttons to perform edit, insert, or delete operations in a data-bound control.
HyperLinkField Zeigt den Wert eines Felds in einer Datenquelle als Hyperlink an.Displays the value of a field in a data source as a hyperlink. Dieser Daten Steuerungs Feldtyp ermöglicht Ihnen, ein zweites Feld an die URL des Links zu binden.This data control field type allows you to bind a second field to the hyperlink's URL.
ImageField Zeigt ein Bild in einem Daten gebundenen Steuerelement an.Displays an image in a data-bound control.
TemplateField Zeigt einen benutzerdefinierten Inhalt in einem Daten gebundenen Steuerelement entsprechend einer angegebenen Vorlage an.Displays user-defined content in a data-bound control according to a specified template.

Sie können auch die DataControlField Klassen und erweitern, um eigene Daten Steuerelement- BoundField Feldtypen zu erstellen.You can also extend the DataControlField and BoundField classes to create your own data control field types.

Die DataControlField -Klasse stellt viele Eigenschaften bereit, die bestimmen, wie Elemente der Benutzeroberfläche im Daten gebundenen Steuerelement dargestellt werden.The DataControlField class provides many properties that determine how user interface (UI) elements are presented in the data-bound control. Nicht jedes Steuerelement verwendet beim Rendern einer Benutzeroberfläche jede verfügbare Daten Steuerungs Feld-Eigenschaft.Not every control uses every available data control field property when rendering a UI. Das DetailsView -Steuerelement, das die Daten Steuerungs Felder als Zeilen anzeigt, enthält z. b. ein Header Element für jedes Daten Steuerungs Feld, aber kein footerelement.For example, the DetailsView control, which displays the data control fields as rows, includes a header item for each data control field, but no footer item. Deshalb werden die FooterText - FooterStyle Eigenschaft und die-Eigenschaft DetailsView vom-Steuerelement ignoriert.Therefore, the FooterText and FooterStyle properties are ignored by the DetailsView control. Das GridView -Steuerelement verwendet jedoch die FooterText -Eigenschaft und die ShowFooter -Eigenschaft, wenn truedie- FooterStyle Eigenschaft auf festgelegt ist.The GridView control, however, uses the FooterText and FooterStyle properties if the ShowFooter property is set to true. Entsprechend beeinflussen die Eigenschaften der Daten Steuerungs Felder die Darstellung von UI-Elementen, abhängig davon, worum es sich bei dem Element handelt.Similarly, the data control field properties affect the presentation of UI elements depending on what the element is. Die ItemStyle -Eigenschaft wird immer auf das-Feld angewendet.The ItemStyle property is always applied to the field. Wenn der von DataControlField abgeleitete Typ ein-Steuerelement enthält, wie CheckBoxField in der ButtonField - ControlStyle Klasse oder der-Klasse, wird die-Eigenschaft auf das-Feld angewendet.If the type derived from DataControlField contains a control, as in the ButtonField or CheckBoxField classes, the ControlStyle property is applied to the field.

Konstruktoren

DataControlField() DataControlField() DataControlField() DataControlField()

Initialisiert eine neue Instanz der DataControlField-Klasse.Initializes a new instance of the DataControlField class.

Eigenschaften

AccessibleHeaderText AccessibleHeaderText AccessibleHeaderText AccessibleHeaderText

Ruft Text ab, der in einigen Steuerelementen als AbbreviatedText-Eigenschaftswert gerendert wird, oder legt diesen fest.Gets or sets text that is rendered as the AbbreviatedText property value in some controls.

Control Control Control Control

Ruft einen Verweis auf das Datensteuerelement ab, dem das DataControlField-Objekt zugeordnet ist.Gets a reference to the data control that the DataControlField object is associated with.

ControlStyle ControlStyle ControlStyle ControlStyle

Ruft den Stil aller im DataControlField-Objekt enthaltenen Webserver-Steuerelemente ab.Gets the style of any Web server controls contained by the DataControlField object.

DesignMode DesignMode DesignMode DesignMode

Ruft einen Wert ab, der angibt, ob ein Datensteuerelement-Feld derzeit in einer Entwurfszeitumgebung angezeigt wird.Gets a value indicating whether a data control field is currently viewed in a design-time environment.

FooterStyle FooterStyle FooterStyle FooterStyle

Ruft den Stil der Fußzeile des Datensteuerelement-Felds ab oder legt diesen fest.Gets or sets the style of the footer of the data control field.

FooterText FooterText FooterText FooterText

Ruft den Text ab, der im Fußzeilenelement eines Datensteuerelement-Felds angezeigt werden soll, oder legt diesen fest.Gets or sets the text that is displayed in the footer item of a data control field.

HeaderImageUrl HeaderImageUrl HeaderImageUrl HeaderImageUrl

Ruft die URL zu einem Bild ab, das im Headerelement eines Datensteuerelement-Felds angezeigt werden soll, oder legt diese fest.Gets or sets the URL of an image that is displayed in the header item of a data control field.

HeaderStyle HeaderStyle HeaderStyle HeaderStyle

Ruft den Stil des Headers des Datensteuerelement-Felds ab oder legt diesen fest.Gets or sets the style of the header of the data control field.

HeaderText HeaderText HeaderText HeaderText

Ruft den Text ab, der im Headerelement eines Datensteuerelement-Felds angezeigt werden soll, oder legt diesen fest.Gets or sets the text that is displayed in the header item of a data control field.

InsertVisible InsertVisible InsertVisible InsertVisible

Ruft einen Wert ab, der angibt, ob das DataControlField-Objekt angezeigt wird, wenn sich sein übergeordnetes datengebundenes Steuerelement im Einfügemodus befindet.Gets a value indicating whether the DataControlField object is visible when its parent data-bound control is in insert mode.

IsTrackingViewState IsTrackingViewState IsTrackingViewState IsTrackingViewState

Ruft einen Wert ab, der angibt, ob das DataControlField-Objekt Änderungen des Ansichtszustands speichert.Gets a value indicating whether the DataControlField object is saving changes to its view state.

ItemStyle ItemStyle ItemStyle ItemStyle

Ruft das Format von allen textbasierten Inhalten ab, die von einem Datensteuerelement-Feld angezeigt werden.Gets the style of any text-based content displayed by a data control field.

ShowHeader ShowHeader ShowHeader ShowHeader

Ruft einen Wert ab, der angibt, ob das Headerelement eines Datensteuerelementfelds gerendert wird, oder legt diesen fest.Gets or sets a value indicating whether the header item of a data control field is rendered.

SortExpression SortExpression SortExpression SortExpression

Ruft einen Sortierausdruck ab, mit dem ein Datenquellen-Steuerelement Daten sortiert, oder legt diesen fest.Gets or sets a sort expression that is used by a data source control to sort data.

ValidateRequestMode ValidateRequestMode ValidateRequestMode ValidateRequestMode

Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob das Steuerelement Clienteingaben überprüft.Gets or sets a value that specifies whether the control validates client input.

ViewState ViewState ViewState 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.Gets a dictionary of state information that allows you to save and restore the view state of a DataControlField object across multiple requests for the same page.

Visible Visible Visible Visible

Ruft einen Wert ab, der angibt, ob ein Datensteuerelement-Feld dargestellt werden soll, oder legt diesen fest.Gets or sets a value indicating whether a data control field is rendered.

Methoden

CloneField() CloneField() CloneField() CloneField()

Erstellt eine doppelte Kopie des aktuellen, von DataControlField abgeleiteten Objekts.Creates a duplicate copy of the current DataControlField-derived object.

CopyProperties(DataControlField) CopyProperties(DataControlField) CopyProperties(DataControlField) CopyProperties(DataControlField)

Kopiert die Eigenschaften des aktuellen, aus DataControlField abgeleiteten Objekts in das angegebene DataControlField-Objekt.Copies the properties of the current DataControlField-derived object to the specified DataControlField object.

CreateField() CreateField() CreateField() CreateField()

Beim Überschreiben in einer abgeleiteten Klasse wird ein leeres, von DataControlField abgeleitetes Objekt erstellt.When overridden in a derived class, creates an empty DataControlField-derived object.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean) ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean) ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean) ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)

Extrahiert den Wert des Datensteuerelement-Felds aus der aktuellen Tabellenzelle und fügt den Wert der angegebenen IDictionary-Auflistung hinzu.Extracts the value of the data control field from the current table cell and adds the value to the specified IDictionary collection.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
Initialize(Boolean, Control) Initialize(Boolean, Control) Initialize(Boolean, Control) Initialize(Boolean, Control)

Führt eine grundlegende Instanzinitialisierung für ein Datensteuerelement-Feld aus.Performs basic instance initialization for a data control field.

InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32) InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32) InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32) InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)

Fügt der Steuerelementauflistung einer Zelle Text oder Steuerelemente hinzu.Adds text or controls to a cell's controls collection.

LoadViewState(Object) LoadViewState(Object) LoadViewState(Object) LoadViewState(Object)

Stellt den früher gespeicherten Ansichtszustand der Datenquellenansicht wieder her.Restores the data source view's previously saved view state.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
OnFieldChanged() OnFieldChanged() OnFieldChanged() OnFieldChanged()

Löst das FieldChanged-Ereignis aus.Raises the FieldChanged event.

SaveViewState() SaveViewState() SaveViewState() SaveViewState()

Speichert die Änderungen am DataControlField-Ansichtszustand ab dem Zeitpunkt, an dem die Seite an den Server zurückgesendet wurde.Saves the changes made to the DataControlField view state since the time the page was posted back to the server.

ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolge zurück, die dieses DataControlField-Objekt darstellt.Returns a string that represents this DataControlField object.

TrackViewState() TrackViewState() TrackViewState() 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.Causes the DataControlField object to track changes to its view state so they can be stored in the control's ViewState property and persisted across requests for the same page.

ValidateSupportsCallback() ValidateSupportsCallback() ValidateSupportsCallback() ValidateSupportsCallback()

Signalisiert beim Überschreiben in einer abgeleiteten Klasse, dass die in einem Feld enthaltenen Steuerelemente Rückrufe unterstützen.When overridden in a derived class, signals that the controls contained by a field support callbacks.

Explizite Schnittstellenimplementierungen

IDataSourceViewSchemaAccessor.DataSourceViewSchema IDataSourceViewSchemaAccessor.DataSourceViewSchema IDataSourceViewSchemaAccessor.DataSourceViewSchema IDataSourceViewSchemaAccessor.DataSourceViewSchema

Ruft das Schema ab, das diesem DataControlField-Objekt zugeordnet ist, oder legt es fest.Gets or sets the schema associated with this DataControlField object.

IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState

Ruft einen Wert ab, der angibt, ob das DataControlField-Objekt Änderungen des Ansichtszustands speichert.Gets a value indicating whether the DataControlField object is saving changes to its view state.

IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object)

Stellt den zuvor gespeicherten Ansichtszustand des Datensteuerelement-Felds wieder her.Restores the data control field's previously saved view state.

IStateManager.SaveViewState() IStateManager.SaveViewState() IStateManager.SaveViewState() IStateManager.SaveViewState()

Speichert die Änderungen am DataControlField-Ansichtszustand ab dem Zeitpunkt, an dem die Seite an den Server zurückgesendet wurde.Saves the changes made to the DataControlField view state since the time the page was posted back to the server.

IStateManager.TrackViewState() IStateManager.TrackViewState() IStateManager.TrackViewState() 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.Causes the DataControlField object to track changes to its view state so they can be stored in the control's ViewState property and persisted across requests for the same page.

Gilt für:

Siehe auch