Compartilhar via

ImageField.DataImageUrlFormatString Propriedade

  • Referência

Definição

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Obtém ou define a cadeia de caracteres que especifica o formato no qual a URL de cada imagem em um objeto ImageField é 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 da propriedade

String

Uma cadeia de caracteres que especifica o formato no qual a URL de cada imagem em um objeto ImageField é renderizada. O padrão é a cadeia de caracteres vazia (""), o que indica que nenhuma formatação especial é aplicada às URLs.

Exemplos

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

Comentários

Use a DataImageUrlFormatString propriedade para especificar um formato personalizado para as URLs das imagens exibidas em um ImageField objeto. Isso é útil quando você precisa gerar uma URL, como quando o ImageField objeto simplesmente contém o nome do arquivo. Se a DataImageUrlFormatString propriedade não estiver definida, os valores de URL não receberão nenhuma formatação especial.

A cadeia de caracteres de formato pode ser qualquer cadeia de caracteres literal e geralmente contém um espaço reservado para o valor do campo. Por exemplo, na cadeia de caracteres de formato "Valor do Item: {0}", o espaço reservado "{0}" é substituído pelo valor dos campos especificados pela DataImageUrlField propriedade. O restante da cadeia de caracteres de formato é exibido como texto literal.

Observação

Se a cadeia de caracteres de formato não incluir um espaço reservado, o valor do campo da fonte de dados não será incluído no texto de exibição final.

O espaço reservado consiste em duas partes separadas por dois-pontos (":") e encapsuladas em chaves ("{}"), no formulário {A:Bxx}. O valor antes dos dois-pontos (A no exemplo geral) especifica o índice do valor do campo em uma lista de parâmetros baseados em zero.

Observação

Esse parâmetro faz parte da sintaxe de formatação. Como há apenas um valor de campo em cada célula, esse valor só pode ser definido como 0.

Os dois-pontos e os valores após os dois-pontos são opcionais. O caractere após os dois-pontos (B no exemplo geral) especifica o formato no qual exibir o valor. A tabela a seguir lista os formatos comuns.

Caractere de formato Descrição
C Exibe valores numéricos no formato de moeda.
D Exibe valores numéricos no formato decimal.
E Exibe valores numéricos no formato científico (exponencial).
F Exibe valores numéricos em formato fixo.
G Exibe valores numéricos em formato geral.
N Exibe valores numéricos no formato numérico.
X Exibe valores numéricos no formato hexadecimal.

Observação

Os caracteres de formato não diferenciam maiúsculas de minúsculas, exceto , Xque exibem os caracteres hexadecimal no caso especificado.

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

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

Aplica-se a

Confira também