ImageField.DataImageUrlFormatString ImageField.DataImageUrlFormatString ImageField.DataImageUrlFormatString ImageField.DataImageUrlFormatString Property

Definición

Obtiene o establece la cadena que especifica el formato con que se representa la dirección URL para cada imagen de un objeto ImageField.Gets or sets the string that specifies the format in which the URL for each image in an ImageField object is rendered.

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

Cadena que especifica el formato con que se representa la dirección URL para cada imagen de un objeto ImageField.A string that specifies the format in which the URL for each image in an ImageField object is rendered. El valor predeterminado es una cadena vacía (""), que indica que no se aplica un formato especial a las direcciones URL.The default is the empty string ("") , which indicates that no special formatting is applied to the URLs.

Ejemplos

En el ejemplo de código siguiente se muestra cómo DataImageUrlFormatString utilizar la propiedad para aplicar un formato personalizado a los valores de dirección URL de ImageField las imágenes de un objeto.The following example code demonstrates how to use the DataImageUrlFormatString property to apply a custom format to the URL values for the images in an ImageField object.


<%@ 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 mostradas ImageField en un objeto.Use the DataImageUrlFormatString property to specify a custom format for the URLs of the images displayed in an ImageField object. Esto resulta útil cuando se necesita generar una dirección URL, como cuando el ImageField objeto contiene simplemente el nombre de archivo.This is useful when you need to generate a URL, such as when the ImageField object simply contains the file name. Si no DataImageUrlFormatString se establece la propiedad, los valores de dirección URL no obtienen ningún formato especial.If the DataImageUrlFormatString property is not set, the URL values do not get any special formatting.

La cadena de formato puede ser cualquier cadena literal y normalmente contiene un marcador de posición para el valor del campo.The format string can be any literal string and usually contains a placeholder for the field's value. Por ejemplo, en la cadena de formato "Item Value {0}:", el{0}marcador de posición "" se reemplaza por el valor de los campos DataImageUrlField especificados por la propiedad.For example, in the format string "Item Value: {0}", the "{0}" placeholder is replaced with the value of the fields specified by the DataImageUrlField property. El resto de la cadena de formato se muestra como texto literal.The rest of the format string is displayed as literal text.

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.If the format string does not include a placeholder, the field's value from the data source is not included in the final display text.

El marcador de posición se compone de dos partes separadas por un signo de dos puntos (":") y{}se ajustan entre llaves ( {A:Bxx}""), en el formulario.The placeholder consists of two parts separated by a colon (":") and wrapped in braces ("{}"), in the form {A:Bxx}. El valor que se encuentra delanteA del signo de dos puntos (en el ejemplo general) especifica el índice del valor de campo en una lista de parámetros de base cero.The value before the colon (A in the general example) specifies the field value's index in a zero-based list of parameters.

Nota

Este parámetro forma parte de la sintaxis de formato.This parameter is part of the formatting syntax. Dado que solo hay un valor de campo en cada celda, este valor solo se puede establecer en 0.Because there is only one field value in each cell, this value can only be set to 0.

Los dos puntos y los valores después del signo de dos puntos son opcionales.The colon and the values after the colon are optional. El carácter que va detrás delB signo de dos puntos (en el ejemplo general) especifica el formato en el que se va a mostrar el valor.The character after the colon (B in the general example) specifies the format in which to display the value. En la tabla siguiente se enumeran los formatos comunes.The following table lists the common formats.

Carácter de formatoFormat character DescripciónDescription
C Muestra los valores numéricos en formato de moneda.Displays numeric values in currency format.
D Muestra los valores numéricos en formato decimal.Displays numeric values in decimal format.
E Muestra los valores numéricos en formato científico (exponencial).Displays numeric values in scientific (exponential) format.
F Muestra los valores numéricos en formato fijo.Displays numeric values in fixed format.
G Muestra los valores numéricos en formato general.Displays numeric values in general format.
N Muestra los valores numéricos en formato de número.Displays numeric values in number format.
X Muestra los valores numéricos en formato hexadecimal.Displays numeric values in hexadecimal format.

Nota

Los caracteres de formato no distinguen mayúsculas de Xminúsculas, excepto, que muestra los caracteres hexadecimales en el caso especificado.The format characters are not case sensitive, except for X, which displays the hexadecimal characters in the case specified.

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.The value after the format character (xx in the general example) specifies the number of significant digits or decimal places to display. Por ejemplo, la cadena de formato{0:F2}"" muestra un número de punto fijo con 2 posiciones decimales.For example, the format string "{0:F2}" displays a fixed-point number with 2 decimal places.

Para obtener más información sobre el formato, vea aplicar formato a tipos.For more information on formatting, see Formatting Types.

Se aplica a

Consulte también: