ImageField Classe
Definição
Representa um campo exibido como uma imagem em um controle associado a dados.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
- Herança
Exemplos
O exemplo a seguir demonstra como usar um ImageField objeto em um GridView controle para exibir uma imagem.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>
Comentários
A ImageField classe é usada por controles vinculados a dados (como GridView e DetailsView ) para exibir uma imagem para cada registro exibido.The ImageField class is used by data-bound controls (such as GridView and DetailsView) to display an image for each record displayed. O ImageField objeto é exibido de forma diferente, dependendo do controle vinculado a dados no qual ele é usado.The ImageField object is displayed differently depending on the data-bound control in which it is used. Por exemplo, o GridView controle exibe um ImageField objeto como uma coluna, enquanto o DetailsView controle o exibe como uma linha.For example, the GridView control displays an ImageField object as a column, while the DetailsView control displays it as a row.
Para exibir imagens, você deve associar um ImageField objeto a um campo de uma fonte de dados que contém a URL de uma imagem.To display images, you must bind an ImageField object to a field from a data source that contains the URL of an image. Isso é feito definindo a DataImageUrlField propriedade.This is accomplished by setting the DataImageUrlField property. O valor da URL pode ser formatado usando a DataImageUrlFormatString propriedade.The URL value can be formatted by using the DataImageUrlFormatString property. Cada imagem também pode ter um texto alternativo associado a ela.Each image can also have alternate text associated with it. Esse texto é exibido quando uma imagem não pode ser carregada ou não está disponível.This text is displayed when an image cannot be loaded, or is unavailable. Os navegadores que suportam o recurso de dicas de ferramenta também exibem esse texto como uma dica de ferramenta.Browsers that support the ToolTips feature also display this text as a ToolTip. Você pode especificar o texto alternativo para uma imagem exibida usando um dos seguintes métodos:You can specify the alternate text for a displayed image by using one of the following methods:
Use a AlternateText propriedade para especificar o texto alternativo que se aplica a todas as imagens.Use the AlternateText property to specify alternate text that applies to all images.
Use a DataAlternateTextField propriedade para associar um campo de uma fonte de dados à AlternateText propriedade de cada imagem.Use the DataAlternateTextField property to bind a field from a data source to the AlternateText property of each image. Isso permite que você tenha texto alternativo diferente para cada imagem exibida.This allows you to have different alternate text for each image displayed. Ao associar dados, opcionalmente, você pode formatar o texto alternativo usando a DataAlternateTextFormatString propriedade.When binding data, you can optionally format the alternate text by using the DataAlternateTextFormatString property.
Quando o valor da URL de uma imagem é null , uma imagem não pode ser exibida.When the URL value for an image is null, an image cannot be displayed. Você pode exibir uma imagem alternativa para null valores de campo definindo a NullImageUrl propriedade.You can display an alternate image for null field values by setting the NullImageUrl property. Em vez de uma imagem alternativa, você pode exibir texto alternativo definindo a NullDisplayText propriedade.Instead of an alternate image, you can display alternate text by setting the NullDisplayText property.
Por padrão, todos os campos declarados são exibidos em um controle vinculado a dados.By default, all declared fields are displayed in a data-bound control. Você pode ocultar um ImageField objeto em um controle vinculado a dados definindo a Visible propriedade como false .You can hide an ImageField object in a data-bound control by setting the Visible property to false.
Você pode personalizar as seções de cabeçalho e rodapé de um ImageField objeto.You can customize the header and footer sections of an ImageField object. Para exibir uma legenda na seção cabeçalho ou rodapé, defina as HeaderText Propriedades ou FooterText , respectivamente.To display a caption in the header or footer section, set the HeaderText or FooterText properties, respectively. Para exibir uma imagem na seção de cabeçalho em vez de texto, defina a HeaderImageUrl propriedade.To display an image in the header section instead of text, set the HeaderImageUrl property. A seção de cabeçalho pode ser ocultada no ImageField objeto definindo a ShowHeader propriedade como false .The header section can be hidden in the ImageField object by setting the ShowHeader property to false.
Observação
Alguns controles ligados a dados (como o GridView controle) podem mostrar ou ocultar apenas a seção de cabeçalho inteira do controle.Some data-bound controls (such as the GridView control) can show or hide only the entire header section of the control. Esses controles associados a dados não dão suporte à ShowHeader propriedade de um campo associado a dados individual.These data-bound controls do not support the ShowHeader property for an individual data-bound field. Para mostrar ou ocultar a seção de cabeçalho inteira de um controle de vinculação de dados, use a ShowHeader Propriedade do controle (se disponível).To show or hide the entire header section of a data-bound control, use the control's ShowHeader property (if available).
Você também pode personalizar a aparência do ImageField objeto (cor da fonte, cor do plano de fundo e assim por diante) definindo as propriedades de estilo para as diferentes partes do 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. A tabela a seguir lista as propriedades de estilo diferentes.The following table lists the different style properties.
| Propriedade de estiloStyle property | DescriçãoDescription |
|---|---|
| ControlStyle | As configurações de estilo para os controles de servidor Web filho do ImageField objeto.The style settings for the child Web server controls of the ImageField object. |
| FooterStyle | As configurações de estilo da seção de rodapé do ImageField objeto.The style settings for the footer section of the ImageField object. |
| HeaderStyle | As configurações de estilo da seção de cabeçalho do ImageField objeto.The style settings for the header section of the ImageField object. |
| ItemStyle | As configurações de estilo para os itens de dados no ImageField objeto.The style settings for the data items in the ImageField object. |
Construtores
| ImageField() |
Inicializa uma nova instância da classe ImageField.Initializes a new instance of the ImageField class. |
Campos
| ThisExpression |
Representa a expressão "this".Represents the "this" expression. |
Propriedades
| AccessibleHeaderText |
Obtém ou define o texto que é renderizado como o valor da propriedade |
| AlternateText |
Obtém ou define o texto alternativo exibido para uma imagem no objeto ImageField.Gets or sets the alternate text displayed for an image in the ImageField object. |
| Control |
Obtém uma referência ao controle de dados ao qual o objeto DataControlField está associado.Gets a reference to the data control that the DataControlField object is associated with. (Herdado de DataControlField) |
| ControlStyle |
Obtém o estilo de qualquer controle do servidor Web contido pelo objeto DataControlField.Gets the style of any Web server controls contained by the DataControlField object. (Herdado de DataControlField) |
| ConvertEmptyStringToNull |
Obtém ou define um valor que indica se valores da cadeia de caracteres vazia ("") são convertidos em |
| 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.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 |
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.Gets or sets the string that specifies the format in which the alternate text for each image in an ImageField object is rendered. |
| 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.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 |
Obtém ou define a cadeia de caracteres que especifica o formato no qual a URL de cada imagem em um objeto ImageField é renderizada.Gets or sets the string that specifies the format in which the URL for each image in an ImageField object is rendered. |
| DesignMode |
Obtém um valor que indica se um campo de controle de dados é atualmente exibido em um ambiente de tempo de design.Gets a value indicating whether a data control field is currently viewed in a design-time environment. (Herdado de DataControlField) |
| FooterStyle |
Obtém ou define o estilo do rodapé do campo de controle de dados.Gets or sets the style of the footer of the data control field. (Herdado de DataControlField) |
| FooterText |
Obtém ou define o texto exibido no item de rodapé de um campo de controle de dados.Gets or sets the text that is displayed in the footer item of a data control field. (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.Gets or sets the URL of an image that is displayed in the header item of a data control field. (Herdado de DataControlField) |
| HeaderStyle |
Obtém ou define o estilo do cabeçalho do campo de controle de dados.Gets or sets the style of the header of the data control field. (Herdado de DataControlField) |
| HeaderText |
Obtém ou define o texto exibido no item de cabeçalho de um campo de controle de dados.Gets or sets the text that is displayed in the header item of a data control field. (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.Gets a value indicating whether the DataControlField object is visible when its parent data-bound control is in insert mode. (Herdado de DataControlField) |
| IsTrackingViewState |
Obtém um valor que indica se o objeto DataControlField está salvando alterações no estado de exibição.Gets a value indicating whether the DataControlField object is saving changes to its view state. (Herdado de DataControlField) |
| ItemStyle |
Obtém o estilo de qualquer conteúdo baseado em texto exibido por um campo de controle de dados.Gets the style of any text-based content displayed by a data control field. (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 é |
| 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 é |
| 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.Gets or sets a value indicating whether the values of the field specified by the DataImageUrlField property can be modified in edit mode. |
| ShowHeader |
Obtém ou define um valor que indica se o item de cabeçalho de um campo de controle de dados é renderizado.Gets or sets a value indicating whether the header item of a data control field is rendered. (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.Gets or sets a sort expression that is used by a data source control to sort data. (Herdado de DataControlField) |
| ValidateRequestMode |
Obtém ou define um valor que especifica se o controle valida a entrada do cliente.Gets or sets a value that specifies whether the control validates client input. (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.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. (Herdado de DataControlField) |
| Visible |
Obtém ou define um valor que indica se um campo de controle de dados é renderizado.Gets or sets a value indicating whether a data control field is rendered. (Herdado de DataControlField) |
Métodos
| CloneField() |
Cria uma cópia duplicada do objeto atual derivado de DataControlField.Creates a duplicate copy of the current DataControlField-derived object. (Herdado de DataControlField) |
| CopyProperties(DataControlField) |
Copia as propriedades do objeto ImageField atual para o objeto especificado.Copies the properties of the current ImageField object to the specified object. |
| CreateField() |
Retorna uma nova instância da classe ImageField.Returns a new instance of the ImageField class. |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object. (Herdado de Object) |
| ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean) |
Preenche o objeto IOrderedDictionary especificado com os valores do objeto DataControlFieldCell especificado.Fills the specified IOrderedDictionary object with the values from the specified DataControlFieldCell object. |
| FormatImageUrlValue(Object) |
Aplica o formato especificado pela propriedade DataImageUrlFormatString a um valor de campo.Applies the format specified by the DataImageUrlFormatString property to a field value. |
| GetDesignTimeValue() |
Recupera o valor usado para um valor de campo ao renderizar o objeto de ImageField em um designer.Retrieves the value used for a field's value when rendering the ImageField object in a designer. |
| GetFormattedAlternateText(Control) |
Aplica o formato especificado pela propriedade DataAlternateTextFormatString ao valor de texto alternativo contido no objeto Control especificado.Applies the format specified by the DataAlternateTextFormatString property to the alternate text value contained in the specified Control object. |
| GetHashCode() |
Serve como a função de hash padrão.Serves as the default hash function. (Herdado de Object) |
| GetType() |
Obtém o Type da instância atual.Gets the Type of the current instance. (Herdado de Object) |
| GetValue(Control, String, PropertyDescriptor) |
Recupera o valor do campo especificado do controle especificado.Retrieves the value of the specified field from the specified control. |
| Initialize(Boolean, Control) |
Inicializa o objeto ImageField.Initializes the ImageField object. |
| 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.Initializes the specified DataControlFieldCell object with the specified cell type, row state, and row index. |
| InitializeDataCell(DataControlFieldCell, DataControlRowState) |
Inicializa o objeto DataControlFieldCell especificado com o estado de linha especificado.Initializes the specified DataControlFieldCell object with the specified row state. |
| LoadViewState(Object) |
Restaura o estado de exibição salvo anteriormente da exibição de fonte de dados.Restores the data source view's previously saved view state. (Herdado de DataControlField) |
| MemberwiseClone() |
Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object. (Herdado de Object) |
| OnDataBindField(Object, EventArgs) |
Associa o valor de um campo ao objeto de ImageField.Binds the value of a field to the ImageField object. |
| OnFieldChanged() |
Aciona o evento |
| 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.Saves the changes made to the DataControlField view state since the time the page was posted back to the server. (Herdado de DataControlField) |
| ToString() |
Retorna uma cadeia de caracteres que representa este objeto DataControlField.Returns a string that represents this DataControlField object. (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.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. (Herdado de DataControlField) |
| ValidateSupportsCallback() |
Determina se os controles contidos em um objeto ImageField dão suporte a retornos de chamada.Determines whether the controls contained in an ImageField object support callbacks. |
Implantações explícitas de interface
| IDataSourceViewSchemaAccessor.DataSourceViewSchema |
Obtém ou define o esquema associado a este objeto DataControlField.Gets or sets the schema associated with this DataControlField object. (Herdado de DataControlField) |
| IStateManager.IsTrackingViewState |
Obtém um valor que indica se o objeto DataControlField está salvando alterações no estado de exibição.Gets a value indicating whether the DataControlField object is saving changes to its view state. (Herdado de DataControlField) |
| IStateManager.LoadViewState(Object) |
Restaura o estado de exibição salvo anteriormente do campo de controle de dados.Restores the data control field's previously saved view state. (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.Saves the changes made to the DataControlField view state since the time the page was posted back to the server. (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.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. (Herdado de DataControlField) |