ImageField.DataImageUrlField Propriedade

Definição

Obtém ou define o nome do campo da fonte de dados que contém os valores a serem associados à propriedade ImageUrl de cada imagem em um objeto ImageField.Gets or sets the name of the field from the data source that contains the values to bind to the ImageUrl property of each image in an ImageField object.

public:
 virtual property System::String ^ DataImageUrlField { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.TypeConverter("System.Web.UI.Design.DataSourceViewSchemaConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public virtual string DataImageUrlField { get; set; }
[System.ComponentModel.TypeConverter("System.Web.UI.Design.DataSourceViewSchemaConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public virtual string DataImageUrlField { get; set; }
[<System.ComponentModel.TypeConverter("System.Web.UI.Design.DataSourceViewSchemaConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.DataImageUrlField : string with get, set
[<System.ComponentModel.TypeConverter("System.Web.UI.Design.DataSourceViewSchemaConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.DataImageUrlField : string with get, set
Public Overridable Property DataImageUrlField As String

Valor da propriedade

String

O nome do campo a ser associado à propriedade ImageUrl de cada imagem em um objeto ImageField.The name of the field to bind to the ImageUrl property of each image in an ImageField object.

Atributos

Exemplos

O código de exemplo a seguir demonstra como usar a DataImageUrlField propriedade para especificar o nome do campo a ser associado à ImageUrl propriedade de cada imagem em um ImageField objeto.The following example code demonstrates how to use the DataImageUrlField property to specify the name of the field to bind to the ImageUrl property of each image 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>

Comentários

Use a DataImageUrlField propriedade para especificar o nome do campo a ser associado à ImageUrl propriedade de cada imagem em um ImageField objeto.Use the DataImageUrlField property to specify the name of the field to bind to the ImageUrl property of each image in an ImageField object. O campo especificado deve conter as URLs para as imagens a serem exibidas no ImageField objeto.The specified field must contain the URLs for the images to display in the ImageField object. Opcionalmente, você pode formatar os valores de URL definindo a DataImageUrlFormatString propriedade.You can optionally format the URL values by setting the DataImageUrlFormatString property.

Observação

Quando o valor de arquivado é null , uma imagem não pode ser exibida.When the filed value is null, an image cannot be displayed. Você pode exibir uma imagem alternativa para null valores de campo definindo a NullImageUrl propriedade.You can display an alternate image for null field values by setting the NullImageUrl property. Em vez de uma imagem alternativa, você pode exibir texto alternativo definindo a NullDisplayText propriedade.Instead of an alternate image, you can display alternate text by setting the NullDisplayText property.

Aplica-se a

Confira também