ImageField ImageField ImageField ImageField Class

Definición

Representa un campo que se muestra como una imagen en un control enlazado a datos.Represents a field that is displayed as an image in a data-bound control.

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

Ejemplos

En el ejemplo siguiente se muestra cómo usar ImageField un objeto en GridView un control para mostrar una imagen.The following example demonstrates how to use an ImageField object in a GridView control to display an image.


<%@ 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 ImageField controles enlazados a datos ( GridView como y DetailsView) utilizan la clase para mostrar una imagen para cada registro que se muestra.The ImageField class is used by data-bound controls (such as GridView and DetailsView) to display an image for each record displayed. El ImageField objeto se muestra de forma diferente en función del control enlazado a datos en el que se utiliza.The ImageField object is displayed differently depending on the data-bound control in which it is used. Por ejemplo, el GridView control muestra un ImageField objeto como una columna, mientras que DetailsView el control lo muestra como una fila.For example, the GridView control displays an ImageField object as a column, while the DetailsView control displays it as a row.

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.To display images, you must bind an ImageField object to a field from a data source that contains the URL of an image. Esto se logra estableciendo la DataImageUrlField propiedad.This is accomplished by setting the DataImageUrlField property. Se puede dar formato al valor de dirección URL DataImageUrlFormatString mediante la propiedad.The URL value can be formatted by using the DataImageUrlFormatString property. Cada imagen también puede tener texto alternativo asociado.Each image can also have alternate text associated with it. Este texto se muestra cuando no se puede cargar una imagen o no está disponible.This text is displayed when an image cannot be loaded, or is unavailable. Los exploradores que admiten la característica de información sobre herramientas también muestran este texto como una información sobre herramientas.Browsers that support the ToolTips feature also display this text as a ToolTip. Puede especificar el texto alternativo de una imagen mostrada mediante uno de los métodos siguientes:You can specify the alternate text for a displayed image by using one of the following methods:

  • Utilice la AlternateText propiedad para especificar el texto alternativo que se aplica a todas las imágenes.Use the AlternateText property to specify alternate text that applies to all images.

  • Utilice la DataAlternateTextField propiedad para enlazar un campo de un origen de datos AlternateText a la propiedad de cada imagen.Use the DataAlternateTextField property to bind a field from a data source to the AlternateText property of each image. Esto le permite tener texto alternativo diferente para cada imagen mostrada.This allows you to have different alternate text for each image displayed. Al enlazar datos, puede dar formato al texto alternativo mediante la DataAlternateTextFormatString propiedad.When binding data, you can optionally format the alternate text by using the DataAlternateTextFormatString property.

Cuando el valor de dirección URL de una nullimagen es, no se puede mostrar una imagen.When the URL value for an image is null, an image cannot be displayed. Puede mostrar una imagen alternativa para los null valores de campo estableciendo la NullImageUrl propiedad.You can display an alternate image for null field values by setting the NullImageUrl property. En lugar de una imagen alternativa, puede mostrar texto alternativo estableciendo la NullDisplayText propiedad.Instead of an alternate image, you can display alternate text by setting the NullDisplayText property.

De forma predeterminada, todos los campos declarados se muestran en un control enlazado a datos.By default, all declared fields are displayed in a data-bound control. Puede ocultar un ImageField objeto en un control enlazado a datos estableciendo la Visible propiedad en false.You can hide an ImageField object in a data-bound control by setting the Visible property to false.

Puede personalizar las secciones de encabezado y pie de página de ImageField un objeto.You can customize the header and footer sections of an ImageField object. Para mostrar un título en la sección de encabezado o de pie de página HeaderText , FooterText establezca las propiedades o, respectivamente.To display a caption in the header or footer section, set the HeaderText or FooterText properties, respectively. Para mostrar una imagen en la sección de encabezado en lugar de texto, establezca HeaderImageUrl la propiedad.To display an image in the header section instead of text, set the HeaderImageUrl property. La sección de encabezado se puede ocultar en ImageField el objeto estableciendo la ShowHeader propiedad en false.The header section can be hidden in the ImageField object by setting the ShowHeader property to false.

Nota

Algunos controles enlazados a datos (como el GridView control) pueden mostrar u ocultar solo la sección de encabezado completa del control.Some data-bound controls (such as the GridView control) can show or hide only the entire header section of the control. Estos controles enlazados a datos no admiten ShowHeader la propiedad para un campo enlazado a datos individual.These data-bound controls do not support the ShowHeader property for an individual data-bound field. Para mostrar u ocultar toda la sección de encabezado de un control enlazado a datos, use la ShowHeader propiedad del control (si está disponible).To show or hide the entire header section of a data-bound control, use the control's ShowHeader property (if available).

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.You also can customize the appearance of the ImageField object (font color, background color, and so on) by setting the style properties for the different parts of the field. En la tabla siguiente se enumeran las distintas propiedades de estilo.The following table lists the different style properties.

Propiedad de estiloStyle property DescripciónDescription
ControlStyle La configuración de estilo para los controles de servidor Web secundarios ImageField del objeto.The style settings for the child Web server controls of the ImageField object.
FooterStyle La configuración de estilo de la sección de pie de ImageField página del objeto.The style settings for the footer section of the ImageField object.
HeaderStyle La configuración de estilo para la sección de encabezado ImageField del objeto.The style settings for the header section of the ImageField object.
ItemStyle La configuración de estilo para los elementos de datos ImageField en el objeto.The style settings for the data items in the ImageField object.

Constructores

ImageField() ImageField() ImageField() ImageField()

Inicializa una nueva instancia de la clase ImageField.Initializes a new instance of the ImageField class.

Campos

ThisExpression ThisExpression ThisExpression ThisExpression

Representa "esta" expresión.Represents the "this" expression.

Propiedades

AccessibleHeaderText AccessibleHeaderText AccessibleHeaderText AccessibleHeaderText

Obtiene o establece el texto que se representa como el valor de la propiedad AbbreviatedText en algunos controles.Gets or sets text that is rendered as the AbbreviatedText property value in some controls.

(Inherited from DataControlField)
AlternateText AlternateText AlternateText AlternateText

Obtiene o establece el texto alternativo que se muestra para una imagen en el objeto ImageField.Gets or sets the alternate text displayed for an image in the ImageField object.

Control Control Control Control

Obtiene una referencia al control de datos al que está asociado el objeto DataControlField.Gets a reference to the data control that the DataControlField object is associated with.

(Inherited from DataControlField)
ControlStyle ControlStyle ControlStyle ControlStyle

Obtiene el estilo de cualquier control de servidor web contenido en el objeto DataControlField.Gets the style of any Web server controls contained by the DataControlField object.

(Inherited from DataControlField)
ConvertEmptyStringToNull ConvertEmptyStringToNull ConvertEmptyStringToNull 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.Gets or sets a value indicating whether empty string ("") values are converted to null when the field values are returned from the data source.

DataAlternateTextField DataAlternateTextField DataAlternateTextField 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.Gets or sets the name of the field from the data source that contains the values to bind to the AlternateText property of each image in an ImageField object.

DataAlternateTextFormatString DataAlternateTextFormatString DataAlternateTextFormatString DataAlternateTextFormatString

Obtiene o establece la cadena que especifica el formato con que se representar el texto alternativo para cada imagen de un objeto ImageField.Gets or sets the string that specifies the format in which the alternate text for each image in an ImageField object is rendered.

DataImageUrlField DataImageUrlField DataImageUrlField 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.Gets or sets the name of the field from the data source that contains the values to bind to the ImageUrl property of each image in an ImageField object.

DataImageUrlFormatString DataImageUrlFormatString DataImageUrlFormatString 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.Gets or sets the string that specifies the format in which the URL for each image in an ImageField object is rendered.

DesignMode DesignMode DesignMode DesignMode

Obtiene un valor que indica si un campo de control de datos está visible actualmente en un entorno en tiempo de diseño.Gets a value indicating whether a data control field is currently viewed in a design-time environment.

(Inherited from DataControlField)
FooterStyle FooterStyle FooterStyle FooterStyle

Obtiene o establece el estilo del pie de página del campo del control de datos.Gets or sets the style of the footer of the data control field.

(Inherited from DataControlField)
FooterText FooterText FooterText FooterText

Obtiene o establece el texto que se muestra en el elemento de pie de página de un campo de control de datos.Gets or sets the text that is displayed in the footer item of a data control field.

(Inherited from DataControlField)
HeaderImageUrl HeaderImageUrl HeaderImageUrl 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.Gets or sets the URL of an image that is displayed in the header item of a data control field.

(Inherited from DataControlField)
HeaderStyle HeaderStyle HeaderStyle HeaderStyle

Obtiene o establece el estilo del encabezado del campo del control de datos.Gets or sets the style of the header of the data control field.

(Inherited from DataControlField)
HeaderText HeaderText HeaderText HeaderText

Obtiene o establece el texto que se muestra en el elemento de encabezado de un campo de control de datos.Gets or sets the text that is displayed in the header item of a data control field.

(Inherited from DataControlField)
IDataSourceViewSchemaAccessor.DataSourceViewSchema IDataSourceViewSchemaAccessor.DataSourceViewSchema IDataSourceViewSchemaAccessor.DataSourceViewSchema IDataSourceViewSchemaAccessor.DataSourceViewSchema

Obtiene o establece el esquema asociado a este objeto DataControlField.Gets or sets the schema associated with this DataControlField object.

(Inherited from DataControlField)
InsertVisible InsertVisible InsertVisible 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.Gets a value indicating whether the DataControlField object is visible when its parent data-bound control is in insert mode.

(Inherited from DataControlField)
IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState

Obtiene un valor que indica si el objeto DataControlField está guardando los cambios en su estado de vista.Gets a value indicating whether the DataControlField object is saving changes to its view state.

(Inherited from DataControlField)
IsTrackingViewState IsTrackingViewState IsTrackingViewState IsTrackingViewState

Obtiene un valor que indica si el objeto DataControlField está guardando los cambios en su estado de vista.Gets a value indicating whether the DataControlField object is saving changes to its view state.

(Inherited from DataControlField)
ItemStyle ItemStyle ItemStyle ItemStyle

Obtiene el estilo de cualquier contenido basado en texto mostrado por un campo de control de datos.Gets the style of any text-based content displayed by a data control field.

(Inherited from DataControlField)
NullDisplayText NullDisplayText NullDisplayText 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.Gets or sets the text to display in an ImageField object when the value of the field specified by the DataImageUrlField property is null.

NullImageUrl NullImageUrl NullImageUrl 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.Gets or sets the URL to an alternate image displayed in an ImageField object when the value of the field specified by the DataImageUrlField property is null.

ReadOnly ReadOnly ReadOnly 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.Gets or sets a value indicating whether the values of the field specified by the DataImageUrlField property can be modified in edit mode.

ShowHeader ShowHeader ShowHeader ShowHeader

Obtiene o establece un valor que indica si se representa el elemento de encabezado de un campo de control de datos.Gets or sets a value indicating whether the header item of a data control field is rendered.

(Inherited from DataControlField)
SortExpression SortExpression SortExpression SortExpression

Obtiene o establece una expresión de ordenación utilizada por un control de origen de datos para ordenar los datos.Gets or sets a sort expression that is used by a data source control to sort data.

(Inherited from DataControlField)
ValidateRequestMode ValidateRequestMode ValidateRequestMode ValidateRequestMode

Obtiene o establece un valor que especifica si el control valida la entrada de cliente.Gets or sets a value that specifies whether the control validates client input.

(Inherited from DataControlField)
ViewState ViewState ViewState 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.Gets a dictionary of state information that allows you to save and restore the view state of a DataControlField object across multiple requests for the same page.

(Inherited from DataControlField)
Visible Visible Visible Visible

Obtiene o establece un valor que indica si se representa un campo de control de datos.Gets or sets a value indicating whether a data control field is rendered.

(Inherited from DataControlField)

Métodos

CloneField() CloneField() CloneField() CloneField()

Crea una copia duplicada del objeto actual derivado de DataControlField.Creates a duplicate copy of the current DataControlField-derived object.

(Inherited from DataControlField)
CopyProperties(DataControlField) CopyProperties(DataControlField) CopyProperties(DataControlField) CopyProperties(DataControlField)

Copia las propiedades del objeto ImageField actual en el objeto especificado.Copies the properties of the current ImageField object to the specified object.

CreateField() CreateField() CreateField() CreateField()

Devuelve una nueva instancia de la clase ImageField.Returns a new instance of the ImageField class.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Inherited from Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean) ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean) ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean) ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)

El objeto IOrderedDictionary especificado se rellena con los valores del objeto DataControlFieldCell especificado.Fills the specified IOrderedDictionary object with the values from the specified DataControlFieldCell object.

FormatImageUrlValue(Object) FormatImageUrlValue(Object) FormatImageUrlValue(Object) FormatImageUrlValue(Object)

Aplica el formato especificado por la propiedad DataImageUrlFormatString a un valor de campo.Applies the format specified by the DataImageUrlFormatString property to a field value.

GetDesignTimeValue() GetDesignTimeValue() GetDesignTimeValue() GetDesignTimeValue()

Recupera el valor utilizado como valor de un campo al representar el objeto ImageField en un diseñador.Retrieves the value used for a field's value when rendering the ImageField object in a designer.

GetFormattedAlternateText(Control) GetFormattedAlternateText(Control) GetFormattedAlternateText(Control) GetFormattedAlternateText(Control)

Aplica el formato especificado por la propiedad DataAlternateTextFormatString al valor de texto alternativo incluido en el objeto Control especificado.Applies the format specified by the DataAlternateTextFormatString property to the alternate text value contained in the specified Control object.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Inherited from Object)
GetValue(Control, String, PropertyDescriptor) GetValue(Control, String, PropertyDescriptor) GetValue(Control, String, PropertyDescriptor) GetValue(Control, String, PropertyDescriptor)

Recupera el valor del campo especificado del control indicado.Retrieves the value of the specified field from the specified control.

Initialize(Boolean, Control) Initialize(Boolean, Control) Initialize(Boolean, Control) Initialize(Boolean, Control)

Inicializa el objeto ImageField.Initializes the ImageField object.

InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32) InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32) InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32) InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)

Inicializa el objeto DataControlFieldCell especificado con el tipo de celda, estado de fila e índice de fila indicados.Initializes the specified DataControlFieldCell object with the specified cell type, row state, and row index.

InitializeDataCell(DataControlFieldCell, DataControlRowState) InitializeDataCell(DataControlFieldCell, DataControlRowState) InitializeDataCell(DataControlFieldCell, DataControlRowState) InitializeDataCell(DataControlFieldCell, DataControlRowState)

Inicializa el objeto DataControlFieldCell especificado con el estado de fila indicado.Initializes the specified DataControlFieldCell object with the specified row state.

LoadViewState(Object) LoadViewState(Object) LoadViewState(Object) LoadViewState(Object)

Restaura la vista del origen de datos tal y como se guardó previamente.Restores the data source view's previously saved view state.

(Inherited from DataControlField)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

(Inherited from Object)
OnDataBindField(Object, EventArgs) OnDataBindField(Object, EventArgs) OnDataBindField(Object, EventArgs) OnDataBindField(Object, EventArgs)

Enlaza el valor de un campo al objeto ImageField.Binds the value of a field to the ImageField object.

OnFieldChanged() OnFieldChanged() OnFieldChanged() OnFieldChanged()

Genera el evento FieldChanged.Raises the FieldChanged event.

(Inherited from DataControlField)
SaveViewState() SaveViewState() SaveViewState() SaveViewState()

Guarda los cambios efectuados en el estado de vista de DataControlField desde el momento en que se devolvió la página al servidor.Saves the changes made to the DataControlField view state since the time the page was posted back to the server.

(Inherited from DataControlField)
ToString() ToString() ToString() ToString()

Devuelve una cadena que representa este objeto DataControlField.Returns a string that represents this DataControlField object.

(Inherited from DataControlField)
TrackViewState() TrackViewState() TrackViewState() 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.Causes the DataControlField object to track changes to its view state so they can be stored in the control's ViewState property and persisted across requests for the same page.

(Inherited from DataControlField)
ValidateSupportsCallback() ValidateSupportsCallback() ValidateSupportsCallback() ValidateSupportsCallback()

Determina si los controles incluidos en un objeto ImageField admiten devoluciones de llamada.Determines whether the controls contained in an ImageField object support callbacks.

Implementaciones de interfaz explícitas

IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object)

Restaura el estado de vista que se guardó previamente del campo de control de datos.Restores the data control field's previously saved view state.

(Inherited from DataControlField)
IStateManager.SaveViewState() IStateManager.SaveViewState() IStateManager.SaveViewState() 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.Saves the changes made to the DataControlField view state since the time the page was posted back to the server.

(Inherited from DataControlField)
IStateManager.TrackViewState() IStateManager.TrackViewState() IStateManager.TrackViewState() 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.Causes the DataControlField object to track changes to its view state so they can be stored in the control's ViewState property and persisted across requests for the same page.

(Inherited from DataControlField)

Se aplica a

Consulte también: