IBindableTemplate Interfaz
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Proporciona un medio para que los controles enlazados a datos de ASP.NET, como DetailsView y FormView, puedan enlazarse automáticamente a un control de origen de datos de ASP.NET dentro de las secciones de contenido con plantilla.
public interface class IBindableTemplate : System::Web::UI::ITemplatepublic interface IBindableTemplate : System.Web.UI.ITemplatetype IBindableTemplate = interface
interface ITemplatePublic Interface IBindableTemplate
Implements ITemplate- Derivado
- Implementaciones
Ejemplos
En el ejemplo de código siguiente se muestra cómo un FormView control puede definir mediante declaración contenido con plantilla, enlazar a los datos proporcionados por un SqlDataSource control y mostrar y editar registros existentes. El analizador ASP.NET analiza el contenido con plantilla y crea un IBindableTemplate objeto en tiempo de ejecución que puede enlazar valores desde el SqlDataSource control a las áreas de enlace de datos definidas en la plantilla mediante la sintaxis de enlace de datos ASP.NET unidireccional () y la sintaxis de enlace de datos bidireccional (<%# Eval("fieldname") %><%# Bind("fieldname") %>).
Importante
Este control tiene un cuadro de texto que acepta la entrada del usuario, que es una amenaza de seguridad potencial. De forma predeterminada, ASP.NET Web Pages valida que los datos proporcionados por el usuario no incluyen elementos HTML ni de script. Para más información, consulte Información general sobre los ataques mediante scripts.
<%@ 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>
Comentarios
La IBindableTemplate interfaz proporciona una manera de ASP.NET controles enlazados a datos, como DetailsView, GridViewy FormView, para enlazar a los datos proporcionados por un control de origen de datos de ASP.NET, como ObjectDataSource o SqlDataSource, cuando el control enlazado a datos incluye contenido con plantilla.
Nota
Los desarrolladores de páginas no implementan la IBindableTemplate interfaz . Los desarrolladores que crean controles enlazados a datos personalizados pueden manipular IBindableTemplate objetos en implementaciones de los PerformDataBinding métodos y ExtractRowValues , pero no implementan sus propios IBindableTemplate objetos.
Los controles enlazados a datos, como GridView normalmente, son conscientes de sus árboles de control secundarios y, por tanto, pueden enlazar valores a ellos, extraer valores de ellos y pasar estos valores entre el control enlazado a datos y un control de origen de datos siempre que se produzca el enlace de datos. Sin embargo, cuando un desarrollador de páginas define el contenido con plantilla para un control enlazado a datos, los controles secundarios de la plantilla no son visibles para el control enlazado a datos primario: el elemento primario puede representar el contenido secundario (porque los controles se representan de forma eficaz), pero no puede extraer los valores de estos controles secundarios para pasar a la actualización del control de origen de datos asociado, operación de inserción o eliminación. En escenarios de enlace de datos, el contenido con plantilla es opaco en un control enlazado a datos primario. La Bind sintaxis permite que el control enlazado a datos extraiga los valores de un control enlazado a datos dentro de una IBindableTemplate instancia de .
El enlace de datos puede ser unidireccional o bidireccional. (Estas direcciones de enlace se definen mediante la BindingDirection enumeración). El enlace de datos unidireccional es cualquier enlace de datos realizado en una dirección de salida, desde el control de origen de datos al control enlazado a datos; por ejemplo, cualquier escenario de lectura de datos implica un enlace de datos unidireccional. Para el enlace de datos unidireccional, puede usar la sintaxis de enlace de datos unidireccional (<%# Eval("fieldname") %>) dentro del contenido con plantilla y no es necesario usar la sintaxis bidireccional ASP.NET enlace de datos. El enlace de datos bidireccional describe el enlace de datos en la dirección de entrada, desde el control enlazado a datos al control de origen de datos. Los escenarios de edición, inserción y eliminación automáticas mediante ASP.NET controles enlazados a datos y de origen de datos son escenarios bidireccionales de enlace de datos. Estos escenarios usan expresiones de enlace de datos bidireccionales (<%# Bind("fieldname") %>). La IBindableTemplate interfaz y la infraestructura de ASP.NET admiten el enlace de datos bidireccional, declarativo y automático entre ASP.NET controles de origen de datos y contenido con plantilla. Para obtener más información sobre ASP.NET expresiones y sintaxis de enlace de datos, vea Binding to Databases and Data-Binding Expressions Overview.
El contenido con plantilla para los controles enlazados a datos se define con más frecuencia mediante declaración. En la tabla siguiente se describen los procesos que se usan con más frecuencia para enlazar datos con plantilla a controles enlazados a datos.
| Control enlazado a datos | Proceso |
|---|---|
| DetailsView | El control enlazado a datos se enlaza a datos mediante la DataSourceID propiedad del control de origen de datos y el contenido con plantilla se define en una ItemTemplatepropiedad , EditItemTemplate o InsertItemTemplate . |
| GridView | El control enlazado a datos se enlaza a datos mediante la DataSourceID propiedad del control de origen de datos y el contenido con plantilla se define en una ItemTemplate propiedad o EditItemTemplate . El GridView control no admite una operación de inserción. |
| FormView | El control enlazado a datos se enlaza a datos mediante la DataSourceID propiedad y el contenido con plantilla se define en una ItemTemplatepropiedad , InsertItemTemplateo EditItemTemplate , o en un TemplateField objeto . |
Los DataList controles y Repeater no admiten escenarios automáticos de enlace de datos bidireccionales.
ASP.NET crea implícitamente un IBindableTemplate objeto cuando se analiza el contenido con plantilla que se enlaza a un control de origen de datos ASP.NET dentro de la plantilla. En concreto, el analizador de ASP.NET crea una instancia de la CompiledBindableTemplateBuilder clase cuando analiza el contenido con plantilla que usa ASP.NET sintaxis de enlace de datos y contiene ASP.NET controles de servidor web que admiten el enlace de datos. Estos ASP.NET controles de servidor están marcados por el BindableAttribute atributo .
La IBindableTemplate interfaz define un método, ExtractValues. Este método se define para el enlace de datos bidireccional, de modo que un control enlazado a datos pueda extraer automáticamente pares nombre-valor del contenido con plantilla y pasar los pares a un control de origen de datos en tiempo de ejecución. Para que el enlace de datos automático se realice correctamente, los nombres de campo extraídos del contenido con plantilla por el ExtractValues método deben coincidir con los nombres de parámetro en un control de origen de datos asociado. Los desarrolladores de controles llaman explícitamente al ExtractValues método solo dentro de sus implementaciones de ExtractRowValues o algún otro método similar de un control enlazado a datos personalizado.
Métodos
| ExtractValues(Control) |
Cuando se implementa con una clase, recupera un conjunto de pares de nombre y valor para valores enlazados utilizando la sintaxis de enlace de datos bidireccional de ASP.NET dentro del contenido con plantilla. |
| InstantiateIn(Control) |
Cuando se implementa mediante una clase, define el objeto Control al que pertenecen los controles secundarios y las plantillas. Estos controles secundarios están a su vez definidos en una plantilla en línea. (Heredado de ITemplate) |
