通过

ImageField.DataImageUrlFormatString 属性

  • 参考

定义

命名空间:
System.Web.UI.WebControls
程序集:
System.Web.dll

获取或设置一个字符串，用于指定 ImageField 对象中每个图像的 URL 所呈现的格式。

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

属性值

String

一个字符串，用于指定 ImageField 对象中每个图像的 URL 所呈现的格式。 默认值为空字符串 ("")，它指示 URL 未应用任何特殊格式。

示例

以下示例代码演示如何使用 DataImageUrlFormatString 属性将自定义格式应用于对象中 ImageField 图像的 URL 值。


<%@ 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>

注解

使用 DataImageUrlFormatString 属性为对象中显示的 ImageField 图像的 URL 指定自定义格式。 当需要生成 URL 时（例如对象仅包含文件名时 ImageField ），这非常有用。 如果未设置该 DataImageUrlFormatString 属性，则 URL 值不会获取任何特殊格式。

格式字符串可以是任何文本字符串，通常包含字段值的占位符。 例如，在格式字符串“Item Value： {0}”， “{0}” 占位符替换为属性指定的 DataImageUrlField 字段的值。 格式字符串的其余部分显示为文本文本。

备注

如果格式字符串不包含占位符，则数据源中的字段值不包括在最终显示文本中。

占位符由冒号 (“分隔的两个部分组成：”) 并包装在大括号 (“”{}) 窗体 {A:Bxx}中。 常规示例中冒号 (前面的值) A 在从零开始的参数列表中指定字段值的索引。

备注

此参数是格式设置语法的一部分。 由于每个单元格中只有一个字段值，因此此值只能设置为 0。

冒号和冒号后的值是可选的。 常规示例中冒号 (B 后面的字符) 指定要在其中显示值的格式。 下表列出了通用格式。

设置字符格式 说明
C 以货币格式显示数值。
D 以十进制格式显示数值。
E 以科学 (指数) 格式显示数值。
F 以固定格式显示数值。
G 以常规格式显示数值。
N 以数字格式显示数值。
X 以十六进制格式显示数值。

备注

格式字符不区分大小写，但显示 X指定大小写中的十六进制字符除外。

常规示例中格式字符 (xx 后面的值) 指定要显示的有效位数或小数位数。 例如，格式字符串“{0:F2}”显示具有 2 个小数位数的固定点数。

有关格式设置的详细信息，请参阅 格式设置类型。

适用于

另请参阅