Partilhar via


ImageField Classe

Definição

Representa um campo exibido como uma imagem em um controle associado a dados.

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
Herança

Exemplos

O exemplo a seguir demonstra como usar um ImageField objeto em um GridView controle para exibir uma imagem.


<%@ 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>

Comentários

A ImageField classe é usada por controles associados a dados (como GridView e DetailsView) para exibir uma imagem para cada registro exibido. O ImageField objeto é exibido de forma diferente dependendo do controle associado a dados no qual ele é usado. Por exemplo, o GridView controle exibe um ImageField objeto como uma coluna, enquanto o controle o DetailsView exibe como uma linha.

Para exibir imagens, você deve associar um ImageField objeto a um campo de uma fonte de dados que contenha a URL de uma imagem. Isso é feito definindo a DataImageUrlField propriedade. O valor da URL pode ser formatado usando a DataImageUrlFormatString propriedade. Cada imagem também pode ter texto alternativo associado a ela. Esse texto é exibido quando uma imagem não pode ser carregada ou não está disponível. Os navegadores que dão suporte ao recurso Dicas de Ferramenta também exibem esse texto como uma Dica de Ferramenta. Você pode especificar o texto alternativo para uma imagem exibida usando um dos seguintes métodos:

  • Use a AlternateText propriedade para especificar texto alternativo que se aplica a todas as imagens.

  • Use a DataAlternateTextField propriedade para associar um campo de uma fonte de dados à AlternateText propriedade de cada imagem. Isso permite que você tenha texto alternativo diferente para cada imagem exibida. Ao associar dados, opcionalmente, você pode formatar o texto alternativo usando a DataAlternateTextFormatString propriedade.

Quando o valor da URL de uma imagem é null, uma imagem não pode ser exibida. Você pode exibir uma imagem alternativa para null valores de campo definindo a NullImageUrl propriedade. Em vez de uma imagem alternativa, você pode exibir texto alternativo definindo a NullDisplayText propriedade.

Por padrão, todos os campos declarados são exibidos em um controle associado a dados. Você pode ocultar um ImageField objeto em um controle associado a dados definindo a Visible propriedade como false.

Você pode personalizar as seções de cabeçalho e rodapé de um ImageField objeto. Para exibir uma legenda na seção cabeçalho ou rodapé, defina as propriedades ou FooterText as HeaderText propriedades, respectivamente. Para exibir uma imagem na seção de cabeçalho em vez de texto, defina a HeaderImageUrl propriedade. A seção de cabeçalho pode ser oculta no ImageField objeto definindo a ShowHeader propriedade como false.

Observação

Alguns controles associados a dados (como o GridView controle) podem mostrar ou ocultar apenas toda a seção de cabeçalho do controle. Esses controles associados a dados não dão suporte à ShowHeader propriedade para um campo individual associado a dados. Para mostrar ou ocultar toda a seção de cabeçalho de um controle associado a dados, use a propriedade do ShowHeader controle (se disponível).

Você também pode personalizar a aparência do objeto (cor da ImageField fonte, cor da tela de fundo e assim por diante) definindo as propriedades de estilo para as diferentes partes do campo. A tabela a seguir lista as diferentes propriedades de estilo.

Propriedade Style Descrição
ControlStyle As configurações de estilo para os controles filho do servidor Web do ImageField objeto.
FooterStyle As configurações de estilo para a seção de rodapé do ImageField objeto.
HeaderStyle As configurações de estilo para a seção de cabeçalho do ImageField objeto.
ItemStyle As configurações de estilo para os itens de dados no ImageField objeto.

Construtores

ImageField()

Inicializa uma nova instância da classe ImageField.

Campos

ThisExpression

Representa a expressão "this".

Propriedades

AccessibleHeaderText

Obtém ou define o texto que é renderizado como o valor da propriedade AbbreviatedText em alguns controles.

(Herdado de DataControlField)
AlternateText

Obtém ou define o texto alternativo exibido para uma imagem no objeto ImageField.

Control

Obtém uma referência ao controle de dados ao qual o objeto DataControlField está associado.

(Herdado de DataControlField)
ControlStyle

Obtém o estilo de qualquer controle do servidor Web contido pelo objeto DataControlField.

(Herdado de DataControlField)
ConvertEmptyStringToNull

Obtém ou define um valor que indica se valores da cadeia de caracteres vazia ("") são convertidos em null quando os valores de campo são retornados da fonte de dados.

DataAlternateTextField

Obtém ou define o nome do campo da fonte de dados que contém os valores a serem associados à propriedade AlternateText de cada imagem em um objeto ImageField.

DataAlternateTextFormatString

Obtém ou define a cadeia de caracteres que especifica o formato no qual o texto alternativo para cada imagem em um objeto ImageField é renderizado.

DataImageUrlField

Obtém ou define o nome do campo da fonte de dados que contém os valores a serem associados à propriedade ImageUrl de cada imagem em um objeto ImageField.

DataImageUrlFormatString

Obtém ou define a cadeia de caracteres que especifica o formato no qual a URL de cada imagem em um objeto ImageField é renderizada.

DesignMode

Obtém um valor que indica se um campo de controle de dados é atualmente exibido em um ambiente de tempo de design.

(Herdado de DataControlField)
FooterStyle

Obtém ou define o estilo do rodapé do campo de controle de dados.

(Herdado de DataControlField)
FooterText

Obtém ou define o texto exibido no item de rodapé de um campo de controle de dados.

(Herdado de DataControlField)
HeaderImageUrl

Obtém ou define a URL de uma imagem exibida no item de cabeçalho de um campo de controle de dados.

(Herdado de DataControlField)
HeaderStyle

Obtém ou define o estilo do cabeçalho do campo de controle de dados.

(Herdado de DataControlField)
HeaderText

Obtém ou define o texto exibido no item de cabeçalho de um campo de controle de dados.

(Herdado de DataControlField)
InsertVisible

Obtém um valor que indica se o objeto DataControlField fica visível quando o controle associado a dados pai está no modo de inserção.

(Herdado de DataControlField)
IsTrackingViewState

Obtém um valor que indica se o objeto DataControlField está salvando alterações no estado de exibição.

(Herdado de DataControlField)
ItemStyle

Obtém o estilo de qualquer conteúdo baseado em texto exibido por um campo de controle de dados.

(Herdado de DataControlField)
NullDisplayText

Obtém ou define o texto a ser exibido em um objeto ImageField quando o valor do campo especificado pela propriedade DataImageUrlField é null.

NullImageUrl

Obtém ou define a URL para uma imagem alternativa exibida em um objeto ImageField quando o valor do campo especificado pela propriedade DataImageUrlField é null.

ReadOnly

Obtém ou define um valor que indica se os valores do campo especificados pela propriedade DataImageUrlField podem ser modificados no modo de edição.

ShowHeader

Obtém ou define um valor que indica se o item de cabeçalho de um campo de controle de dados é renderizado.

(Herdado de DataControlField)
SortExpression

Obtém ou define uma expressão de classificação que é usada por um controle de fonte de dados para classificar os dados.

(Herdado de DataControlField)
ValidateRequestMode

Obtém ou define um valor que especifica se o controle valida a entrada do cliente.

(Herdado de DataControlField)
ViewState

Obtém um dicionário de informações de estado que permite salvar e restaurar o estado de exibição de um objeto DataControlField em várias solicitações da mesma página.

(Herdado de DataControlField)
Visible

Obtém ou define um valor que indica se um campo de controle de dados é renderizado.

(Herdado de DataControlField)

Métodos

CloneField()

Cria uma cópia duplicada do objeto atual derivado de DataControlField.

(Herdado de DataControlField)
CopyProperties(DataControlField)

Copia as propriedades do objeto ImageField atual para o objeto especificado.

CreateField()

Retorna uma nova instância da classe ImageField.

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)

Preenche o objeto IOrderedDictionary especificado com os valores do objeto DataControlFieldCell especificado.

FormatImageUrlValue(Object)

Aplica o formato especificado pela propriedade DataImageUrlFormatString a um valor de campo.

GetDesignTimeValue()

Recupera o valor usado para um valor de campo ao renderizar o objeto de ImageField em um designer.

GetFormattedAlternateText(Control)

Aplica o formato especificado pela propriedade DataAlternateTextFormatString ao valor de texto alternativo contido no objeto Control especificado.

GetHashCode()

Serve como a função de hash padrão.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
GetValue(Control, String, PropertyDescriptor)

Recupera o valor do campo especificado do controle especificado.

Initialize(Boolean, Control)

Inicializa o objeto ImageField.

InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)

Inicializa o objeto DataControlFieldCell especificado com o tipo de célula, o estado de linha e o índice de linha especificados.

InitializeDataCell(DataControlFieldCell, DataControlRowState)

Inicializa o objeto DataControlFieldCell especificado com o estado de linha especificado.

LoadViewState(Object)

Restaura o estado de exibição salvo anteriormente da exibição de fonte de dados.

(Herdado de DataControlField)
MemberwiseClone()

Cria uma cópia superficial do Object atual.

(Herdado de Object)
OnDataBindField(Object, EventArgs)

Associa o valor de um campo ao objeto de ImageField.

OnFieldChanged()

Aciona o evento FieldChanged.

(Herdado de DataControlField)
SaveViewState()

Salva as alterações feitas no estado de exibição DataControlField desde a hora em que a página foi postada de volta no servidor.

(Herdado de DataControlField)
ToString()

Retorna uma cadeia de caracteres que representa este objeto DataControlField.

(Herdado de DataControlField)
TrackViewState()

Faz com que o objeto DataControlField controle as alterações em seu estado de exibição, de modo que elas possam ser armazenadas na propriedade ViewState do controle e persistidas entre solicitações para a mesma página.

(Herdado de DataControlField)
ValidateSupportsCallback()

Determina se os controles contidos em um objeto ImageField dão suporte a retornos de chamada.

Implantações explícitas de interface

IDataSourceViewSchemaAccessor.DataSourceViewSchema

Obtém ou define o esquema associado a este objeto DataControlField.

(Herdado de DataControlField)
IStateManager.IsTrackingViewState

Obtém um valor que indica se o objeto DataControlField está salvando alterações no estado de exibição.

(Herdado de DataControlField)
IStateManager.LoadViewState(Object)

Restaura o estado de exibição salvo anteriormente do campo de controle de dados.

(Herdado de DataControlField)
IStateManager.SaveViewState()

Salva as alterações feitas no estado de exibição DataControlField desde a hora em que a página foi postada de volta no servidor.

(Herdado de DataControlField)
IStateManager.TrackViewState()

Faz com que o objeto DataControlField controle as alterações em seu estado de exibição, de modo que elas possam ser armazenadas na propriedade ViewState do controle e persistidas entre solicitações para a mesma página.

(Herdado de DataControlField)

Aplica-se a

Confira também