ImageField.DataAlternateTextFormatString Propriedade

Definição

Espaço de Nomes:
System.Web.UI.WebControls
Assemblagem:
System.Web.dll

Obtém ou define a cadeia que especifica o formato em que o texto alternativo de cada imagem num ImageField objeto é 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 de Propriedade

String

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

Exemplos

O exemplo de código seguinte demonstra como usar a DataAlternateTextFormatString propriedade para aplicar um formato personalizado aos valores de texto alternativos para as imagens de 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>

Observações

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

Note

A string de formato é aplicada apenas quando a DataAlternateTextField propriedade está definida. Não é aplicada quando a AlternateText propriedade é definida.

Isto é útil quando precisas de modificar o valor original contido no campo. Se a DataAlternateTextFormatString propriedade não estiver definida, os valores alternativos do texto não recebem qualquer formatação especial.

A cadeia de formato pode ser qualquer cadeia literal e normalmente contém um marcador de posição para o valor do campo. Por exemplo, na cadeia de formato "Item Value: {0}", o marcador de posição "{0}" é substituído pelo valor dos campos especificados pela DataAlternateTextField propriedade. O resto da cadeia de formatos é apresentado como texto literal.

Note

Se a cadeia de formato não incluir um marcador de posição, o valor do campo da fonte de dados não é incluído no texto final de visualização.

O marcador consiste em duas partes separadas por dois pontos (":") e envolvidas em colchetes ("{}"), na forma {A:Bxx}. O valor antes dos dois-pontos (A no exemplo geral) especifica o índice do valor do campo numa lista de parâmetros baseada em zero.

Note

Este parâmetro faz parte da sintaxe de formatação. Como existe apenas um valor de campo em cada célula, este valor só pode ser definido para 0.

O dois-pontos e os valores após o dois-pontos são opcionais. O carácter após os dois-pontos (B no exemplo geral) especifica o formato em que o valor deve ser exibido. A tabela seguinte lista os formatos comuns.

Carácter de formato Description
C Apresenta valores numéricos em formato de moeda.
D Apresenta valores numéricos em formato decimal.
E Apresenta valores numéricos em formato científico (exponencial).
F Apresenta valores numéricos em formato fixo.
G Apresenta valores numéricos em formato geral.
N Apresenta valores numéricos em formato numérico.
X Apresenta valores numéricos em formato hexadecimal.

Note

Os caracteres de formato não são sensíveis a maiúsculas e minúsculas, exceto , Xque mostra os caracteres hexadecimais no caso especificado.

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

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

Aplica-se a

Ver também