ImageField Clase

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 desde 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:

Use la AlternateText propiedad para especificar texto alternativo que se aplique 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, puede dar formato opcional al texto alternativo mediante la DataAlternateTextFormatString propiedad .

Cuando el valor de 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 distintas partes del campo. En la tabla siguiente se enumeran las distintas 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

Nombre	Description
ImageField()	Inicializa una nueva instancia de la clase ImageField.

Campos

Nombre	Description
ThisExpression	Representa la expresión "this".

Propiedades

Nombre	Description
AccessibleHeaderText	Obtiene o establece texto que se representa como valor de `AbbreviatedText` propiedad en algunos controles. (Heredado de DataControlField)
AlternateText	Obtiene o establece el texto alternativo que se muestra para una imagen en el ImageField objeto .
Control	Obtiene una referencia al control de datos al que está asociado el DataControlField objeto . (Heredado de DataControlField)
ControlStyle	Obtiene el estilo de cualquier control de servidor web contenido por el DataControlField objeto . (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 AlternateText propiedad de cada imagen de un ImageField objeto .
DataAlternateTextFormatString	Obtiene o establece la cadena que especifica el formato en el que se representa el texto alternativo para cada imagen de un ImageField objeto.
DataImageUrlField	Obtiene o establece el nombre del campo del origen de datos que contiene los valores que se van a enlazar a la ImageUrl propiedad de cada imagen de un ImageField objeto .
DataImageUrlFormatString	Obtiene o establece la cadena que especifica el formato en el que se representa la dirección URL de cada imagen de un ImageField objeto.
DesignMode	Obtiene un valor que indica si un campo de control de datos se ve 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 de control de datos. (Heredado de DataControlField)
FooterText	Obtiene o establece el texto que se muestra en el elemento 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 de 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 DataControlField objeto 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 DataControlField objeto guarda 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 ImageField objeto cuando el valor del campo especificado por la DataImageUrlField propiedad es `null`.
NullImageUrl	Obtiene o establece la dirección URL en una imagen alternativa que se muestra en un ImageField objeto cuando el valor del campo especificado por la DataImageUrlField propiedad es `null`.
ReadOnly	Obtiene o establece un valor que indica si los valores del campo especificado por la DataImageUrlField propiedad 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 que usa 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 del cliente. (Heredado de DataControlField)
ViewState	Obtiene un diccionario de información de estado que permite guardar y restaurar el estado de vista de un DataControlField objeto en varias solicitudes para 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

Nombre	Description
CloneField()	Crea una copia duplicada del objeto derivado actual DataControlField. (Heredado de DataControlField)
CopyProperties(DataControlField)	Copia las propiedades del objeto actual ImageField en el objeto especificado.
CreateField()	Devuelve una nueva instancia de la ImageField clase .
Equals(Object)	Determina si el objeto especificado es igual al objeto actual. (Heredado de Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)	Rellena el objeto especificado IOrderedDictionary con los valores del objeto especificado DataControlFieldCell .
FormatImageUrlValue(Object)	Aplica el formato especificado por la DataImageUrlFormatString propiedad a un valor de campo.
GetDesignTimeValue()	Recupera el valor usado para el valor de un campo al representar el ImageField objeto en un diseñador.
GetFormattedAlternateText(Control)	Aplica el formato especificado por la DataAlternateTextFormatString propiedad al valor de texto alternativo contenido en el objeto especificado Control .
GetHashCode()	Actúa como 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 especificado.
Initialize(Boolean, Control)	Inicializa el objeto ImageField.
InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)	Inicializa el objeto especificado DataControlFieldCell con el tipo de celda, el estado de fila y el índice de fila especificados.
InitializeDataCell(DataControlFieldCell, DataControlRowState)	Inicializa el objeto especificado DataControlFieldCell con el estado de fila especificado.
LoadViewState(Object)	Restaura el estado de vista guardado previamente de la vista del origen de datos. (Heredado de DataControlField)
MemberwiseClone()	Crea una copia superficial del Objectactual. (Heredado de Object)
OnDataBindField(Object, EventArgs)	Enlaza el valor de un campo al ImageField objeto .
OnFieldChanged()	Genera el evento `FieldChanged`. (Heredado de DataControlField)
SaveViewState()	Guarda los cambios realizados en el DataControlField estado de vista desde el momento en que la página se devolvió al servidor. (Heredado de DataControlField)
ToString()	Devuelve una cadena que representa este DataControlField objeto. (Heredado de DataControlField)
TrackViewState()	Hace que el DataControlField objeto realice un seguimiento de los cambios en su estado de vista para que se puedan almacenar en la propiedad del ViewState control y conservarse en las solicitudes de la misma página. (Heredado de DataControlField)
ValidateSupportsCallback()	Determina si los controles contenidos en un ImageField objeto admiten devoluciones de llamada.

Implementaciones de interfaz explícitas

Nombre	Description
IDataSourceViewSchemaAccessor.DataSourceViewSchema	Obtiene o establece el esquema asociado a este DataControlField objeto. (Heredado de DataControlField)
IStateManager.IsTrackingViewState	Obtiene un valor que indica si el DataControlField objeto guarda los cambios en su estado de vista. (Heredado de DataControlField)
IStateManager.LoadViewState(Object)	Restaura el estado de vista guardado previamente del campo de control de datos. (Heredado de DataControlField)
IStateManager.SaveViewState()	Guarda los cambios realizados en el DataControlField estado de vista desde el momento en que la página se devolvió al servidor. (Heredado de DataControlField)
IStateManager.TrackViewState()	Hace que el DataControlField objeto realice un seguimiento de los cambios en su estado de vista para que se puedan almacenar en la propiedad del ViewState control y conservarse en las solicitudes de la misma página. (Heredado de DataControlField)

Se aplica a

Consulte también

Comentarios

Resultoulle útil esta páxina?

Compartir por

ImageField Clase

Definición

Ejemplos

Comentarios

Constructores

Campos

Propiedades

Métodos

Implementaciones de interfaz explícitas

Se aplica a

Consulte también

Comentarios