IBindableTemplate Interface
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Permet aux contrôles liés aux données ASP.NET, notamment DetailsView et FormView, d'établir automatiquement la liaison à un contrôle de source de données ASP.NET dans des sections de contenu modélisé.
public interface class IBindableTemplate : System::Web::UI::ITemplatepublic interface IBindableTemplate : System.Web.UI.ITemplatetype IBindableTemplate = interface
interface ITemplatePublic Interface IBindableTemplate
Implements ITemplate- Dérivé
- Implémente
Exemples
L’exemple de code suivant montre comment un FormView contrôle peut définir de manière déclarative du contenu modèle, établir une liaison aux données fournies par un SqlDataSource contrôle et afficher et modifier des enregistrements existants. L’analyseur ASP.NET analyse le contenu modèle et crée un IBindableTemplate objet au moment de l’exécution capable de lier des valeurs du contrôle aux zones de SqlDataSource liaison de données définies dans le modèle à la fois par une syntaxe de liaison de données unidirectionnelle ASP.NET syntaxe de liaison de données (<%# Eval("fieldname") %>) et une syntaxe de liaison de données bidirectionnelle (<%# Bind("fieldname") %>).
Important
Ce contrôle a une zone de texte qui accepte l’entrée utilisateur, qui est une menace de sécurité potentielle. Par défaut, les pages web ASP.NET vérifient que l’entrée d’utilisateur n’inclut pas de script ou d’éléments HTML. Pour plus d’informations, consultez Vue d’ensemble des attaques de script.
<%@ 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">
void EmployeeFormView_ItemUpdating(Object sender, FormViewUpdateEventArgs e)
{
// Validate the field values entered by the user. This
// example determines whether the user left any fields
// empty. Use the NewValues property to access the new
// values entered by the user.
ArrayList emptyFieldList = ValidateFields(e.NewValues);
if (emptyFieldList.Count > 0)
{
// The user left some fields empty. Display an error message.
// Use the Keys property to retrieve the key field value.
String keyValue = e.Keys["EmployeeID"].ToString();
MessageLabel.Text = "You must enter a value for each field of record " +
keyValue + ".<br/>The following fields are missing:<br/><br/>";
// Display the missing fields.
foreach (String value in emptyFieldList)
{
// Use the OldValues property to access the original value
// of a field.
MessageLabel.Text += value + " - Original Value = " +
e.OldValues[value].ToString() + "<br />";
}
// Cancel the update operation.
e.Cancel = true;
}
else
{
// The field values passed validation. Clear the
// error message label.
MessageLabel.Text = "";
}
}
ArrayList ValidateFields(IOrderedDictionary list)
{
// Create an ArrayList object to store the
// names of any empty fields.
ArrayList emptyFieldList = new ArrayList();
// Iterate though the field values entered by
// the user and check for an empty field. Empty
// fields contain a null value.
foreach (DictionaryEntry entry in list)
{
if (entry.Value == String.Empty)
{
// Add the field name to the ArrayList object.
emptyFieldList.Add(entry.Key.ToString());
}
}
return emptyFieldList;
}
void EmployeeFormView_ModeChanging(Object sender, FormViewModeEventArgs e)
{
if (e.CancelingEdit)
{
// The user canceled the update operation.
// Clear the error message label.
MessageLabel.Text = "";
}
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>FormView Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>FormView Example</h3>
<asp:formview id="EmployeeFormView"
datasourceid="EmployeeSource"
allowpaging="true"
datakeynames="EmployeeID"
headertext="Employee Record"
emptydatatext="No employees found."
onitemupdating="EmployeeFormView_ItemUpdating"
onmodechanging="EmployeeFormView_ModeChanging"
runat="server">
<headerstyle backcolor="CornFlowerBlue"
forecolor="White"
font-size="14"
horizontalalign="Center"
wrap="false"/>
<rowstyle backcolor="LightBlue"
wrap="false"/>
<pagerstyle backcolor="CornFlowerBlue"/>
<itemtemplate>
<table>
<tr>
<td rowspan="6">
<asp:image id="EmployeeImage"
imageurl='<%# Eval("PhotoPath") %>'
alternatetext='<%# Eval("LastName") %>'
runat="server"/>
</td>
<td colspan="2">
</td>
</tr>
<tr>
<td>
<b>Name:</b>
</td>
<td>
<%# Eval("FirstName") %> <%# Eval("LastName") %>
</td>
</tr>
<tr>
<td>
<b>Title:</b>
</td>
<td>
<%# Eval("Title") %>
</td>
</tr>
<tr>
<td>
<b>Hire Date:</b>
</td>
<td>
<%# Eval("HireDate","{0:d}") %>
</td>
</tr>
<tr style="height:150; vertical-align:top">
<td>
<b>Address:</b>
</td>
<td>
<%# Eval("Address") %><br/>
<%# Eval("City") %> <%# Eval("Region") %>
<%# Eval("PostalCode") %><br/>
<%# Eval("Country") %>
</td>
</tr>
<tr>
<td colspan="2">
<asp:linkbutton id="Edit"
text="Edit"
commandname="Edit"
runat="server"/>
</td>
</tr>
</table>
</itemtemplate>
<edititemtemplate>
<table>
<tr>
<td rowspan="6">
<asp:image id="EmployeeEditImage"
imageurl='<%# Eval("PhotoPath") %>'
alternatetext='<%# Eval("LastName") %>'
runat="server"/>
</td>
<td colspan="2">
</td>
</tr>
<tr>
<td>
<b>Name:</b>
</td>
<td>
<asp:textbox id="FirstNameUpdateTextBox"
text='<%# Bind("FirstName") %>'
runat="server"/>
<asp:textbox id="LastNameUpdateTextBox"
text='<%# Bind("LastName") %>'
runat="server"/>
</td>
</tr>
<tr>
<td>
<b>Title:</b>
</td>
<td>
<asp:textbox id="TitleUpdateTextBox"
text='<%# Bind("Title") %>'
runat="server"/>
</td>
</tr>
<tr>
<td>
<b>Hire Date:</b>
</td>
<td>
<asp:textbox id="HireDateUpdateTextBox"
text='<%# Bind("HireDate", "{0:d}") %>'
runat="server"/>
</td>
</tr>
<tr style="height:150; vertical-align:top">
<td>
<b>Address:</b>
</td>
<td>
<asp:textbox id="AddressUpdateTextBox"
text='<%# Bind("Address") %>'
runat="server"/>
<br/>
<asp:textbox id="CityUpdateTextBox"
text='<%# Bind("City") %>'
runat="server"/>
<asp:textbox id="RegionUpdateTextBox"
text='<%# Bind("Region") %>'
width="40"
runat="server"/>
<asp:textbox id="PostalCodeUpdateTextBox"
text='<%# Bind("PostalCode") %>'
width="60"
runat="server"/>
<br/>
<asp:textbox id="CountryUpdateTextBox"
text='<%# Bind("Country") %>'
runat="server"/>
</td>
</tr>
<tr>
<td colspan="2">
<asp:linkbutton id="UpdateButton"
text="Update"
commandname="Update"
runat="server"/>
<asp:linkbutton id="CancelButton"
text="Cancel"
commandname="Cancel"
runat="server"/>
</td>
</tr>
</table>
</edititemtemplate>
<pagersettings position="Bottom"
mode="Numeric"/>
</asp:formview>
<br/><br/>
<asp:label id="MessageLabel"
forecolor="Red"
runat="server"/>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the Northwind sample database. Use an ASP.NET -->
<!-- expression to retrieve the connection string value -->
<!-- from the Web.config file. -->
<asp:sqldatasource id="EmployeeSource"
selectcommand="Select [EmployeeID], [LastName], [FirstName], [Title], [Address], [City], [Region], [PostalCode], [Country], [HireDate], [PhotoPath] From [Employees]"
updatecommand="Update [Employees] Set [LastName]=@LastName, [FirstName]=@FirstName, [Title]=@Title, [Address]=@Address, [City]=@City, [Region]=@Region, [PostalCode]=@PostalCode, [Country]=@Country Where [EmployeeID]=@EmployeeID"
connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
runat="server"/>
</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">
Sub EmployeeFormView_ItemUpdating(ByVal sender As Object, ByVal e As FormViewUpdateEventArgs) Handles EmployeeFormView.ItemUpdating
' Validate the field values entered by the user. This
' example determines whether the user left any fields
' empty. Use the NewValues property to access the new
' values entered by the user.
Dim emptyFieldList As ArrayList = ValidateFields(e.NewValues)
If emptyFieldList.Count > 0 Then
' The user left some fields empty. Display an error message.
' Use the Keys property to retrieve the key field value.
Dim keyValue As String = e.Keys("EmployeeID").ToString()
MessageLabel.Text = "You must enter a value for each field of record " & _
keyValue & ".<br/>The following fields are missing:<br/><br/>"
' Display the missing fields.
Dim value As String
For Each value In emptyFieldList
' Use the OldValues property to access the original value
' of a field.
MessageLabel.Text &= value & " - Original Value = " & _
e.OldValues(value).ToString() & "<br />"
Next
' Cancel the update operation.
e.Cancel = True
Else
' The field values passed validation. Clear the
' error message label.
MessageLabel.Text = ""
End If
End Sub
Function ValidateFields(ByVal list As IOrderedDictionary) As ArrayList
' Create an ArrayList object to store the
' names of any empty fields.
Dim emptyFieldList As New ArrayList()
' Iterate though the field values entered by
' the user and check for an empty field. Empty
' fields contain a null value.
Dim entry As DictionaryEntry
For Each entry In list
If entry.Value Is String.Empty Then
' Add the field name to the ArrayList object.
emptyFieldList.Add(entry.Key.ToString())
End If
Next
Return emptyFieldList
End Function
Sub EmployeeFormView_ModeChanging(ByVal sender As Object, ByVal e As FormViewModeEventArgs) Handles EmployeeFormView.ModeChanging
If e.CancelingEdit Then
' The user canceled the update operation.
' Clear the error message label.
MessageLabel.Text = ""
End If
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>FormView Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>FormView Example</h3>
<asp:formview id="EmployeeFormView"
datasourceid="EmployeeSource"
allowpaging="true"
datakeynames="EmployeeID"
headertext="Employee Record"
emptydatatext="No employees found."
runat="server">
<headerstyle backcolor="CornFlowerBlue"
forecolor="White"
font-size="14"
horizontalalign="Center"
wrap="false"/>
<rowstyle backcolor="LightBlue"
wrap="false"/>
<pagerstyle backcolor="CornFlowerBlue"/>
<itemtemplate>
<table>
<tr>
<td rowspan="6">
<asp:image id="EmployeeImage"
imageurl='<%# Eval("PhotoPath") %>'
alternatetext='<%# Eval("LastName") %>'
runat="server"/>
</td>
<td colspan="2">
</td>
</tr>
<tr>
<td>
<b>Name:</b>
</td>
<td>
<%# Eval("FirstName") %> <%# Eval("LastName") %>
</td>
</tr>
<tr>
<td>
<b>Title:</b>
</td>
<td>
<%# Eval("Title") %>
</td>
</tr>
<tr>
<td>
<b>Hire Date:</b>
</td>
<td>
<%# Eval("HireDate","{0:d}") %>
</td>
</tr>
<tr style="height:150; vertical-align:top">
<td>
<b>Address:</b>
</td>
<td>
<%# Eval("Address") %><br/>
<%# Eval("City") %> <%# Eval("Region") %>
<%# Eval("PostalCode") %><br/>
<%# Eval("Country") %>
</td>
</tr>
<tr>
<td colspan="2">
<asp:linkbutton id="Edit"
text="Edit"
commandname="Edit"
runat="server"/>
</td>
</tr>
</table>
</itemtemplate>
<edititemtemplate>
<table>
<tr>
<td rowspan="6">
<asp:image id="EmployeeEditImage"
imageurl='<%# Eval("PhotoPath") %>'
alternatetext='<%# Eval("LastName") %>'
runat="server"/>
</td>
<td colspan="2">
</td>
</tr>
<tr>
<td>
<b>Name:</b>
</td>
<td>
<asp:textbox id="FirstNameUpdateTextBox"
text='<%# Bind("FirstName") %>'
runat="server"/>
<asp:textbox id="LastNameUpdateTextBox"
text='<%# Bind("LastName") %>'
runat="server"/>
</td>
</tr>
<tr>
<td>
<b>Title:</b>
</td>
<td>
<asp:textbox id="TitleUpdateTextBox"
text='<%# Bind("Title") %>'
runat="server"/>
</td>
</tr>
<tr>
<td>
<b>Hire Date:</b>
</td>
<td>
<asp:textbox id="HireDateUpdateTextBox"
text='<%# Bind("HireDate", "{0:d}") %>'
runat="server"/>
</td>
</tr>
<tr style="height:150; vertical-align:top">
<td>
<b>Address:</b>
</td>
<td>
<asp:textbox id="AddressUpdateTextBox"
text='<%# Bind("Address") %>'
runat="server"/>
<br/>
<asp:textbox id="CityUpdateTextBox"
text='<%# Bind("City") %>'
runat="server"/>
<asp:textbox id="RegionUpdateTextBox"
text='<%# Bind("Region") %>'
width="40"
runat="server"/>
<asp:textbox id="PostalCodeUpdateTextBox"
text='<%# Bind("PostalCode") %>'
width="60"
runat="server"/>
<br/>
<asp:textbox id="CountryUpdateTextBox"
text='<%# Bind("Country") %>'
runat="server"/>
</td>
</tr>
<tr>
<td colspan="2">
<asp:linkbutton id="UpdateButton"
text="Update"
commandname="Update"
runat="server"/>
<asp:linkbutton id="CancelButton"
text="Cancel"
commandname="Cancel"
runat="server"/>
</td>
</tr>
</table>
</edititemtemplate>
<pagersettings position="Bottom"
mode="Numeric"/>
</asp:formview>
<br/><br/>
<asp:label id="MessageLabel"
forecolor="Red"
runat="server"/>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the Northwind sample database. Use an ASP.NET -->
<!-- expression to retrieve the connection string value -->
<!-- from the Web.config file. -->
<asp:sqldatasource id="EmployeeSource"
selectcommand="Select [EmployeeID], [LastName], [FirstName], [Title], [Address], [City], [Region], [PostalCode], [Country], [HireDate], [PhotoPath] From [Employees]"
updatecommand="Update [Employees] Set [LastName]=@LastName, [FirstName]=@FirstName, [Title]=@Title, [Address]=@Address, [City]=@City, [Region]=@Region, [PostalCode]=@PostalCode, [Country]=@Country Where [EmployeeID]=@EmployeeID"
connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
runat="server"/>
</form>
</body>
</html>
Remarques
L’interface IBindableTemplate permet d’ASP.NET contrôles liés aux données, tels que DetailsView, GridViewet FormView, de lier aux données fournies par un contrôle de source de données ASP.NET, par ObjectDataSource exemple, SqlDataSourcelorsque le contrôle lié aux données inclut du contenu modèle.
Notes
Les développeurs de pages n’implémentent pas l’interface IBindableTemplate . Les développeurs qui créent des contrôles liés aux données personnalisés peuvent manipuler IBindableTemplate des objets dans des implémentations des PerformDataBinding méthodes et ExtractRowValues des implémentations, mais n’implémentent pas leurs propres IBindableTemplate objets.
Les contrôles liés aux données, tels que GridView généralement, sont conscients de leurs arborescences de contrôles enfants et peuvent donc lier des valeurs à eux, extraire des valeurs et transmettre ces valeurs entre le contrôle lié aux données et un contrôle de source de données chaque fois que la liaison de données se produit. Toutefois, lorsqu’un développeur de pages définit le contenu modiné pour un contrôle lié aux données, les contrôles enfants du modèle ne sont pas visibles par le contrôle parent lié aux données : le parent peut restituer le contenu enfant (car les contrôles s’affichent efficacement), mais il ne peut pas extraire les valeurs de ces contrôles enfants à passer à la mise à jour d’un contrôle de source de données associé, opération d’insertion ou de suppression. Dans les scénarios de liaison de données, le contenu modèle est opaque pour un contrôle parent lié aux données. La Bind syntaxe permet au contrôle lié aux données d’extraire les valeurs d’une liaison de données à l’intérieur d’une IBindableTemplate instance.
La liaison de données peut être unidirectionnelle ou bidirectionnelle. (Ces instructions de liaison sont définies par l’énumération BindingDirection .) La liaison de données unidirectionnelle est toute liaison de données effectuée dans une direction sortante, du contrôle de source de données au contrôle lié aux données ; par exemple, tout scénario de lecture de données implique une liaison de données unidirectionnelle. Pour la liaison de données unidirectionnelle, vous pouvez utiliser la syntaxe de liaison de données unidirectionnelle (<%# Eval("fieldname") %>) à l’intérieur du contenu modèle et n’avez pas besoin d’utiliser la syntaxe bidirectionnelle ASP.NET la liaison de données. La liaison de données bidirectionnelle décrit la liaison de données dans la direction entrante, du contrôle lié aux données au contrôle de source de données. Les scénarios de modification, d’insertion et de suppression automatiques à l’aide de ASP.NET contrôles de source de données et liés aux données sont des scénarios de liaison de données bidirectionnel. Ces scénarios utilisent des expressions de liaison de données bidirectionnelle (<%# Bind("fieldname") %>). L’interface IBindableTemplate et l’infrastructure ASP.NET prennent en charge la liaison de données automatique, déclarative et bidirectionnelle entre les contrôles de source de données ASP.NET et le contenu modèle. Pour plus d’informations sur ASP.NET les expressions et la syntaxe de liaison de données, consultez Vue d’ensemble de la liaison aux bases de données et des expressions de liaison de données.
Le contenu modèle pour les contrôles liés aux données est le plus souvent défini de manière déclarative. Le tableau suivant décrit les processus les plus couramment utilisés pour lier des données modèles à des contrôles liés aux données.
| Contrôle lié aux données | Processus |
|---|---|
| DetailsView | Le contrôle lié aux données est lié aux données à l’aide de la DataSourceID propriété du contrôle de source de données, et le contenu modèle est défini dans une propriété ou InsertItemTemplate une ItemTemplateEditItemTemplate propriété. |
| GridView | Le contrôle lié aux données est lié aux données à l’aide de la DataSourceID propriété du contrôle de source de données, et le contenu modèle est défini dans une ItemTemplate ou EditItemTemplate une propriété. Le GridView contrôle ne prend pas en charge une opération d’insertion. |
| FormView | Le contrôle lié aux données est lié aux données à l’aide de la DataSourceID propriété, et le contenu modèle est défini dans un ItemTemplate, InsertItemTemplateou EditItemTemplate une propriété, ou dans un TemplateField objet. |
Les contrôles et Repeater les DataList contrôles ne prennent pas en charge les scénarios de liaison de données bidirectionnelle automatiques.
ASP.NET crée implicitement un objet lorsqu’un IBindableTemplate contenu modèle est lié à un contrôle de source de données ASP.NET dans le modèle est analysé. Plus précisément, l’analyseur ASP.NET crée une instance de la CompiledBindableTemplateBuilder classe lorsqu’elle analyse du contenu modèle qui utilise ASP.NET syntaxe de liaison de données et contient ASP.NET contrôles de serveur Web qui prennent en charge la liaison de données. Ces contrôles de serveur ASP.NET sont marqués par l’attributBindableAttribute.
L’interface IBindableTemplate définit une méthode, ExtractValues. Cette méthode est définie pour la liaison de données bidirectionnelle, afin qu’un contrôle lié aux données puisse extraire automatiquement des paires nom/valeur à partir du contenu modèle et transmettre les paires à un contrôle de source de données au moment de l’exécution. Pour que la liaison de données automatique réussisse, les noms de champs extraits du contenu modèle par la ExtractValues méthode doivent correspondre aux noms de paramètres dans un contrôle de source de données associé. Les développeurs de contrôles appellent explicitement la ExtractValues méthode uniquement dans leurs implémentations ou ExtractRowValues dans une autre méthode similaire d’un contrôle personnalisé lié aux données.
Méthodes
| ExtractValues(Control) |
Lors de l'implémentation par une classe, récupère un jeu de paires nom/valeur pour des valeurs liées à l'aide de la syntaxe de liaison de données ASP.NET bidirectionnelle au sein du contenu modélisé. |
| InstantiateIn(Control) |
Implémenté par une classe, définit l'objet Control auquel les contrôles enfants et les modèles appartiennent. Ces contrôles enfants sont à leur tour définis dans un modèle inline. (Hérité de ITemplate) |