ImageField.DataAlternateTextFormatString Propiedad

  • Referencia

Definición

Espacio de nombres:
System.Web.UI.WebControls
Ensamblado:
System.Web.dll

Obtiene o establece la cadena que especifica el formato con que se representar el texto alternativo para cada imagen de un objeto ImageField.

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 propiedad

String

Cadena que especifica el formato con que se representa el texto alternativo para cada imagen de un objeto ImageField. El valor predeterminado es una cadena vacía (""), que indica que ahora se aplica un formato especial al texto alternativo.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar la DataAlternateTextFormatString propiedad para aplicar un formato personalizado a los valores de texto alternativos de las imágenes de un 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>

Comentarios

Utilice la DataAlternateTextFormatString propiedad para especificar un formato personalizado para los valores de texto alternativos de las imágenes mostradas en un ImageField objeto .

Nota:

La cadena de formato solo se aplica cuando se establece la DataAlternateTextField propiedad . No se aplica cuando se establece la AlternateText propiedad .

Esto resulta útil cuando es necesario modificar el valor original contenido en el campo. Si no se establece la DataAlternateTextFormatString propiedad, los valores de texto alternativo no obtienen ningún formato especial.

La cadena de formato puede ser cualquier cadena literal y normalmente contiene un marcador de posición para el valor del campo. Por ejemplo, en la cadena de formato "Item Value: {0}", el marcador de posición "{0}" se reemplaza por el valor de los campos especificados por la DataAlternateTextField propiedad . El resto de la cadena de formato se muestra como texto literal.

Nota

Si la cadena de formato no incluye un marcador de posición, el valor del campo del origen de datos no se incluye en el texto para mostrar final.

El marcador de posición consta de dos partes separadas por dos puntos (":") y encapsuladas entre llaves ("{}"), con el formato {A:Bxx}. El valor anterior a los dos puntos (A en el ejemplo general) especifica el índice del valor del campo en una lista de parámetros de base cero.

Nota

Este parámetro forma parte de la sintaxis de formato. Dado que solo hay un valor de campo en cada celda, este valor solo se puede establecer en 0.

Los dos puntos y los valores después de los dos puntos son opcionales. El carácter después de los dos puntos (B en el ejemplo general) especifica el formato en el que se va a mostrar el valor. En la tabla siguiente se enumeran los formatos comunes.

Carácter de formato Descripción
C Muestra valores numéricos en formato de moneda.
D Muestra valores numéricos en formato decimal.
E Muestra valores numéricos en formato científico (exponencial).
F Muestra valores numéricos en formato fijo.
G Muestra valores numéricos en formato general.
N Muestra valores numéricos en formato numérico.
X Muestra valores numéricos en formato hexadecimal.

Nota:

Los caracteres de formato no distinguen mayúsculas de minúsculas, excepto para X, que muestra los caracteres hexadecimales en el caso especificado.

El valor después del carácter de formato (xx en el ejemplo general) especifica el número de dígitos significativos o posiciones decimales que se van a mostrar. Por ejemplo, la cadena de formato "{0:F2}" muestra un número de punto fijo con 2 posiciones decimales.

Para obtener más información sobre el formato, vea Tipos de formato.

Se aplica a

Consulte también