ImageField.DataImageUrlFormatString 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 a URL de cada imagem num ImageField objeto é renderizada.

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 Propriedade

String

Uma cadeia que especifica o formato em que a URL de cada imagem num ImageField objeto é renderizada. O padrão é a string vazia ("") , o que indica que não é aplicada qualquer formatação especial aos URLs.

Exemplos

O código de exemplo seguinte demonstra como usar a DataImageUrlFormatString propriedade para aplicar um formato personalizado aos valores de URL das imagens num 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>

Observações

Use a DataImageUrlFormatString propriedade para especificar um formato personalizado para as URLs das imagens exibidas num ImageField objeto. Isto é útil quando precisa de gerar uma URL, como quando o ImageField objeto contém simplesmente o nome do ficheiro. Se a DataImageUrlFormatString propriedade não estiver definida, os valores URL 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 DataImageUrlField 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