Deklarative Syntax des DynamicControl-Webserversteuerelements
Aktualisiert: November 2007
Das DynamicControl-Steuerelement ist Teil des ASP.NET Dynamic Data-Framework. Das Steuerelement zeigt den Inhalt für ein bestimmtes Feld in vorlagenbasierten datengebundenen Steuerelementen (z. B. FormView oder ListView) mithilfe von Dynamic Data-Features wie Feldvorlagen an.
<asp:DynamicControl
ApplyFormatInEditMode="True|False"
ConvertEmptyStringToNull="True|False"
CssClass="string"
DataField="string"
DataFormatString="string"
EnableViewState="True|False"
HtmlEncode="True|False"
ID="string"
Mode="Edit|Insert|ReadOnly"
NullDisplayText="string"
OnDataBinding="DataBinding event handler"
OnDisposed="Disposed event handler"
OnInit="Init event handler"
OnLoad="Load event handler"
OnPreRender="PreRender event handler"
OnUnload="Unload event handler"
runat="server"
UIHint="string"
ValidationGroup="string"
Visible="True|False"
>
</asp:DynamicControl>
Hinweise
Das DynamicControl-Steuerelement wird von vorlagenbasierten datengebundenen Steuerelementen (z. B. dem FormView-Steuerelement oder dem ListView-Steuerelement) verwendet, um ein Datenfeld anzuzeigen, das ASP.NET Dynamic Data-Features verwendet. Sie können auch ein DynamicControl-Steuerelement in einem TemplateField-Feld eines GridView-Steuerelements oder eines DetailsView-Steuerelements verwenden.
Das DynamicControl-Steuerelement stellt eine dem DynamicField-Feld entsprechende Funktionalität bereit. Da das DynamicControl-Steuerelement jedoch nur in Vorlagen verwendet wird, bietet es Ihnen größere Flexibilität beim Steuern der Anzeige von Daten, da Sie der Vorlage sogar weitere HTML-Elemente hinzufügen können.
Um das in einem DynamicControl-Steuerelement anzuzeigende Feld anzugeben, legen Sie die DataField-Eigenschaft auf den Namen des Felds fest. Sie können eine benutzerdefinierte Formatierungszeichenfolge auf den Wert des Felds anwenden, indem Sie die DataFormatString-Eigenschaft festlegen. Standardmäßig wird die Formatierungszeichenfolge auf Feldwerte nur 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 fest. Wenn der Wert eines Felds null ist, können Sie benutzerdefinierten Text anzeigen, indem Sie die NullDisplayText-Eigenschaft festlegen. Wenn Sie die ConvertEmptyStringToNull-Eigenschaft auf true festgelegen, werden die Werte von Feldern, die leere Zeichenfolgen ("") enthalten, vom DynamicControl-Steuerelement automatisch in NULL-Werte umgewandelt.
Das DynamicControl-Steuerelement unterstützt verschiedene Anzeigemodi. Um den Modus für die Anzeige des DynamicControl-Steuerelements anzugeben, legen Sie die Mode-Eigenschaft fest. Die verschiedenen Modi werden in der folgenden Tabelle beschrieben.
ReadOnly
Gibt den Anzeigemodus an, in dem verhindert wird, dass Benutzer die Werte eines Datensatzes oder Datenfelds ändern können. Dieser Modus kann in allen Vorlagen verwendet werden.Edit
Gibt den Bearbeitungsmodus an, in dem Benutzer die Werte eines vorhandenen Datensatzes aktualisieren können. Dieser Modus wird in der EditItemTemplate-Vorlage verwendet.Insert
Gibt den Einfügemodus an, in dem Benutzer Werte für einen neuen Datensatz eingeben können. Dieser Modus wird in der InsertItemTemplate-Vorlage verwendet.
Beispiel
Im folgenden Beispiel wird veranschaulicht, wie das DynamicControl-Steuerelement in einem ListView-Steuerelement zum Anzeigen und Bearbeiten von Werten aus einer Datenbanktabelle verwendet wird.
<%@ 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(ListView1)
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
<title>DynamicControl Sample</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<asp:DynamicDataManager ID="DynamicDataManager1" runat="server"
AutoLoadForeignKeys="true" />
<asp:ListView ID="ListView1" runat="server" DataSourceID="LinqDataSource1"
InsertItemPosition="LastItem">
<LayoutTemplate>
<table cellpadding="2" border="1" runat="server" id="tblCustomers">
<tr runat="server">
<th runat="server"> </th>
<th runat="server">Name</th>
<th runat="server">Number</th>
<th runat="server">Standard Cost</th>
<th runat="server">List Price</th>
<th runat="server">Sell Start Date</th>
</tr>
<tr runat="server" id="itemPlaceholder" />
</table>
<asp:DataPager runat="server" ID="CustomersPager" PageSize="20">
<Fields>
<asp:NumericPagerField ButtonCount="10" />
</Fields>
</asp:DataPager>
</LayoutTemplate>
<ItemTemplate>
<tr runat="server">
<td>
<asp:LinkButton ID="EditButton" runat="server" CommandName="Edit" Text="Edit" CausesValidation="false" />
<asp:LinkButton ID="DeleteButton" runat="server" CommandName="Delete" Text="Delete" CausesValidation="false"
OnClientClick='return confirm("Are you sure you want to delete this item?");' />
</td>
<td>
<asp:DynamicControl runat="server" DataField="Name" />
</td>
<td>
<asp:DynamicControl runat="server" DataField="ProductNumber" />
</td>
<td align="right">
<asp:DynamicControl runat="server" DataField="StandardCost" DataFormatString="{0:C}" />
</td>
<td align="right">
<asp:DynamicControl runat="server" DataField="ListPrice" DataFormatString="{0:C}" />
</td>
<td align="center">
<asp:DynamicControl runat="server" DataField="SellStartDate"
DataFormatString="{0:MM/dd/yyyy}" NullDisplayText=" " />
</td>
</tr>
</ItemTemplate>
<EditItemTemplate>
<tr>
<td>
<asp:LinkButton ID="UpdateButton" runat="server" CommandName="Update" Text="Update" ValidationGroup="Edit" />
<asp:LinkButton ID="CancelButton" runat="server" CommandName="Cancel" Text="Cancel" CausesValidation="false" />
</td>
<td>
<asp:DynamicControl runat="server" DataField="Name" Mode="Edit" ValidationGroup="Edit" />
</td>
<td>
<asp:DynamicControl runat="server" DataField="ProductNumber" Mode="Edit" ValidationGroup="Edit" />
</td>
<td>
<asp:DynamicControl runat="server" DataField="StandardCost" Mode="Edit" ValidationGroup="Edit" />
</td>
<td>
<asp:DynamicControl runat="server" DataField="ListPrice" Mode="Edit" ValidationGroup="Edit" />
</td>
<td>
<asp:DynamicControl runat="server" DataField="SellStartDate" Mode="Edit" ValidationGroup="Edit"
DataFormatString="{0:MM/dd/yyyy}" ApplyFormatInEditMode="true" />
</td>
</tr>
</EditItemTemplate>
<InsertItemTemplate>
<tr>
<td>
<asp:LinkButton ID="InsertButton" runat="server" CommandName="Insert" Text="Insert" ValidationGroup="Insert" />
<asp:LinkButton ID="CancelButton" runat="server" CommandName="Cancel" Text="Cancel" CausesValidation="false" />
</td>
<td>
<asp:DynamicControl runat="server" DataField="Name" Mode="Insert" ValidationGroup="Insert" />
</td>
<td>
<asp:DynamicControl runat="server" DataField="ProductNumber" Mode="Insert" ValidationGroup="Insert" />
</td>
<td>
<asp:DynamicControl runat="server" DataField="StandardCost" Mode="Insert" ValidationGroup="Insert" />
</td>
<td>
<asp:DynamicControl runat="server" DataField="ListPrice" Mode="Insert" ValidationGroup="Insert" />
</td>
<td>
<asp:DynamicControl runat="server" DataField="SellStartDate" Mode="Insert" ValidationGroup="Insert" />
</td>
</tr>
</InsertItemTemplate>
</asp:ListView>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the AdventureWorksLT sample database. -->
<asp:LinqDataSource ID="LinqDataSource1" runat="server"
TableName="Products"
ContextTypeName="AdventureWorksLTDataContext"
EnableUpdate="true"
EnableDelete="true"
EnableInsert="true" >
</asp:LinqDataSource>
</div>
</form>
</body>
</html>
<%@ 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(ListView1);
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
<title>DynamicControl Sample</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<asp:DynamicDataManager ID="DynamicDataManager1" runat="server"
AutoLoadForeignKeys="true" />
<asp:ListView ID="ListView1" runat="server" DataSourceID="LinqDataSource1"
InsertItemPosition="LastItem">
<LayoutTemplate>
<table cellpadding="2" border="1" runat="server" id="tblCustomers">
<tr runat="server">
<th runat="server"> </th>
<th runat="server">Name</th>
<th runat="server">Number</th>
<th runat="server">Standard Cost</th>
<th runat="server">List Price</th>
<th runat="server">Sell Start Date</th>
</tr>
<tr runat="server" id="itemPlaceholder" />
</table>
<asp:DataPager runat="server" ID="CustomersPager" PageSize="20">
<Fields>
<asp:NumericPagerField ButtonCount="10" />
</Fields>
</asp:DataPager>
</LayoutTemplate>
<ItemTemplate>
<tr runat="server">
<td>
<asp:LinkButton ID="EditButton" runat="server" CommandName="Edit" Text="Edit" CausesValidation="false" />
<asp:LinkButton ID="DeleteButton" runat="server" CommandName="Delete" Text="Delete" CausesValidation="false"
OnClientClick='return confirm("Are you sure you want to delete this item?");' />
</td>
<td>
<asp:DynamicControl runat="server" DataField="Name" />
</td>
<td>
<asp:DynamicControl runat="server" DataField="ProductNumber" />
</td>
<td align="right">
<asp:DynamicControl runat="server" DataField="StandardCost" DataFormatString="{0:C}" />
</td>
<td align="right">
<asp:DynamicControl runat="server" DataField="ListPrice" DataFormatString="{0:C}" />
</td>
<td align="center">
<asp:DynamicControl runat="server" DataField="SellStartDate"
DataFormatString="{0:MM/dd/yyyy}" NullDisplayText=" " />
</td>
</tr>
</ItemTemplate>
<EditItemTemplate>
<tr>
<td>
<asp:LinkButton ID="UpdateButton" runat="server" CommandName="Update" Text="Update" ValidationGroup="Edit" />
<asp:LinkButton ID="CancelButton" runat="server" CommandName="Cancel" Text="Cancel" CausesValidation="false" />
</td>
<td>
<asp:DynamicControl runat="server" DataField="Name" Mode="Edit" ValidationGroup="Edit" />
</td>
<td>
<asp:DynamicControl runat="server" DataField="ProductNumber" Mode="Edit" ValidationGroup="Edit" />
</td>
<td>
<asp:DynamicControl runat="server" DataField="StandardCost" Mode="Edit" ValidationGroup="Edit" />
</td>
<td>
<asp:DynamicControl runat="server" DataField="ListPrice" Mode="Edit" ValidationGroup="Edit" />
</td>
<td>
<asp:DynamicControl runat="server" DataField="SellStartDate" Mode="Edit" ValidationGroup="Edit"
DataFormatString="{0:MM/dd/yyyy}" ApplyFormatInEditMode="true" />
</td>
</tr>
</EditItemTemplate>
<InsertItemTemplate>
<tr>
<td>
<asp:LinkButton ID="InsertButton" runat="server" CommandName="Insert" Text="Insert" ValidationGroup="Insert" />
<asp:LinkButton ID="CancelButton" runat="server" CommandName="Cancel" Text="Cancel" CausesValidation="false" />
</td>
<td>
<asp:DynamicControl runat="server" DataField="Name" Mode="Insert" ValidationGroup="Insert" />
</td>
<td>
<asp:DynamicControl runat="server" DataField="ProductNumber" Mode="Insert" ValidationGroup="Insert" />
</td>
<td>
<asp:DynamicControl runat="server" DataField="StandardCost" Mode="Insert" ValidationGroup="Insert" />
</td>
<td>
<asp:DynamicControl runat="server" DataField="ListPrice" Mode="Insert" ValidationGroup="Insert" />
</td>
<td>
<asp:DynamicControl runat="server" DataField="SellStartDate" Mode="Insert" ValidationGroup="Insert" />
</td>
</tr>
</InsertItemTemplate>
</asp:ListView>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the AdventureWorksLT sample database. -->
<asp:LinqDataSource ID="LinqDataSource1" runat="server"
TableName="Products"
ContextTypeName="AdventureWorksLTDataContext"
EnableUpdate="true"
EnableDelete="true"
EnableInsert="true" >
</asp:LinqDataSource>
</div>
</form>
</body>
</html>