Compartir a través de

ImageField.DataImageUrlFormatString 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 representa la dirección URL para cada imagen de un objeto ImageField.

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

Valor de propiedad

String

Cadena que especifica el formato con que se representa la dirección URL para cada imagen de un objeto ImageField. El valor predeterminado es una cadena vacía (""), que indica que no se aplica un formato especial a las direcciones URL.

Ejemplos

En el código de ejemplo siguiente se muestra cómo usar la DataImageUrlFormatString propiedad para aplicar un formato personalizado a los valores de dirección URL 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="LastName"
            dataimageurlformatstring="~\Images\{0}.jpg"
            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] 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="LastName"
            dataimageurlformatstring="~\Images\{0}.jpg"
            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] From [Employees]"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" 
        runat="server"/>
            
    </form>
  </body>
</html>

Comentarios

Utilice la DataImageUrlFormatString propiedad para especificar un formato personalizado para las direcciones URL de las imágenes que se muestran en un ImageField objeto . Esto resulta útil cuando necesita generar una dirección URL, como cuando el ImageField objeto simplemente contiene el nombre de archivo. Si no se establece la DataImageUrlFormatString propiedad, los valores de dirección URL 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 "Valor de elemento: {0}", el marcador de posición "{0}" se reemplaza por el valor de los campos especificados por la DataImageUrlField 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 de presentación 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.

Formato de carácter 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 Formato de tipos.

Se aplica a

Consulte también