DynamicField Klasse

Referenz

Definition

Namespace:: System.Web.DynamicData

Assembly:: System.Web.DynamicData.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 Datenfeld dar, das in einem datengebundenen Steuerelement angezeigt wird, das Funktionen von ASP.NET Dynamic Data verwendet.

public ref class DynamicField : System::Web::UI::WebControls::DataControlField, System::Web::DynamicData::IFieldFormattingOptions, System::Web::UI::IAttributeAccessor

public class DynamicField : System.Web.UI.WebControls.DataControlField, System.Web.DynamicData.IFieldFormattingOptions, System.Web.UI.IAttributeAccessor

type DynamicField = class
    inherit DataControlField
    interface IAttributeAccessor
    interface IFieldFormattingOptions

Public Class DynamicField
Inherits DataControlField
Implements IAttributeAccessor, IFieldFormattingOptions

Vererbung: Object

DataControlField
DynamicField

Implementiert: IFieldFormattingOptions IAttributeAccessor

Beispiele

Sehen Sie sich ein Laufzeitcodebeispiel für dieses Feature an: Ausführen.

Im folgenden Beispiel wird veranschaulicht, wie Das DynamicField Objekt in einem GridView Steuerelement zum Anzeigen und Bearbeiten von Werten aus einer Datenbanktabelle verwendet wird.

<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
  protected void Page_Init(object sender, EventArgs e)
  {
    DynamicDataManager1.RegisterControl(CustomersGridView);
  }
</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
  <title>DynamicField Sample</title>
  <link href="~/Site.css" rel="stylesheet" type="text/css" />
</head>
<body>
  <form id="form1" runat="server">
    <div>
    
      <h2><%= CustomersDataSource.TableName%> Table</h2>
      
      <asp:DynamicDataManager ID="DynamicDataManager1" runat="server"
        AutoLoadForeignKeys="true" />
        
      <asp:ValidationSummary ID="ValidationSummary1" runat="server" EnableClientScript="true" 
        HeaderText="List of validation errors"  />
      <asp:DynamicValidator runat="server" ID="DynamicValidator1"
        ControlToValidate="CustomersGridView" Display="None" />
        
      <asp:GridView ID="CustomersGridView" runat="server"
        AutoGenerateColumns="false"
        AutoGenerateEditButton="true"
        AutoGenerateDeleteButton="true"
        DataSourceID="CustomersDataSource"
        AllowPaging="true"
        AllowSorting="true"
        CssClass="gridview">
        <Columns>
          <asp:DynamicField DataField="CustomerID" />
          <asp:DynamicField DataField="FirstName" />
          <asp:DynamicField DataField="LastName" />
        </Columns>        
      </asp:GridView>

      <!-- This example uses Microsoft SQL Server and connects   -->
      <!-- to the AdventureWorksLT sample database.              -->
      <asp:LinqDataSource ID="CustomersDataSource" runat="server" 
        TableName="Customers"
        ContextTypeName="AdventureWorksLTDataContext"
        EnableUpdate="true"
        EnableDelete="true" >
      </asp:LinqDataSource>
      
    </div>
  </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">

<script runat="server">
  
  Protected Sub Page_Init(ByVal sender As Object, ByVal e As System.EventArgs)    
    DynamicDataManager1.RegisterControl(CustomersGridView)
  End Sub
  
</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
  <title>DynamicField Sample</title>
  <link href="~/Site.css" rel="stylesheet" type="text/css" />
</head>
<body>
  <form id="form1" runat="server">
    <div>
    
      <h2><%= CustomersDataSource.TableName%> Table</h2>
      
      <asp:DynamicDataManager ID="DynamicDataManager1" runat="server"
        AutoLoadForeignKeys="true" />
        
      <asp:ValidationSummary ID="ValidationSummary1" runat="server" EnableClientScript="true" 
        HeaderText="List of validation errors"  />
      <asp:DynamicValidator runat="server" ID="DynamicValidator1"
        ControlToValidate="CustomersGridView" Display="None" />
        
      <asp:GridView ID="CustomersGridView" runat="server"
        AutoGenerateColumns="false"
        AutoGenerateEditButton="true"
        AutoGenerateDeleteButton="true"
        DataSourceID="CustomersDataSource"
        AllowPaging="true"
        AllowSorting="true"
        CssClass="gridview">
        <Columns>
          <asp:DynamicField DataField="CustomerID" />
          <asp:DynamicField DataField="FirstName" />
          <asp:DynamicField DataField="LastName" />
        </Columns>        
      </asp:GridView>

      <!-- This example uses Microsoft SQL Server and connects   -->
      <!-- to the AdventureWorksLT sample database.              -->
      <asp:LinqDataSource ID="CustomersDataSource" runat="server" 
        TableName="Customers"
        ContextTypeName="AdventureWorksLTDataContext"
        EnableUpdate="true"
        EnableDelete="true" >
      </asp:LinqDataSource>
      
    </div>
  </form>
</body>
</html>

Hinweise

In diesem Thema:

Introduction (Einführung)
Deklarative Syntax

Einführung

Die DynamicField Klasse wird von datengebundenen Steuerelementen verwendet, z. B. die GridView SteuerelementeDetailsView, um einen Feldwert anzuzeigen, der ASP.NET dynamische Datenfeatures auf benutzerdefinierten Seiten verwendet.

Die DynamicField Klasse stellt Funktionen bereit, die der BoundField Klasse ähneln. Da ein DynamicField Objekt jedoch in Dynamischen Datenanwendungen verwendet wird, können Sie die folgenden Dynamic Data-Features nutzen:

Automatisches Rendern des richtigen Steuerelements für ein Feld mithilfe von Feldvorlagen basierend auf dem Datentyp. Die Feldvorlagen können global für die gesamte Anwendung geändert werden.
Bereitstellen der integrierten Datenüberprüfung basierend auf dem Datenbankschema. Sie können auch Überprüfungstypen hinzufügen, indem Sie das Datenmodell anpassen.
Anpassen des Datenrenderings für einzelne Felder mithilfe von Attributen im Datenmodell oder mithilfe der UIHint Eigenschaft.

Das DynamicField Objekt rendert jedes Feld mithilfe eines DynamicControl Steuerelements. Wenn Sie das Datenfeld angeben möchten, das in einem DynamicField Objekt angezeigt werden soll, legen Sie die DataField Eigenschaft auf den Feldnamen fest. Sie können eine benutzerdefinierte Formatierungszeichenfolge auf den Feldwert anwenden, indem Sie die DataFormatString Eigenschaft festlegen. Standardmäßig wird die Formatierungszeichenfolge nur auf Feldwerte angewendet, wenn sich das datengebundene Steuerelement im schreibgeschützten Modus befindet. Wenn Sie die Formatierungszeichenfolge auf Werte anwenden möchten, die angezeigt werden, während sich das datengebundene Steuerelement im Bearbeitungsmodus befindet, legen Sie die ApplyFormatInEditMode Eigenschaft auf true. Wenn ein Feldwert lautet null, können Sie eine benutzerdefinierte Beschriftung anzeigen, indem Sie die NullDisplayText Eigenschaft festlegen. Das DynamicField Objekt kann auch automatisch leere Zeichenfolgen ("") Feldwerte in Nullwerte konvertieren, indem die ConvertEmptyStringToNull Eigenschaft auf truefestgelegt wird.

Deklarative Syntax

<asp:DynamicField
    AccessibleHeaderText="string"
    ApplyFormatInEditMode="true|false"
    ControlStyle-BackColor="color name|#dddddd"
    ControlStyle-BorderColor="color name|#dddddd"
    ControlStyle-BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|
       Ridge|Inset|Outset"
    ControlStyle-BorderWidth="size"
    ControlStyle-CssClass="string"
    ControlStyle-Font-Bold="true|false"
    ControlStyle-Font-Italic="true|false"
    ControlStyle-Font-Names="string"
    ControlStyle-Font-Overline="true|false"
    ControlStyle-Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
       Large|X-Large|XX-Large"
    ControlStyle-Font-Strikeout="true|false"
    ControlStyle-Font-Underline="true|false"
    ControlStyle-ForeColor="color name|#dddddd"
    ControlStyle-Height="size"
    ControlStyle-Width="size"
    ConvertEmptyStringToNull="true|false"
    DataField="string"
    DataFormatString="string"
    FooterStyle-BackColor="color name|#dddddd"
    FooterStyle-BorderColor="color name|#dddddd"
    FooterStyle-BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|
       Ridge|Inset|Outset"
    FooterStyle-BorderWidth="size"
    FooterStyle-CssClass="string"
    FooterStyle-Font-Bold="true|false"
    FooterStyle-Font-Italic="true|false"
    FooterStyle-Font-Names="string"
    FooterStyle-Font-Overline="true|false"
    FooterStyle-Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
       Large|X-Large|XX-Large"
    FooterStyle-Font-Strikeout="true|false"
    FooterStyle-Font-Underline="true|false"
    FooterStyle-ForeColor="color name|#dddddd"
    FooterStyle-Height="size"
    FooterStyle-Width="size"
    FooterStyle-HorizontalAlign="Center|Justify|Left|NotSet|Right"
    FooterStyle-VerticalAlign="Bottom|Middle|NotSet|Top"
    FooterStyle-Wrap="true|false"
    HeaderImageUrl="uri"
    HeaderStyle-BackColor="color name|#dddddd"
    HeaderStyle-BorderColor="color name|#dddddd"
    HeaderStyle-BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|
       Ridge|Inset|Outset"
    HeaderStyle-BorderWidth="size"
    HeaderStyle-CssClass="string"
    HeaderStyle-Font-Bold="true|false"
    HeaderStyle-Font-Italic="true|false"
    HeaderStyle-Font-Names="string"
    HeaderStyle-Font-Overline="true|false"
    HeaderStyle-Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
       Large|X-Large|XX-Large"
    HeaderStyle-Font-Strikeout="true|false"
    HeaderStyle-Font-Underline="true|false"
    HeaderStyle-ForeColor="color name|#dddddd"
    HeaderStyle-Height="size"
    HeaderStyle-Width="size"
    HeaderStyle-HorizontalAlign="Center|Justify|Left|NotSet|Right"
    HeaderStyle-VerticalAlign="Bottom|Middle|NotSet|Top"
    HeaderStyle-Wrap="true|false"
    HeaderText="string"
    InsertVisible="true|false"
    ItemStyle-BackColor="color name|#dddddd"
    ItemStyle-BorderColor="color name|#dddddd"
    ItemStyle-BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|
       Ridge|Inset|Outset"
    ItemStyle-BorderWidth="size"
    ItemStyle-CssClass="string"
    ItemStyle-Font-Bold="true|false"
    ItemStyle-Font-Italic="true|false"
    ItemStyle-Font-Names="string"
    ItemStyle-Font-Overline="true|false"
    ItemStyle-Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
       Large|X-Large|XX-Large"
    ItemStyle-Font-Strikeout="true|false"
    ItemStyle-Font-Underline="true|false"
    ItemStyle-ForeColor="color name|#dddddd"
    ItemStyle-Height="size"
    ItemStyle-Width="size"
    ItemStyle-HorizontalAlign="Center|Justify|Left|NotSet|Right"
    ItemStyle-VerticalAlign="Bottom|Middle|NotSet|Top"
    ItemStyle-Wrap="true|false"
    NullDisplayText="string"
    ReadOnly="true|false"
    ShowHeader="true|false"
    SortExpression="string"
    UIHint="string"
    ValidationGroup="string"
    Visible="true|false"
    />
<asp:DynamicField />

Konstruktoren

DynamicField()

Initialisiert eine neue Instanz der DynamicField-Klasse.

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 angibt, ob die von der DataFormatString-Eigenschaft angegebene formatierte Zeichenfolge auf einen Feldwert angewendet wird, wenn sich das Datenfeld im Bearbeitungsmodus befindet, oder legt diesen Wert fest.
Column	Ruft das MetaColumn-Objekt ab, dem dieses DynamicField-Objekt zugeordnet ist.
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, der angibt, ob bei der Aktualisierung des Datenfelds in der Datenquelle Werte, die leere Zeichenfolgen ("") darstellen, in NULL-Werte konvertiert werden, oder legt diesen fest.
DataField	Ruft den Namen des Datenfelds ab, an das das DynamicField-Objekt gebunden werden soll, oder legt diesen fest.
DataFormatString	Ruft die Zeichenfolge ab, die das Anzeigeformat für den Wert des Datenfelds angibt, oder legt diese 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 im Header des datengebundenen Steuerelements, das das DynamicField-Objekt enthält, angezeigten Text ab, oder legt diesen fest.
HtmlEncode	Ruft einen Wert ab, der angibt, ob die Datenfeldwerte vor dem Anzeigen in einem DynamicField-Objekt HTML-codiert werden.
InsertVisible	Ruft einen Wert ab, der angibt, ob das DataControlField-Objekt angezeigt wird, wenn sich sein übergeordnetes datengebundenes Steuerelement im Einfügemodus befindet. (Geerbt von DataControlField)
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 Datenfeld angezeigt wird, wenn der Wert des Felds `null` ist, oder legt diese fest.
ReadOnly	Ruft den schreibgeschützten Zustand des dynamischen Felds ab.
ShowHeader	Ruft einen Wert ab, der angibt, ob das Headerelement eines Datensteuerelementfelds gerendert wird, oder legt diesen fest. (Geerbt von DataControlField)
SortExpression	Ruft den Sortierausdruck ab, der verwendet wird, wenn die Datenquelle nach dem Datenfeld sortiert wird, oder legt diesen fest.
UIHint	Ruft die Feldvorlage ab, die zum Anzeigen des Datenfelds verwendet werden soll, oder legt diese fest.
ValidateRequestMode	Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob das Steuerelement Clienteingaben überprüft.
ValidateRequestMode	Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob das Steuerelement Clienteingaben überprüft. (Geerbt von DataControlField)
ValidationGroup	Ruft das ValidationGroup-Objekt ab, dem dieses DynamicField-Objekt zugeordnet ist.
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)
ConfigureDynamicControl(DynamicControl)	Stellt einen Mechanismus zum Ändern eines DynamicControl-Objekts bereit, das von der InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)-Methode erstellt wurde.
CopyProperties(DataControlField)	Kopiert die Eigenschaften des aktuellen DynamicField-Objekts in das angegebene DataControlField-Objekt.
CreateDynamicControl()	Stellt einen Mechanismus für von DynamicField abgeleitete Klassen bereit, um zu überschreiben, wie DynamicControl-Objekte erstellt werden.
CreateField()	Erstellt und gibt eine neue Instanz der DynamicField-Klasse zurück.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)	Extrahiert den Wert des Datenfelds aus der aktuellen Tabellenzelle und fügt dem angegebenen Wörterbuch den Wert hinzu.
GetAttribute(String)	Ruft den angegebenen Attributwert ab.
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
Initialize(Boolean, Control)	Führt eine grundlegende Instanzinitialisierung für ein Datensteuerelement-Feld aus. (Geerbt von DataControlField)
InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)	Fügt der angegebenen Zelle Text oder Steuerelemente hinzu.
LoadViewState(Object)	Stellt den früher gespeicherten Ansichtszustand der Datenquellenansicht wieder her. (Geerbt von DataControlField)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
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)
SetAttribute(String, String)	Legt ein Attribut fest, das dem DynamicField-Objekt zugeordnet ist.
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()	Signalisiert beim Überschreiben in einer abgeleiteten Klasse, dass die in einem Feld enthaltenen Steuerelemente Rückrufe unterstützen. (Geerbt von DataControlField)

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)

Erweiterungsmethoden

ConvertEditedValue(IFieldFormattingOptions, String)	Gibt den Wert zurück, der durch einen Benutzer für ein Steuerelement bereitgestellt wird, das überprüft wird.
FormatEditValue(IFieldFormattingOptions, Object)	Formatiert den angegebenen Feldwert mit den angegebenen Formatierungsoptionen.
FormatValue(IFieldFormattingOptions, Object)	Formatiert den angegebenen Feldwert mit den angegebenen Formatierungsoptionen.

Gilt für