ImageField Classe

Referência

Definição

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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

DataControlField
ImageField

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