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.
Fournit un moyen pour ASP.NET contrôles liés aux données, tels que DetailsView et FormView, de lier automatiquement à un contrôle de source de données ASP.NET dans des sections de contenu modèle.
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, lier des 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 SqlDataSource contrôle aux zones de liaison de données définies dans le modèle par une syntaxe de liaison de données unidirectionnelle ASP.NET syntaxe de liaison de données (<%# Eval("fieldname") %>) et 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, ASP.NET pages web valident que l’entrée utilisateur n’inclut pas de script ou d’éléments HTML. Pour plus d’informations, consultez Vue d’ensemble des exploits 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 , pour FormViewétablir une liaison aux données fournies par un contrôle de source de données ASP.NET, par ObjectDataSourceSqlDataSourceexemple, lorsque le contrôle lié aux données inclut du contenu modèle.
Note
Les développeurs de pages n’implémentent pas l’interface IBindableTemplate . Les développeurs qui créent des contrôles personnalisés liés aux données peuvent manipuler IBindableTemplate des objets dans les implémentations des méthodes et ExtractRowValues des PerformDataBinding 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 modèle d’un contrôle lié aux données, les contrôles enfants au sein du modèle ne sont pas visibles par le contrôle parent lié aux données : le parent peut afficher le contenu enfant (car les contrôles s’affichent efficacement), mais il ne peut pas extraire les valeurs de ces contrôles enfants pour 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 lié aux données parent. La Bind syntaxe permet au contrôle lié aux données d’extraire les valeurs d’une liaison de données de contrôle à 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 de liaison de données bidirectionnelle ASP.NET. 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 liés aux données et de source de 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 ASP.NET contrôles de source de données et le contenu modèle. Pour plus d’informations sur ASP.NET les expressions et la syntaxe de liaison de données, consultez Liaison à des bases de données et vue d’ensemble des expressionsData-Binding.
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 de modèle est défini dans une ou EditItemTemplateInsertItemTemplate une ItemTemplateproprié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 ou EditItemTemplate une ItemTemplate 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 de modèle est défini dans un ItemTemplate, InsertItemTemplateou EditItemTemplate une propriété ou dans un TemplateField objet. |
Les DataList contrôles et Repeater les contrôles ne prennent pas en charge les scénarios de liaison de données bidirectionnelle automatiques.
ASP.NET crée implicitement un IBindableTemplate objet lorsque du contenu modèle 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’attribut BindableAttribute .
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 une autre méthode similaire d’un contrôle personnalisé lié aux données.
Méthodes
| Nom | Description |
|---|---|
| ExtractValues(Control) |
En cas d’implémentation par une classe, récupère un ensemble de paires nom/valeur pour les valeurs liées à l’aide d’une syntaxe de liaison de données bidirectionnelle ASP.NET au sein du contenu modèle. |
| InstantiateIn(Control) |
En cas d’implémentation par une classe, définit l’objet Control auquel appartiennent les contrôles enfants et les modèles. Ces contrôles enfants sont à leur tour définis dans un modèle inline. (Hérité de ITemplate) |
