ImageField Classe
Definição
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::DataControlFieldpublic class ImageField : System.Web.UI.WebControls.DataControlFieldtype ImageField = class
inherit DataControlFieldPublic 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 um 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 o HeaderText cabeçalho, 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 propriedades de estilo diferentes.
| Propriedade Style | Descrição |
|---|---|
| ControlStyle | As configurações de estilo para os controles do servidor Web filho do ImageField objeto. |
| FooterStyle | As configurações de estilo para a seção 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
| Nome | Description |
|---|---|
| ImageField() |
Inicializa uma nova instância da classe ImageField. |
Campos
| Nome | Description |
|---|---|
| ThisExpression |
Representa a expressão "this". |
Propriedades
| Nome | Description |
|---|---|
| AccessibleHeaderText |
Obtém ou define o texto renderizado como o valor da |
| AlternateText |
Obtém ou define o texto alternativo exibido para uma imagem no ImageField objeto. |
| Control |
Obtém uma referência ao controle de dados ao qual o DataControlField objeto está associado. (Herdado de DataControlField) |
| ControlStyle |
Obtém o estilo de todos os controles de servidor Web contidos pelo DataControlField objeto. (Herdado de DataControlField) |
| ConvertEmptyStringToNull |
Obtém ou define um valor que indica se os valores de cadeia de caracteres vazias ("") são convertidos |
| DataAlternateTextField |
Obtém ou define o nome do campo da fonte de dados que contém os valores a serem associados à AlternateText propriedade de cada imagem em um ImageField objeto. |
| DataAlternateTextFormatString |
Obtém ou define a cadeia de caracteres que especifica o formato no qual o texto alternativo para cada imagem em um ImageField objeto é renderizado. |
| DataImageUrlField |
Obtém ou define o nome do campo da fonte de dados que contém os valores a serem associados à ImageUrl propriedade de cada imagem em um ImageField objeto. |
| DataImageUrlFormatString |
Obtém ou define a cadeia de caracteres que especifica o formato no qual a URL de cada imagem em um ImageField objeto é renderizada. |
| DesignMode |
Obtém um valor que indica se um campo de controle de dados é exibido no momento 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 DataControlField objeto está visível quando seu controle associado a dados pai está no modo de inserção. (Herdado de DataControlField) |
| IsTrackingViewState |
Obtém um valor que indica se o DataControlField objeto está salvando alterações em seu 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 ImageField objeto quando o valor do campo especificado pela DataImageUrlField propriedade é |
| NullImageUrl |
Obtém ou define a URL como uma imagem alternativa exibida em um ImageField objeto quando o valor do campo especificado pela DataImageUrlField propriedade é |
| ReadOnly |
Obtém ou define um valor que indica se os valores do campo especificado pela DataImageUrlField propriedade 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 usada por um controle de fonte de dados para classificar 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 DataControlField objeto em várias solicitações para a 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
| Nome | Description |
|---|---|
| CloneField() |
Cria uma cópia duplicada do objeto derivado atual DataControlField. (Herdado de DataControlField) |
| CopyProperties(DataControlField) |
Copia as propriedades do objeto atual ImageField para o objeto especificado. |
| CreateField() |
Retorna 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 propriedade a DataImageUrlFormatString um valor de campo. |
| GetDesignTimeValue() |
Recupera o valor usado para o valor de um campo ao renderizar o ImageField objeto em um designer. |
| GetFormattedAlternateText(Control) |
Aplica o formato especificado pela DataAlternateTextFormatString propriedade ao valor de texto alternativo contido no objeto especificado Control . |
| 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 especificado DataControlFieldCell com o tipo de célula, o estado da linha e o índice de linha especificados. |
| InitializeDataCell(DataControlFieldCell, DataControlRowState) |
Inicializa o objeto especificado DataControlFieldCell com o estado da linha especificado. |
| LoadViewState(Object) |
Restaura o estado de exibição salvo anteriormente da exibição da fonte de dados. (Herdado de DataControlField) |
| MemberwiseClone() |
Cria uma cópia superficial do Objectatual. (Herdado de Object) |
| OnDataBindField(Object, EventArgs) |
Associa o valor de um campo ao ImageField objeto. |
| OnFieldChanged() |
Aciona o evento |
| SaveViewState() |
Salva as alterações feitas no estado de exibição DataControlField desde o momento em que a página foi postada de volta no servidor. (Herdado de DataControlField) |
| ToString() |
Retorna uma cadeia de caracteres que representa esse DataControlField objeto. (Herdado de DataControlField) |
| TrackViewState() |
Faz com que o DataControlField objeto acompanhe as alterações em seu estado de exibição para que elas possam ser armazenadas na propriedade do ViewState controle e mantidas entre solicitações para a mesma página. (Herdado de DataControlField) |
| ValidateSupportsCallback() |
Determina se os controles contidos em um objeto dão ImageField suporte a retornos de chamada. |
Implantações explícitas de interface
| Nome | Description |
|---|---|
| IDataSourceViewSchemaAccessor.DataSourceViewSchema |
Obtém ou define o esquema associado a esse DataControlField objeto. (Herdado de DataControlField) |
| IStateManager.IsTrackingViewState |
Obtém um valor que indica se o DataControlField objeto está salvando alterações em seu 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 o momento em que a página foi postada de volta no servidor. (Herdado de DataControlField) |
| IStateManager.TrackViewState() |
Faz com que o DataControlField objeto acompanhe as alterações em seu estado de exibição para que elas possam ser armazenadas na propriedade do ViewState controle e mantidas entre solicitações para a mesma página. (Herdado de DataControlField) |
