Esta documentación está archivada y no tiene mantenimiento.

FieldTemplateUserControl (Clase)

Actualización: noviembre 2007

Representa la clase base de todos los controles de plantilla de campo.

Espacio de nombres:  System.Web.DynamicData
Ensamblado:  System.Web.DynamicData (en System.Web.DynamicData.dll)

[AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level = AspNetHostingPermissionLevel.Minimal)]
[AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal)]
public class FieldTemplateUserControl : UserControl, 
	IBindableControl, IFieldTemplate
/** @attribute AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level = AspNetHostingPermissionLevel.Minimal) */
/** @attribute AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal) */
public class FieldTemplateUserControl extends UserControl implements IBindableControl, 
	IFieldTemplate
public class FieldTemplateUserControl extends UserControl implements IBindableControl, IFieldTemplate
<asp:FieldTemplateUserControl />

Las plantillas de campo de datos dinámicos de ASP.NET son controles de usuario de ASP.NET que asignan controles de datos a tipos de datos de un modelo de datos. Las plantillas de campo proceden de la clase FieldTemplateUserControl, que da acceso a campos de datos, columnas de datos y metadatos de los modelos de datos. Los proyectos de datos dinámicos proporcionan plantillas de campo de forma predeterminada. Se pueden modificar las plantillas de campo que se proporcionan de forma predeterminada o se pueden crear plantillas de campo personalizadas.

Esta clase se hereda de la clase UserControl.

En el ejemplo de código siguiente, se crea una plantilla de campo que muestra los campos de datos que mantienen una relación de varios a uno y se representa un control HyperLink que redirige al usuario a la página de la relación.

Archivo ForeignKey.ascx.vb

[Visual Basic]

Public Partial Class ForeignKeyField 
    Inherits System.Web.DynamicData.FieldTemplateUserControl 
    
    Protected Function GetDisplayString() As String 
        
    Return  
FormatFieldValue(ForeignKeyColumn.ParentTable.GetDisplayString(FieldValue)) 
    End Function 

    Public Overloads Overrides ReadOnly Property DataControl() As Control 
        Get 
            Return HyperLink1 
        End Get 
    End Property 
    
End Class 

ForeignKey.aspx

[Visual Basic]

<%@ Control Language="VB" CodeFile="ForeignKey.ascx.vb" Inherits="ForeignKeyField" %>

<asp:HyperLink ID="HyperLink1" runat="server"
    Text="<%# GetDisplayString() %>" />

[C#]

ForeignKey.ascx.cs


public partial class ForeignKeyField :      
                        System.Web.DynamicData.FieldTemplateUserControl 
{
    protected string GetDisplayString() 
    {
       Return         FormatFieldValue(ForeignKeyColumn.ParentTable.GetDisplayString(FieldValue));

    public override Control DataControl 
    {
        get 
        {
          return HyperLink1;
    }
}

ForeignKey.aspx

[C#]

<%@ Control Language="C#" CodeFile="ForeignKey.ascx.cs" Inherits="ForeignKeyField" %>

<asp:HyperLink ID="HyperLink1" runat="server"
    Text="<%# GetDisplayString() %>" />

Para compilar el código de ejemplo, necesita:

  • Microsoft Visual Studio 2008 Service Pack 1 o Visual Web Developer 2008 Express Service Pack 1.

  • La base de datos de ejemplo AdventureWorksLT. Para obtener información sobre la forma de descargar e instalar la base de datos de ejemplo de SQL Server, vea Microsoft SQL Server Product Samples: Database en el sitio CodePlex. Asegúrese de que instala la versión correcta de la base de datos de ejemplo para la versión de SQL Server que esté ejecutando (Microsoft SQL Server 2005 o Microsoft SQL Server 2008).

  • Un sitio web de datos dinámicos. De este modo, puede crearse un contexto de datos para la base de datos y la clase que contiene el campo de datos que va a personalizarse y los métodos que van a invalidarse. Además, se crea el entorno en el que va a usarse la página anteriormente descrita. Para obtener más información, vea Walkthrough: Creating a New Dynamic Data Web Site using Scaffolding.

  • AspNetHostingPermission 

    para trabajar en un entorno hospedado en host. Acción de seguridad: LinkDemand. Enumeración asociada: AspNetHostingPermissionLevel.Minimal.

  • AspNetHostingPermission 

    para trabajar en un entorno hospedado en host. Acción de seguridad: InheritanceDemand. Enumeración asociada: AspNetHostingPermissionLevel.Minimal.

System.Object
  System.Web.UI.Control
    System.Web.UI.TemplateControl
      System.Web.UI.UserControl
        System.Web.DynamicData.FieldTemplateUserControl

Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

.NET Framework

Compatible con: 3.5 SP1
Mostrar: