DynamicField Klasse

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 ASP.NET Dynamische Datenfeatures 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

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
Deklarative Syntax

Einführung

Die DynamicField Klasse wird von datengebundenen Steuerelementen wie den GridView Steuerelementen und DetailsView Steuerelementen verwendet, um einen Feldwert anzuzeigen, der ASP.NET dynamische Datenfeatures auf benutzerdefinierten Seiten verwendet.

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

Automatisches Rendern des richtigen Steuerelements für ein Feld mithilfe von Feldvorlagen basierend auf dem Datentyp. Die Feldvorlagen können für die gesamte Anwendung global geändert werden.
Bereitstellen einer 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 dann 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 NULL-Werte konvertieren, indem die ConvertEmptyStringToNull Eigenschaft auf true.

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

Name	Beschreibung
DynamicField()	Initialisiert eine neue Instanz der DynamicField-Klasse.

Eigenschaften

Name	Beschreibung
AccessibleHeaderText	Dient zum Abrufen oder Festlegen von Text, der `AbbreviatedText` in einigen Steuerelementen als Eigenschaftswert gerendert wird. (Geerbt von DataControlField)
ApplyFormatInEditMode	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die formatierte Zeichenfolge, die durch die DataFormatString Eigenschaft angegeben wird, auf Feldwert angewendet wird, wenn sich das Datenfeld im Bearbeitungsmodus befindet.
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 Webserversteuerelemente ab, die im DataControlField Objekt enthalten sind. (Geerbt von DataControlField)
ConvertEmptyStringToNull	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob leere Zeichenfolgenwerte ("") automatisch in NULL-Werte konvertiert werden, wenn das Datenfeld in der Datenquelle aktualisiert wird.
DataField	Dient zum Abrufen oder Festlegen des Namens des Datenfelds, an das das DynamicField Objekt gebunden werden soll.
DataFormatString	Dient zum Abrufen oder Festlegen der Zeichenfolge, die das Anzeigeformat für den Wert des Datenfelds angibt.
DesignMode	Ruft einen Wert ab, der angibt, ob ein Datensteuerelementfeld derzeit in einer Entwurfszeitumgebung angezeigt wird. (Geerbt von DataControlField)
FooterStyle	Dient zum Abrufen oder Festlegen der Formatvorlage der Fußzeile des Datensteuerelementfelds. (Geerbt von DataControlField)
FooterText	Dient zum Abrufen oder Festlegen des Texts, der im Fußzeilenelement eines Datensteuerelementfelds angezeigt wird. (Geerbt von DataControlField)
HeaderImageUrl	Dient zum Abrufen oder Festlegen der URL eines Bilds, das im Kopfzeilenelement eines Datensteuerelementfelds angezeigt wird. (Geerbt von DataControlField)
HeaderStyle	Dient zum Abrufen oder Festlegen des Stils der Kopfzeile des Datensteuerelementfelds. (Geerbt von DataControlField)
HeaderText	Dient zum Abrufen oder Festlegen des Texts, der in der Kopfzeile des datengebundenen Steuerelements angezeigt wird, das das DynamicField Objekt enthält.
HtmlEncode	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob Datenfeldwerte HTML-codiert sind, bevor sie in einem DynamicField Objekt angezeigt werden.
InsertVisible	Ruft einen Wert ab, der angibt, ob das DataControlField Objekt sichtbar ist, wenn sich das übergeordnete datengebundene Steuerelement im Einfügemodus befindet. (Geerbt von DataControlField)
IsTrackingViewState	Ruft einen Wert ab, der angibt, ob das DataControlField Objekt Änderungen am Ansichtszustand speichert. (Geerbt von DataControlField)
ItemStyle	Ruft das Format aller textbasierten Inhalte ab, die von einem Datensteuerelementfeld angezeigt werden. (Geerbt von DataControlField)
NullDisplayText	Dient zum Abrufen oder Festlegen der Beschriftung, die für ein Datenfeld angezeigt wird, wenn der Feldwert ist `null`.
ReadOnly	Ruft den schreibgeschützten Zustand des dynamischen Felds ab.
ShowHeader	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Kopfzeilenelement eines Datensteuerelementfelds gerendert wird. (Geerbt von DataControlField)
SortExpression	Dient zum Abrufen oder Festlegen des Sortierausdrucks, der verwendet wird, wenn das Datenfeld zum Sortieren der Datenquelle verwendet wird.
UIHint	Ruft die Feldvorlage ab, die zum Anzeigen des Datenfelds verwendet werden soll, oder legt sie fest.
ValidateRequestMode	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Steuerelement die Clienteingabe überprüft.
ValidationGroup	Ruft das ValidationGroup Objekt ab, dem dieses DynamicField Objekt zugeordnet ist.
ViewState	Ruft ein Wörterbuch mit Statusinformationen ab, mit dem Sie den Ansichtszustand eines DataControlField Objekts über mehrere Anforderungen für dieselbe Seite speichern und wiederherstellen können. (Geerbt von DataControlField)
Visible	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob ein Datensteuerelementfeld gerendert wird. (Geerbt von DataControlField)

Methoden

Name	Beschreibung
CloneField()	Erstellt eine duplizierte Kopie des aktuellen DataControlFieldabgeleiteten 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 Klassen bereit, die von der Außerkraftsetzung der DynamicField Erstellung eines DynamicControl Objekts abgeleitet werden.
CreateField()	Erstellt und gibt eine neue Instanz der DynamicField Klasse zurück.
Equals(Object)	Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)	Extrahiert den Wert des Datenfelds aus der aktuellen Tabellenzelle und fügt den Wert zum angegebenen Wörterbuch hinzu.
GetAttribute(String)	Ruft den angegebenen Attributwert ab.
GetHashCode()	Dient als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
Initialize(Boolean, Control)	Führt die grundlegende Instanzinitialisierung für ein Datensteuerelementfeld aus. (Geerbt von DataControlField)
InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)	Fügt der angegebenen Zelle Text oder Steuerelemente hinzu.
LoadViewState(Object)	Stellt den zuvor gespeicherten Ansichtszustand der Datenquellenansicht wieder her. (Geerbt von DataControlField)
MemberwiseClone()	Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object)
OnFieldChanged()	Löst das `FieldChanged`-Ereignis aus. (Geerbt von DataControlField)
SaveViewState()	Speichert die am Ansichtszustand DataControlField vorgenommenen Änderungen seit dem Zeitpunkt, an dem die Seite zurück auf den Server gepostet 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 am Ansichtszustand nachverfolgt, sodass sie in der Eigenschaft des Steuerelements ViewState gespeichert und über Anforderungen für dieselbe Seite hinweg beibehalten werden können. (Geerbt von DataControlField)
ValidateSupportsCallback()	Wenn sie in einer abgeleiteten Klasse überschrieben werden, signalisiert, dass die in einem Feld enthaltenen Steuerelemente Rückrufe unterstützen. (Geerbt von DataControlField)

Explizite Schnittstellenimplementierungen

Name	Beschreibung
IDataSourceViewSchemaAccessor.DataSourceViewSchema	Ruft das diesem DataControlField Objekt zugeordnete Schema ab oder legt es fest. (Geerbt von DataControlField)
IStateManager.IsTrackingViewState	Ruft einen Wert ab, der angibt, ob das DataControlField Objekt Änderungen am Ansichtszustand speichert. (Geerbt von DataControlField)
IStateManager.LoadViewState(Object)	Stellt den zuvor gespeicherten Ansichtszustand des Datensteuerelementfelds wieder her. (Geerbt von DataControlField)
IStateManager.SaveViewState()	Speichert die am Ansichtszustand DataControlField vorgenommenen Änderungen seit dem Zeitpunkt, an dem die Seite zurück auf den Server gepostet wurde. (Geerbt von DataControlField)
IStateManager.TrackViewState()	Bewirkt, dass das DataControlField Objekt Änderungen am Ansichtszustand nachverfolgt, sodass sie in der Eigenschaft des Steuerelements ViewState gespeichert und über Anforderungen für dieselbe Seite hinweg beibehalten werden können. (Geerbt von DataControlField)

Erweiterungsmethoden

Name	Beschreibung
ConvertEditedValue(IFieldFormattingOptions, String)	Gibt den von einem Benutzer bereitgestellten Wert für ein Steuerelement zurück, das überprüft wird.
FormatEditValue(IFieldFormattingOptions, Object)	Formatiert den angegebenen Feldwert mithilfe der angegebenen Formatierungsoptionen.
FormatValue(IFieldFormattingOptions, Object)	Formatiert den angegebenen Feldwert mithilfe der angegebenen Formatierungsoptionen.

Gilt für:

Weitere Informationen

Feedback

War diese Seite hilfreich?