ImageField.DataAlternateTextFormatString 属性

  • 参考

定义

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

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

public:
 virtual property System::String ^ DataAlternateTextFormatString { System::String ^ get(); void set(System::String ^ value); };
public virtual string DataAlternateTextFormatString { get; set; }
member this.DataAlternateTextFormatString : string with get, set
Public Overridable Property DataAlternateTextFormatString As String

属性值

String

指定 ImageField 对象中每个图像的备用文本所呈现的格式的字符串。 默认值为空字符串 ("")，它指示备用文本现在应用特殊格式。

示例

下面的代码示例演示如何使用 DataAlternateTextFormatString 属性将自定义格式应用于 对象中 ImageField 图像的备用文本值。


<%@ 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="PhotoPath"
            dataalternatetextfield="LastName"
            dataalternatetextformatstring="Photo: {0}" 
            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], [PhotoPath] 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="PhotoPath"
            dataalternatetextfield="LastName"
            dataalternatetextformatstring="Photo: {0}" 
            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], [PhotoPath] From [Employees]"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" 
        runat="server"/>
            
    </form>
  </body>
</html>

注解

DataAlternateTextFormatString使用 属性为 对象中显示的ImageField图像的备用文本值指定自定义格式。

注意

仅当设置了 属性时， DataAlternateTextField 才应用格式字符串。 设置 属性时，不会应用该 AlternateText 属性。

当需要修改字段中包含的原始值时，这非常有用。 DataAlternateTextFormatString如果未设置 属性，则备用文本值不会获得任何特殊格式。

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

注意

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

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

注意

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

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

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

注意

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

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

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

适用于

另请参阅