ImageField Classe

Definição

Espaço de Nomes:: System.Web.UI.WebControls

Assemblagem:: System.Web.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Representa um campo que é exibido como uma imagem num controlo ligado 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 seguinte demonstra como usar um ImageField objeto num GridView controlo para mostrar 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>

Observações

A ImageField classe é usada por controlos ligados a dados (como GridView e DetailsView) para mostrar uma imagem para cada registo exibido. O ImageField objeto é apresentado de forma diferente consoante o controlo limitado por dados em que é utilizado. Por exemplo, o controlo GridView mostra um ImageField objeto como uma coluna, enquanto o controlo DetailsView o apresenta como uma linha.

Para mostrar imagens, deve vincular um ImageField objeto a um campo de uma fonte de dados que contenha a URL de uma imagem. Isto é conseguido ao definir a DataImageUrlField propriedade. O valor da URL pode ser formatado usando a DataImageUrlFormatString propriedade. Cada imagem pode também ter texto alternativo associado. Este texto é exibido quando uma imagem não pode ser carregada ou não está disponível. Navegadores que suportam a funcionalidade ToolTips também exibem este texto como uma ToolTip. Pode especificar o texto alternativo para uma imagem apresentada usando um dos seguintes métodos:

Use a AlternateText propriedade para especificar texto alternativo que se aplique a todas as imagens.
Use a DataAlternateTextField propriedade para associar um campo de uma fonte de dados à AlternateText propriedade de cada imagem. Isto permite ter texto alternativo diferente para cada imagem apresentada. Ao associar dados, pode, opcionalmente, formatar o texto alternativo usando a DataAlternateTextFormatString propriedade.

Quando o valor URL de uma imagem é null, uma imagem não pode ser exibida. Pode mostrar uma imagem alternativa para null os valores dos campos definindo a NullImageUrl propriedade. Em vez de uma imagem alternativa, pode mostrar texto alternativo definindo a NullDisplayText propriedade.

Por defeito, todos os campos declarados são exibidos num controlo ligado a dados. Pode esconder um ImageField objeto num controlo data-bound definindo a Visible propriedade para false.

Podes personalizar as secções do cabeçalho e rodapé de um ImageField objeto. Para mostrar uma legenda na secção do cabeçalho ou rodapé, defina as HeaderText propriedades ou FooterText , respetivamente. Para mostrar uma imagem na secção do cabeçalho em vez de texto, defina a HeaderImageUrl propriedade. A secção do cabeçalho pode ser ocultada no ImageField objeto ao definir a ShowHeader propriedade para false.

Note

Alguns controlos ligados a dados (como o controlo GridView ) podem mostrar ou ocultar apenas toda a secção do cabeçalho do controlo. Estes controlos ligados a dados não suportam a ShowHeader propriedade para um campo ligado a dados individual. Para mostrar ou ocultar toda a secção do cabeçalho de um controlo data-bound, use a propriedade do ShowHeader controlo (se disponível).

Também pode personalizar a aparência do ImageField objeto (cor da fonte, cor de fundo, etc.) definindo as propriedades de estilo para as diferentes partes do campo. A tabela seguinte lista as diferentes propriedades de estilo.

Propriedade de estilo	Description
ControlStyle	As definições de estilo do servidor Web filho controlam o ImageField objeto.
FooterStyle	As definições de estilo para a secção do rodapé do ImageField objeto.
HeaderStyle	As definições de estilo para a secção do cabeçalho do ImageField objeto.
ItemStyle	As definições de estilo para os itens de dados no ImageField objeto.

Construtores

Name	Description
ImageField()	Inicializa uma nova instância da ImageField classe.

Campos

Name	Description
ThisExpression	Representa a expressão "isto".

Propriedades

Name	Description
AccessibleHeaderText	Recebe ou define texto que é renderizado como valor de `AbbreviatedText` propriedade em alguns controlos. (Herdado de DataControlField)
AlternateText	Obtém ou define o texto alternativo apresentado para uma imagem no ImageField objeto.
Control	Obtém uma referência ao controlo de dados ao qual o DataControlField objeto está associado. (Herdado de DataControlField)
ControlStyle	Obtém o estilo de quaisquer controlos de servidor Web contidos pelo DataControlField objeto. (Herdado de DataControlField)
ConvertEmptyStringToNull	Recebe ou define um valor que indica se os valores de string vazios ("") são convertidos quando `null` os valores do campo são devolvidos da fonte de dados.
DataAlternateTextField	Obtém ou define o nome do campo a partir da fonte de dados que contém os valores a atribuir à AlternateText propriedade de cada imagem num ImageField objeto.
DataAlternateTextFormatString	Obtém ou define a cadeia que especifica o formato em que o texto alternativo de cada imagem num ImageField objeto é renderizado.
DataImageUrlField	Obtém ou define o nome do campo a partir da fonte de dados que contém os valores a atribuir à ImageUrl propriedade de cada imagem num ImageField objeto.
DataImageUrlFormatString	Obtém ou define a cadeia que especifica o formato em que a URL de cada imagem num ImageField objeto é renderizada.
DesignMode	Obtém um valor que indica se um campo de controlo de dados está atualmente visualizado num ambiente em tempo de design. (Herdado de DataControlField)
FooterStyle	Obtém ou define o estilo do rodapé do campo de controlo de dados. (Herdado de DataControlField)
FooterText	Recebe ou define o texto que é exibido no elemento de rodapé de um campo de controlo de dados. (Herdado de DataControlField)
HeaderImageUrl	Obtém ou define a URL de uma imagem que é exibida no elemento do cabeçalho de um campo de controlo de dados. (Herdado de DataControlField)
HeaderStyle	Obtém ou define o estilo do cabeçalho do campo de controlo de dados. (Herdado de DataControlField)
HeaderText	Obtém ou define o texto que é exibido no elemento do cabeçalho de um campo de controlo de dados. (Herdado de DataControlField)
InsertVisible	Recebe um valor que indica se o DataControlField objeto é visível quando o controlo de dados do pai está em modo de inserção. (Herdado de DataControlField)
IsTrackingViewState	Recebe um valor que indica se o DataControlField objeto está a guardar alterações ao seu estado de visualização. (Herdado de DataControlField)
ItemStyle	Obtém o estilo de qualquer conteúdo baseado em texto apresentado por um campo de controlo de dados. (Herdado de DataControlField)
NullDisplayText	Obtém ou define o texto para ser exibido num ImageField objeto quando o valor do campo especificado pela DataImageUrlField propriedade é `null`.
NullImageUrl	Obtém ou define a URL para uma imagem alternativa exibida num ImageField objeto quando o valor do campo especificado pela DataImageUrlField propriedade é `null`.
ReadOnly	Recebe ou define um valor que indica se os valores do campo especificados pela DataImageUrlField propriedade podem ser modificados em modo de edição.
ShowHeader	Recebe ou define um valor que indica se o elemento do cabeçalho de um campo de controlo de dados é renderizado. (Herdado de DataControlField)
SortExpression	Obtém ou define uma expressão de ordenação que é usada por um controlo de fonte de dados para ordenar dados. (Herdado de DataControlField)
ValidateRequestMode	Recebe ou define um valor que especifica se o controlo valida a entrada do cliente. (Herdado de DataControlField)
ViewState	Obtém um dicionário de informação de estado que permite guardar e restaurar o estado de visualização de um DataControlField objeto através de múltiplos pedidos para a mesma página. (Herdado de DataControlField)
Visible	Recebe ou define um valor que indica se um campo de controlo de dados é renderizado. (Herdado de DataControlField)

Métodos

Name	Description
CloneField()	Cria uma cópia duplicada do objeto derivado atualmente DataControlField. (Herdado de DataControlField)
CopyProperties(DataControlField)	Copia as propriedades do objeto atual ImageField para o objeto especificado.
CreateField()	Devolve uma nova instância da ImageField classe.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)	Preenche o objeto especificado IOrderedDictionary com os valores do objeto especificado DataControlFieldCell .
FormatImageUrlValue(Object)	Aplica o formato especificado pela DataImageUrlFormatString propriedade a um valor de campo.
GetDesignTimeValue()	Recupera o valor usado para o valor de um campo ao renderizar o ImageField objeto num designer.
GetFormattedAlternateText(Control)	Aplica o formato especificado pela DataAlternateTextFormatString propriedade ao valor de texto alternativo contido no objeto especificado Control .
GetHashCode()	Serve como função de hash predefinida. (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 controlo especificado.
Initialize(Boolean, Control)	Inicializa o objeto ImageField.
InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)	Inicializa o objeto especificado DataControlFieldCell com o tipo de célula, estado de linha e índice de linha especificados.
InitializeDataCell(DataControlFieldCell, DataControlRowState)	Inicializa o objeto especificado DataControlFieldCell com o estado da linha especificado.
LoadViewState(Object)	Restaura o estado da vista de fonte de dados anteriormente guardada. (Herdado de DataControlField)
MemberwiseClone()	Cria uma cópia superficial do atual Object. (Herdado de Object)
OnDataBindField(Object, EventArgs)	Vincula o valor de um campo ao ImageField objeto.
OnFieldChanged()	Eleva o `FieldChanged` evento. (Herdado de DataControlField)
SaveViewState()	Guarda as alterações feitas ao DataControlField estado de visualização desde o momento em que a página foi publicada de volta no servidor. (Herdado de DataControlField)
ToString()	Devolve uma cadeia que representa este DataControlField objeto. (Herdado de DataControlField)
TrackViewState()	Faz com que o DataControlField objeto acompanhe alterações ao estado da visualização para que possam ser armazenadas na propriedade do ViewState controlo e persistirem entre pedidos para a mesma página. (Herdado de DataControlField)
ValidateSupportsCallback()	Determina se os controlos contidos num ImageField objeto suportam callbacks.

Implementações de Interface Explícita

Name	Description
IDataSourceViewSchemaAccessor.DataSourceViewSchema	Obtém ou define o esquema associado a este DataControlField objeto. (Herdado de DataControlField)
IStateManager.IsTrackingViewState	Recebe um valor que indica se o DataControlField objeto está a guardar alterações ao seu estado de visualização. (Herdado de DataControlField)
IStateManager.LoadViewState(Object)	Restaura o estado de visualização previamente guardado do campo de controlo de dados. (Herdado de DataControlField)
IStateManager.SaveViewState()	Guarda as alterações feitas ao DataControlField estado de visualização desde o momento em que a página foi publicada de volta no servidor. (Herdado de DataControlField)
IStateManager.TrackViewState()	Faz com que o DataControlField objeto acompanhe alterações ao estado da visualização para que possam ser armazenadas na propriedade do ViewState controlo e persistirem entre pedidos para a mesma página. (Herdado de DataControlField)

Aplica-se a

Ver também

Comentários

Esta página foi útil?