ImageField Clase

Referencia

Definición

Espacio de nombres:: System.Web.UI.WebControls

Ensamblado:: System.Web.dll

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í.

Representa un campo que se muestra como una imagen en un control enlazado a datos.

public ref class ImageField : System::Web::UI::WebControls::DataControlField

public class ImageField : System.Web.UI.WebControls.DataControlField

type ImageField = class
    inherit DataControlField

Public Class ImageField
Inherits DataControlField

Herencia: Object

DataControlField
ImageField

Ejemplos

En el ejemplo siguiente se muestra cómo usar un ImageField objeto en un GridView control para mostrar una imagen.


<%@ Page language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ImageField Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>ImageField Example</h3>
                       
      <asp:gridview id="EmployeesGrid"
        autogeneratecolumns="false"
        datasourceid="EmployeeSource"  
        runat="server">
      
        <columns>

          <asp:imagefield dataimageurlfield="PhotoPath"
            alternatetext="Employee Photo"
            nulldisplaytext="No image on file."
            headertext="Photo"  
            readonly="true"/>
          <asp:boundfield datafield="FirstName"
            headertext="First Name"/>
          <asp:boundfield datafield="LastName"
            headertext="Last Name"/>
        
        </columns>
        
      </asp:gridview>
          
      <!-- 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], [PhotoPath] From [Employees]"
        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">
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ImageField Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>ImageField Example</h3>
                       
      <asp:gridview id="EmployeesGrid"
        autogeneratecolumns="false"
        datasourceid="EmployeeSource"  
        runat="server">
      
        <columns>

          <asp:imagefield dataimageurlfield="PhotoPath"
            alternatetext="Employee Photo"
            nulldisplaytext="No image on file."
            headertext="Photo"  
            readonly="true"/>
          <asp:boundfield datafield="FirstName"
            headertext="First Name"/>
          <asp:boundfield datafield="LastName"
            headertext="Last Name"/>
        
        </columns>
        
      </asp:gridview>
          
      <!-- 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], [PhotoPath] From [Employees]"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" 
        runat="server"/>
            
    </form>
  </body>
</html>

Comentarios

Los controles enlazados a datos (como GridView y DetailsView) usan la ImageField clase para mostrar una imagen para cada registro mostrado. El ImageField objeto se muestra de forma diferente en función del control enlazado a datos en el que se usa. Por ejemplo, el GridView control muestra un ImageField objeto como una columna, mientras que el DetailsView control lo muestra como una fila.

Para mostrar imágenes, debe enlazar un ImageField objeto a un campo de un origen de datos que contenga la dirección URL de una imagen. Esto se logra estableciendo la DataImageUrlField propiedad . El valor de la dirección URL se puede dar formato mediante la DataImageUrlFormatString propiedad . Cada imagen también puede tener texto alternativo asociado. Este texto se muestra cuando no se puede cargar una imagen o no está disponible. Los exploradores que admiten la característica Información sobre herramientas también muestran este texto como información sobre herramientas. Puede especificar el texto alternativo para una imagen mostrada mediante uno de los métodos siguientes:

Utilice la AlternateText propiedad para especificar texto alternativo que se aplica a todas las imágenes.
Utilice la DataAlternateTextField propiedad para enlazar un campo de un origen de datos a la AlternateText propiedad de cada imagen. Esto le permite tener texto alternativo diferente para cada imagen mostrada. Al enlazar datos, opcionalmente puede dar formato al texto alternativo mediante la DataAlternateTextFormatString propiedad .

Cuando el valor de la dirección URL de una imagen es null, no se puede mostrar una imagen. Puede mostrar una imagen alternativa para los null valores de campo estableciendo la NullImageUrl propiedad . En lugar de una imagen alternativa, puede mostrar texto alternativo estableciendo la NullDisplayText propiedad .

De forma predeterminada, todos los campos declarados se muestran en un control enlazado a datos. Puede ocultar un ImageField objeto en un control enlazado a datos estableciendo la Visible propiedad falseen .

Puede personalizar las secciones de encabezado y pie de página de un ImageField objeto. Para mostrar un título en la sección de encabezado o pie de página, establezca las HeaderText propiedades o FooterText , respectivamente. Para mostrar una imagen en la sección de encabezado en lugar de texto, establezca la HeaderImageUrl propiedad . La sección de encabezado se puede ocultar en el ImageField objeto estableciendo la ShowHeader propiedad falseen .

Nota:

Algunos controles enlazados a datos (como el GridView control) pueden mostrar u ocultar solo la sección de encabezado completa del control. Estos controles enlazados a datos no admiten la ShowHeader propiedad para un campo enlazado a datos individual. Para mostrar u ocultar toda la sección de encabezado de un control enlazado a datos, use la propiedad del ShowHeader control (si está disponible).

También puede personalizar la apariencia del ImageField objeto (color de fuente, color de fondo, etc.) estableciendo las propiedades de estilo para las diferentes partes del campo. En la tabla siguiente se enumeran las diferentes propiedades de estilo.

Style (propiedad)	Descripción
ControlStyle	La configuración de estilo para los controles secundarios del servidor web del ImageField objeto.
FooterStyle	La configuración de estilo de la sección pie de página del ImageField objeto.
HeaderStyle	La configuración de estilo de la sección de encabezado del ImageField objeto.
ItemStyle	La configuración de estilo de los elementos de datos del ImageField objeto .

Constructores

ImageField()

Inicializa una nueva instancia de la clase ImageField.

Campos

ThisExpression

Representa "esta" expresión.

Propiedades

AccessibleHeaderText	Obtiene o establece el texto que se representa como el valor de la propiedad `AbbreviatedText` en algunos controles. (Heredado de DataControlField)
AlternateText	Obtiene o establece el texto alternativo que se muestra para una imagen en el objeto ImageField.
Control	Obtiene una referencia al control de datos al que está asociado el objeto DataControlField. (Heredado de DataControlField)
ControlStyle	Obtiene el estilo de cualquier control de servidor web contenido en el objeto DataControlField. (Heredado de DataControlField)
ConvertEmptyStringToNull	Obtiene o establece un valor que indica si los valores de cadena vacía ("") se convierten en `null` cuando se devuelven los valores de campo del origen de datos.
DataAlternateTextField	Obtiene o establece el nombre del campo del origen de datos que contiene los valores que se van a enlazar a la propiedad AlternateText de cada imagen de un objeto ImageField.
DataAlternateTextFormatString	Obtiene o establece la cadena que especifica el formato con que se representar el texto alternativo para cada imagen de un objeto ImageField.
DataImageUrlField	Obtiene o establece el nombre del campo del origen de datos que contiene los valores que se van a enlazar a la propiedad ImageUrl de cada imagen de un objeto ImageField.
DataImageUrlFormatString	Obtiene o establece la cadena que especifica el formato con que se representa la dirección URL para cada imagen de un objeto ImageField.
DesignMode	Obtiene un valor que indica si un campo de control de datos está visible actualmente en un entorno en tiempo de diseño. (Heredado de DataControlField)
FooterStyle	Obtiene o establece el estilo del pie de página del campo del control de datos. (Heredado de DataControlField)
FooterText	Obtiene o establece el texto que se muestra en el elemento de pie de página de un campo de control de datos. (Heredado de DataControlField)
HeaderImageUrl	Obtiene o establece la dirección URL de una imagen que se muestra en el elemento de encabezado de un campo de control de datos. (Heredado de DataControlField)
HeaderStyle	Obtiene o establece el estilo del encabezado del campo del control de datos. (Heredado de DataControlField)
HeaderText	Obtiene o establece el texto que se muestra en el elemento de encabezado de un campo de control de datos. (Heredado de DataControlField)
InsertVisible	Obtiene un valor que indica si el objeto DataControlField está visible cuando su control enlazado a datos primario está en modo de inserción. (Heredado de DataControlField)
IsTrackingViewState	Obtiene un valor que indica si el objeto DataControlField está guardando los cambios en su estado de vista. (Heredado de DataControlField)
ItemStyle	Obtiene el estilo de cualquier contenido basado en texto mostrado por un campo de control de datos. (Heredado de DataControlField)
NullDisplayText	Obtiene o establece el texto que se va a mostrar en un objeto ImageField cuando el valor del campo que especifica la propiedad DataImageUrlField es `null`.
NullImageUrl	Obtiene o establece la dirección URL de una imagen alternativa presentada en un objeto ImageField cuando el valor del campo especificado por la propiedad DataImageUrlField es `null`.
ReadOnly	Obtiene o establece un valor que indica si los valores del campo especificado por la propiedad DataImageUrlField se pueden modificar en modo de edición.
ShowHeader	Obtiene o establece un valor que indica si se representa el elemento de encabezado de un campo de control de datos. (Heredado de DataControlField)
SortExpression	Obtiene o establece una expresión de ordenación utilizada por un control de origen de datos para ordenar los datos. (Heredado de DataControlField)
ValidateRequestMode	Obtiene o establece un valor que especifica si el control valida la entrada de cliente. (Heredado de DataControlField)
ViewState	Obtiene un diccionario con información de estado que permite guardar y restaurar el estado de vista de un objeto DataControlField en las distintas solicitudes de la misma página. (Heredado de DataControlField)
Visible	Obtiene o establece un valor que indica si se representa un campo de control de datos. (Heredado de DataControlField)

Métodos

CloneField()	Crea una copia duplicada del objeto actual derivado de DataControlField. (Heredado de DataControlField)
CopyProperties(DataControlField)	Copia las propiedades del objeto ImageField actual en el objeto especificado.
CreateField()	Devuelve una nueva instancia de la clase ImageField.
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)	El objeto IOrderedDictionary especificado se rellena con los valores del objeto DataControlFieldCell especificado.
FormatImageUrlValue(Object)	Aplica el formato especificado por la propiedad DataImageUrlFormatString a un valor de campo.
GetDesignTimeValue()	Recupera el valor utilizado como valor de un campo al representar el objeto ImageField en un diseñador.
GetFormattedAlternateText(Control)	Aplica el formato especificado por la propiedad DataAlternateTextFormatString al valor de texto alternativo incluido en el objeto Control especificado.
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
GetValue(Control, String, PropertyDescriptor)	Recupera el valor del campo especificado del control indicado.
Initialize(Boolean, Control)	Inicializa el objeto ImageField.
InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)	Inicializa el objeto DataControlFieldCell especificado con el tipo de celda, estado de fila e índice de fila indicados.
InitializeDataCell(DataControlFieldCell, DataControlRowState)	Inicializa el objeto DataControlFieldCell especificado con el estado de fila indicado.
LoadViewState(Object)	Restaura la vista del origen de datos tal y como se guardó previamente. (Heredado de DataControlField)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
OnDataBindField(Object, EventArgs)	Enlaza el valor de un campo al objeto ImageField.
OnFieldChanged()	Genera el evento `FieldChanged`. (Heredado de DataControlField)
SaveViewState()	Guarda los cambios efectuados en el estado de vista de DataControlField desde el momento en que se devolvió la página al servidor. (Heredado de DataControlField)
ToString()	Devuelve una cadena que representa este objeto DataControlField. (Heredado de DataControlField)
TrackViewState()	Hace que el objeto DataControlField lleve un seguimiento de los cambios de su estado de vista, de modo que puedan almacenarse en la propiedad ViewState del control y mantenerse en todas las solicitudes de la misma página. (Heredado de DataControlField)
ValidateSupportsCallback()	Determina si los controles incluidos en un objeto ImageField admiten devoluciones de llamada.

Implementaciones de interfaz explícitas

IDataSourceViewSchemaAccessor.DataSourceViewSchema	Obtiene o establece el esquema asociado a este objeto DataControlField. (Heredado de DataControlField)
IStateManager.IsTrackingViewState	Obtiene un valor que indica si el objeto DataControlField está guardando los cambios en su estado de vista. (Heredado de DataControlField)
IStateManager.LoadViewState(Object)	Restaura el estado de vista que se guardó previamente del campo de control de datos. (Heredado de DataControlField)
IStateManager.SaveViewState()	Guarda los cambios efectuados en el estado de vista de DataControlField desde el momento en que se devolvió la página al servidor. (Heredado de DataControlField)
IStateManager.TrackViewState()	Hace que el objeto DataControlField lleve un seguimiento de los cambios de su estado de vista, de modo que puedan almacenarse en la propiedad ViewState del control y mantenerse en todas las solicitudes de la misma página. (Heredado de DataControlField)

Se aplica a

ImageField Clase

Definición

Ejemplos

Comentarios

Constructores

Campos

Propiedades

Métodos

Implementaciones de interfaz explícitas

Se aplica a

Consulte también

Comentarios

Recursos adicionales