Image.AlternateText Propriedade

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.

Obtém ou define o texto alternativo exibido no controle de Image quando a imagem está indisponível. Navegadores que dão suporte ao recurso de dicas de ferramentas exibem esse texto como uma dica de ferramenta.

public:
 virtual property System::String ^ AlternateText { System::String ^ get(); void set(System::String ^ value); };

[System.ComponentModel.Bindable(true)]
public virtual string AlternateText { get; set; }

[<System.ComponentModel.Bindable(true)>]
member this.AlternateText : string with get, set

Public Overridable Property AlternateText As String

Valor da propriedade

String

O texto alternativo exibido no controle de Image quando a imagem está indisponível.

Atributos: BindableAttribute

Exemplos

O exemplo a seguir demonstra como usar a AlternateText propriedade para especificar o texto alternativo a ser exibido para a imagem quando a imagem não estiver disponível.

<%@ 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>
    <title>Image Example</title>
</head>
 
<body>

   <form id="form1" runat="server">

      <h3>Image Example</h3>

      <asp:Image id="Image1" runat="server"
           AlternateText="Image text"
           ImageAlign="left"
           ImageUrl="images/image1.jpg"/>
  
   </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>
    <title>Image Example</title>
</head>
 
<body>

   <form id="form1" runat="server">

      <h3>Image Example</h3>

      <asp:Image id="Image1" runat="server"
           AlternateText="Image text"
           ImageAlign="left"
           ImageUrl="images/image1.jpg"/>
  
   </form>

</body>
</html>

Comentários

Use essa propriedade para especificar o texto a ser exibido se a imagem especificada na ImageUrl propriedade não estiver disponível. Em navegadores que dão suporte ao recurso Dicas de Ferramenta, esse texto também é exibido como uma Dica de Ferramenta.

O valor dessa propriedade, quando definido, pode ser salvo automaticamente em um arquivo de recurso usando uma ferramenta de designer. Para obter mais informações, consulte LocalizableAttribute e ASP.NET Globalização e Localização.

Aplica-se a

Produto	Versões
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

Festival de Habilidades de IA

Compartilhar via