Exportar (0) Imprimir
Expandir Tudo
Este artigo foi traduzido por máquina. Coloque o ponteiro do mouse sobre as frases do artigo para ver o texto original. Mais informações.
Tradução
Original

Classe ImageField

Representa um campo que é exibido como uma imagem em um controle ligado a dados.

Namespace:  System.Web.UI.WebControls
Assembly:  System.Web (em System.Web.dll)

public class ImageField : DataControlField

O tipo ImageField expõe os membros a seguir.

  NomeDescrição
Método públicoImageFieldInicializa uma nova instância da classe ImageField.
Superior

  NomeDescrição
Propriedade públicaAccessibleHeaderTextObtém ou define o texto que é processado como o AbbreviatedText o valor da propriedade em alguns controles. (Herdado de DataControlField.)
Propriedade públicaAlternateTextObtém ou define o texto alternativo exibido para uma imagem na ImageField objeto.
Propriedade protegidaControlObtém uma referência ao controle de dados que o DataControlField objeto é associado. (Herdado de DataControlField.)
Propriedade públicaControlStyleObtém o estilo de quaisquer controles de servidor Web contido pelo DataControlField objeto. (Herdado de DataControlField.)
Propriedade públicaConvertEmptyStringToNullObtém ou define um valor indicando se a cadeia de caracteres vazia ("") valores são convertidos em null quando os valores de campo são retornados da fonte de dados.
Propriedade públicaDataAlternateTextFieldObtém ou define o nome do campo da fonte de dados que contém os valores para ligar para o AlternateText propriedade de cada imagem em um ImageField objeto.
Propriedade públicaDataAlternateTextFormatStringObtém ou define a seqüência de caracteres que especifica o formato no qual o texto alternativo para cada imagem em um ImageField objeto é processado.
Propriedade públicaDataImageUrlFieldObtém ou define o nome do campo da fonte de dados que contém os valores para ligar para o ImageUrl propriedade de cada imagem em um ImageField objeto.
Propriedade públicaDataImageUrlFormatStringObtém ou define a seqüência de caracteres que especifica o formato no qual a URL para cada imagem em um ImageField objeto é processado.
Propriedade protegidaDesignModeObtém um valor que indica se um campo de controle de dados atualmente é exibido em um ambiente de tempo de design. (Herdado de DataControlField.)
Propriedade públicaFooterStyleObtém ou define o estilo do rodapé do campo de controle de dados. (Herdado de DataControlField.)
Propriedade públicaFooterTextObtém ou define o texto que é exibido no item de rodapé de um campo de controle de dados. (Herdado de DataControlField.)
Propriedade públicaHeaderImageUrlObtém ou define o URL de uma imagem que é exibida no item de cabeçalho de um campo de controle de dados. (Herdado de DataControlField.)
Propriedade públicaHeaderStyleObtém ou define o estilo do cabeçalho do campo de controle de dados. (Herdado de DataControlField.)
Propriedade públicaHeaderTextObtém ou define o texto que é exibido no item de cabeçalho de um campo de controle de dados. (Herdado de DataControlField.)
Propriedade públicaInsertVisibleObtém um valor indicando se a DataControlField objeto estará visível quando o controle ligado a dados pai está no modo de inserção. (Herdado de DataControlField.)
Propriedade protegidaIsTrackingViewStateObtém um valor indicando se a DataControlField objeto está salvando as alterações ao seu estado de exibição. (Herdado de DataControlField.)
Propriedade públicaItemStyleObtém o estilo de qualquer conteúdo baseado em texto exibido por um campo de controle de dados. (Herdado de DataControlField.)
Propriedade públicaNullDisplayTextObtém ou define o texto a ser exibido em um ImageField de objeto quando o valor do campo especificado pelo DataImageUrlField propriedade é null.
Propriedade públicaNullImageUrlObtém ou define o URL para uma imagem alternativa exibida em um ImageField de objeto quando o valor do campo especificado pelo DataImageUrlField propriedade é null.
Propriedade públicaReadOnlyObtém ou define um valor que indica se os valores do campo especificado pelo DataImageUrlField propriedade pode ser modificada no modo de edição.
Propriedade públicaShowHeaderObtém ou define um valor indicando se o item de cabeçalho de um campo de dados de controle é processado. (Herdado de DataControlField.)
Propriedade públicaSortExpressionObté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.)
Propriedade protegidaValidateRequestModeObtém ou define um valor que especifica se o controle valida a entrada do cliente. (Herdado de DataControlField.)
Propriedade protegidaViewStateObtém um dicionário de informações de estado que permite que você salvar e restaurar o estado de exibição de um DataControlField objeto nas várias solicitações para a mesma página. (Herdado de DataControlField.)
Propriedade públicaVisibleObtém ou define um valor indicando se um campo de dados de controle é processado. (Herdado de DataControlField.)
Superior

  NomeDescrição
Método protegidoCloneFieldInfraestrutura. Cria uma cópia duplicada do atual DataControlField-derivado do objeto. (Herdado de DataControlField.)
Método protegidoCopyPropertiesCopia as propriedades do atual ImageField o objeto ao objeto especificado. (Substitui DataControlField.CopyProperties(DataControlField).)
Método protegidoCreateFieldRetorna uma nova instância do ImageField classe. (Substitui DataControlField.CreateField().)
Método públicoEquals(Object) Verifica se o objeto especificado é igual ao objeto atual. (Herdado de Object.)
Método públicoExtractValuesFromCellPreenche o especificado IOrderedDictionary o objeto com os valores do especificado DataControlFieldCell objeto. (Substitui DataControlField.ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean).)
Método protegidoFinalize Permite um objeto tentar liberar recursos e executar outras operações de limpeza antes que ele seja recuperado pela coleta de lixo. (Herdado de Object.)
Método protegidoFormatImageUrlValueAplica o formato especificado pelo DataImageUrlFormatString propriedade para um valor de campo.
Método protegidoGetDesignTimeValueRecupera o valor usado para o valor de um campo ao renderizar o ImageField o objeto em um designer.
Método protegidoGetFormattedAlternateTextAplica o formato especificado pelo DataAlternateTextFormatString propriedade para o valor de texto alternativo, contido no especificado Control objeto.
Método públicoGetHashCodeServe como a função de hash padrão. (Herdado de Object.)
Método públicoGetType Obtém o Type da instância atual. (Herdado de Object.)
Método protegidoGetValueRecupera o valor do campo especificado do controle especificado.
Método públicoInitializeInicializa o ImageField objeto. (Substitui DataControlField.Initialize(Boolean, Control).)
Método públicoInitializeCellInicializa o especificado DataControlFieldCell o objeto com o tipo de célula especificada, o estado de linha e o índice da linha. (Substitui DataControlField.InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32).)
Método protegidoInitializeDataCellInicializa o especificado DataControlFieldCell o objeto com o estado da linha especificada.
Método protegidoLoadViewStateRestaura a exibição de fonte de dados salvo anteriormente estado de exibição. (Herdado de DataControlField.)
Método protegidoMemberwiseCloneCria uma cópia superficial do Object atual. (Herdado de Object.)
Método protegidoOnDataBindFieldVincula o valor de um campo para o ImageField objeto.
Método protegidoOnFieldChangedGera o evento FieldChanged. (Herdado de DataControlField.)
Método protegidoSaveViewStateSalva as alterações feitas a DataControlField estado de exibição desde o momento em que a página foi postada de volta para o servidor. (Herdado de DataControlField.)
Método públicoToStringRetorna um string que representa esse DataControlField objeto. (Herdado de DataControlField.)
Método protegidoTrackViewStateFaz com que o DataControlField o objeto para controlar alterações ao seu estado de exibição para que eles podem ser armazenados no controle de ViewState propriedade e persistentes entre as solicitações para a mesma página. (Herdado de DataControlField.)
Método públicoValidateSupportsCallbackDetermina se os controles contidos em um ImageField suporte a retornos de chamada de objeto. (Substitui DataControlField.ValidateSupportsCallback().)
Superior

  NomeDescrição
Campo públicoMembro estáticoThisExpressionRepresenta a expressão "this".
Superior

  NomeDescrição
Implementação explícita da interfacePropriedade particularIDataSourceViewSchemaAccessor.DataSourceViewSchemaInfraestrutura. Obtém ou define o esquema associado a isso DataControlField objeto. (Herdado de DataControlField.)
Implementação explícita da interfacePropriedade particularIStateManager.IsTrackingViewStateInfraestrutura. Obtém um valor indicando se a DataControlField objeto está salvando as alterações ao seu estado de exibição. (Herdado de DataControlField.)
Implementação explícita da interfaceMétodo particularIStateManager.LoadViewStateInfraestrutura. Restaura o estado de exibição salva anteriormente no campo controle de dados. (Herdado de DataControlField.)
Implementação explícita da interfaceMétodo particularIStateManager.SaveViewStateInfraestrutura. Salva as alterações feitas a DataControlField estado de exibição desde o momento em que a página foi postada de volta para o servidor. (Herdado de DataControlField.)
Implementação explícita da interfaceMétodo particularIStateManager.TrackViewStateInfraestrutura. Faz com que o DataControlField o objeto para controlar alterações ao seu estado de exibição para que eles podem ser armazenados no controle de ViewState propriedade e persistentes entre as solicitações para a mesma página. (Herdado de DataControlField.)
Superior

O ImageField classe é usada pelos controles ligados a dados (como GridView e DetailsView) para exibir uma imagem para cada registro exibido. O ImageField o objeto é exibido de maneira diferente dependendo do controle ligado a dados em que ele é usado. Por exemplo, o GridView controle exibe um ImageField o objeto como uma coluna, enquanto o DetailsView controle exibe como uma linha.

Para exibir imagens, você deve ligar uma ImageField o objeto a um campo de uma fonte de dados que contém o URL de uma imagem. Isso é feito definindo a DataImageUrlField propriedade. O valor de URL pode ser formatado usando o DataImageUrlFormatString propriedade. Cada imagem também pode ter um texto alternativo associado a ele. Esse texto é exibido quando uma imagem não pode ser carregada ou não está disponível. Navegadores que suportam o recurso de dicas de ferramentas 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 o AlternateText propriedade para especificar o texto alternativo que se aplica a todas as imagens.

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

Quando o valor de URL para 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 ligado a dados. Você pode ocultar um ImageField objeto em um controle ligado a dados, definindo a Visible propriedade para false.

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

ObservaçãoObservação

Alguns controles ligados a dados (como o GridView control) podem mostrar ou ocultar somente a seção inteira de cabeçalho do controle. Esses controles ligados a dados não oferecem suporte a ShowHeader propriedade para um campo de data-bound individual. Para mostrar ou ocultar a seção de cabeçalho inteira de um controle ligado a dados, use o controle ShowHeader propriedade (se disponível).

Você também pode personalizar a aparência da ImageField objeto (cor da fonte, cor de plano 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 diferente.

Propriedade de estilo

Descrição

ControlStyle

As configurações de estilo para os controles de servidor Web filho da ImageField objeto.

FooterStyle

As configurações de estilo para a seção de rodapé a ImageField objeto.

HeaderStyle

As configurações de estilo para a seção de cabeçalho da ImageField objeto.

ItemStyle

As configurações de estilo para os itens de dados na ImageField objeto.

O exemplo a seguir demonstra como usar um ImageField de objetos em um GridView o 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>



.NET Framework

Com suporte em: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Função Server Core sem suporte), Windows Server 2008 R2 (Função Server Core com suporte com o SP1 ou posterior, Itanium sem suporte)

O .NET Framework não oferece suporte a todas as versões de cada plataforma. Para obter uma lista das versões com suporte, consulte Requisitos do sistema do .NET Framework.

Quaisquer membros estático (Shared no Visual Basic) públicos deste tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.

Contribuições da comunidade

ADICIONAR
Mostrar:
© 2014 Microsoft