共用方式為

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 個小數位數的固定點數。

如需格式化的詳細資訊，請參閱 格式化類型。

適用於

另請參閱