Share via

ImageField.DataAlternateTextFormatString Propriedade

  • Referência

Definição

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

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.

public:
 virtual property System::String ^ DataAlternateTextFormatString { System::String ^ get(); void set(System::String ^ value); };
public virtual string DataAlternateTextFormatString { get; set; }
member this.DataAlternateTextFormatString : string with get, set
Public Overridable Property DataAlternateTextFormatString As String

Valor da propriedade

String

Uma cadeia de caracteres que especifica o formato no qual o texto alternativo para cada imagem em um ImageField objeto é renderizado. O padrão é uma cadeia de caracteres vazia (""), que indica que agora a formatação especial é aplicada ao texto alternativo.

Exemplos

O exemplo de código a seguir demonstra como usar a DataAlternateTextFormatString propriedade para aplicar um formato personalizado aos valores de texto alternativos para as imagens em um ImageField objeto.


<%@ 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"
            dataalternatetextfield="LastName"
            dataalternatetextformatstring="Photo: {0}" 
            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"
            dataalternatetextfield="LastName"
            dataalternatetextformatstring="Photo: {0}" 
            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

Use a DataAlternateTextFormatString propriedade para especificar um formato personalizado para os valores de texto alternativos das imagens exibidas em um ImageField objeto.

Observação

A cadeia de caracteres de formato é aplicada somente quando a DataAlternateTextField propriedade é definida. Ela não é aplicada quando a AlternateText propriedade é definida.

Isso é útil quando você precisa modificar o valor original contido no campo. Se a DataAlternateTextFormatString propriedade não estiver definida, os valores de texto alternativos não receberão nenhuma formatação especial.

A cadeia de caracteres de formato pode ser qualquer cadeia de caracteres literal e geralmente contém um espaço reservado para o valor do campo. Por exemplo, na cadeia de caracteres de formato "Valor do Item: {0}", o espaço reservado "{0}" é substituído pelo valor dos campos especificados pela DataAlternateTextField propriedade. O restante da cadeia de caracteres de formato é exibido como texto literal.

Observação

Se a cadeia de caracteres de formato não incluir um espaço reservado, o valor do campo da fonte de dados não será incluído no texto de exibição final.

O espaço reservado consiste em duas partes separadas por dois-pontos (":") e encapsuladas em chaves ("{}"), no formulário {A:Bxx}. O valor antes dos dois-pontos (A no exemplo geral) especifica o índice do valor do campo em uma lista de parâmetros baseados em zero.

Observação

Esse parâmetro faz parte da sintaxe de formatação. Como há apenas um valor de campo em cada célula, esse valor só pode ser definido como 0.

Os dois-pontos e os valores após os dois-pontos são opcionais. O caractere após os dois-pontos (B no exemplo geral) especifica o formato no qual exibir o valor. A tabela a seguir lista os formatos comuns.

Caractere de formato Descrição
C Exibe valores numéricos no formato de moeda.
D Exibe valores numéricos no formato decimal.
E Exibe valores numéricos no formato científico (exponencial).
F Exibe valores numéricos em formato fixo.
G Exibe valores numéricos em formato geral.
N Exibe valores numéricos no formato numérico.
X Exibe valores numéricos no formato hexadecimal.

Observação

Os caracteres de formato não diferenciam maiúsculas de minúsculas, exceto , Xque exibem os caracteres hexadecimal no caso especificado.

O valor após o caractere de formato (xx no exemplo geral) especifica o número de dígitos significativos ou casas decimais a serem exibidas. Por exemplo, a cadeia de caracteres de formato "{0:F2}" exibe um número de ponto fixo com 2 casas decimais.

Para obter mais informações sobre formatação, consulte Tipos de Formatação.

Aplica-se a

Confira também