DynamicControl.DataField Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает имя поля данных, к которому привязан элемент DynamicControl управления.
public:
property System::String ^ DataField { System::String ^ get(); void set(System::String ^ value); };
public string DataField { get; set; }
member this.DataField : string with get, set
Public Property DataField As String
Значение свойства
Имя поля данных для привязки DynamicControl элемента управления. Значение по умолчанию — пустая строка (""), указывающая, что это свойство не задано.
Примеры
В следующем примере показано, как использовать DataField свойство для указания поля, отображаемого в элементе DynamicControl управления.
<%@ Page Language="C#" %>
<%@ Register Assembly="System.Web.Entity, Version=3.5.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" Namespace="System.Web.UI.WebControls" tagprefix="asp" %>
<!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(ProductsFormView);
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
<title>DynamicControl.DataField Sample</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<asp:DynamicDataManager ID="DynamicDataManager1" runat="server"
AutoLoadForeignKeys="true" />
<asp:FormView ID="ProductsFormView" runat="server" DataSourceID="ProductsDataSource"
DataKeyNames="ProductID" AllowPaging="True"
PagerSettings-PageButtonCount="15">
<ItemTemplate>
Name:
<asp:DynamicControl runat="server" DataField="Name" />
<br />
Product Number:
<asp:DynamicControl runat="server" DataField="ProductNumber" />
<br />
Product Category:
<asp:DynamicControl runat="server" DataField="ProductCategory" />
<br />
</ItemTemplate>
</asp:FormView>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the AdventureWorksLT sample database. -->
<asp:EntityDataSource ID="ProductsDataSource" runat="server"
ContextTypeName="AdventureWorksLT_DataModel.AdventureWorksLT_DataEntities"
EntitySetName="Product"
Where='it.Size="L"'>
</asp:EntityDataSource>
</div>
</form>
</body>
</html>
<%@ Page Language="VB" %>
<%@ Register Assembly="System.Web.Entity, Version=3.5.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" Namespace="System.Web.UI.WebControls" tagprefix="asp" %>
<!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(ProductsFormView)
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
<title>DynamicControl.DataField Sample</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<asp:DynamicDataManager ID="DynamicDataManager1" runat="server"
AutoLoadForeignKeys="true" />
<asp:FormView ID="ProductsFormView" runat="server" DataSourceID="ProductsDataSource"
DataKeyNames="ProductID" AllowPaging="True"
PagerSettings-PageButtonCount="15">
<ItemTemplate>
Name:
<asp:DynamicControl runat="server" DataField="Name" />
<br />
Product Number:
<asp:DynamicControl runat="server" DataField="ProductNumber" />
<br />
Product Category:
<asp:DynamicControl runat="server" DataField="ProductCategory" />
<br />
</ItemTemplate>
</asp:FormView>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the AdventureWorksLT sample database. -->
<asp:EntityDataSource ID="ProductsDataSource" runat="server"
ContextTypeName="AdventureWorksLT_DataModel.AdventureWorksLT_DataEntities"
EntitySetName="Product"
Where='it.Size="L"'>
</asp:EntityDataSource>
</div>
</form>
</body>
</html>
Комментарии
DataField Используйте свойство, чтобы указать поле данных для привязки к элементу DynamicControl управления. Поле данных может быть именем столбца или внешними ключевыми столбцами, именем связи.
По умолчанию указанное поле данных отображается DynamicControl элементом управления с помощью шаблона поля, связанного с типом данных поля. Вы можете изменить шаблон поля, отрисованный для поля данных, задав UIHint свойство. Вы также можете отформатировать отображаемый текст, задав DataFormatString свойство.
Примечание Если вы хотите изменить отображение и поведение поля данных глобально, необходимо применить атрибуты к модели данных, а не задать это в определенном экземпляре DynamicControl элемента управления. Дополнительные сведения см. в ASP.NET динамических данных.