Aracılığıyla paylaş

ImageField.DataAlternateTextFormatString Özellik

  • Başvuru

Tanım

Ad Alanı:
System.Web.UI.WebControls
Bütünleştirilmiş Kod:
System.Web.dll

Nesnedeki ImageField her görüntü için alternatif metnin işlendiği biçimi belirten dizeyi alır veya ayarlar.

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

Özellik Değeri

String

Nesnedeki her görüntü için alternatif metnin işlendiği biçimi belirten dize ImageField . Varsayılan, artık alternatif metne özel biçimlendirme uygulandığını gösteren boş bir dizedir ("").

Örnekler

Aşağıdaki kod örneği, bir nesnedeki DataAlternateTextFormatString görüntüler ImageField için alternatif metin değerlerine özel bir biçim uygulamak için özelliğinin nasıl kullanılacağını gösterir.


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

Açıklamalar

Bir nesnede DataAlternateTextFormatString görüntülenen görüntülerin alternatif metin değerleri için özel bir ImageField biçim belirtmek için özelliğini kullanın.

Not

Biçim dizesi yalnızca DataAlternateTextField özellik ayarlandığında uygulanır. Özellik ayarlandığında uygulanmaz AlternateText .

Bu, alanda bulunan özgün değeri değiştirmeniz gerektiğinde yararlıdır. DataAlternateTextFormatString Özellik ayarlanmadıysa, alternatif metin değerleri özel biçimlendirmeye sahip olmaz.

Biçim dizesi herhangi bir değişmez değer dizesi olabilir ve genellikle alanın değeri için bir yer tutucu içerir. Örneğin, "Öğe Değeri: {0}" biçim dizesinde, "{0}" yer tutucusu özelliği tarafından DataAlternateTextField belirtilen alanların değeriyle değiştirilir. Biçim dizesinin geri kalanı değişmez metin olarak görüntülenir.

Not

Biçim dizesi yer tutucu içermiyorsa, alanın veri kaynağındaki değeri son görüntüleme metnine dahil değildir.

Yer tutucu, iki nokta üst üste (":") ile ayrılmış ve biçiminde {A:Bxx}küme ayraçları ("{}") içinde sarmalanmış iki bölümden oluşur. İki nokta üst üste işaretinden önceki değer (A genel örnekte) alan değerinin dizinini sıfır tabanlı bir parametre listesinde belirtir.

Not

Bu parametre biçimlendirme söz diziminin bir parçasıdır. Her hücrede yalnızca bir alan değeri olduğundan, bu değer yalnızca 0 olarak ayarlanabilir.

İki nokta üst üste ve iki nokta üst üsteden sonraki değerler isteğe bağlıdır. İki nokta üst üste işaretinden sonraki karakter (B genel örnekte) değerin görüntüleneceği biçimi belirtir. Aşağıdaki tabloda ortak biçimler listelenmektedir.

Karakter biçimlendirme Description
C Sayısal değerleri para birimi biçiminde görüntüler.
D Sayısal değerleri ondalık biçimde görüntüler.
E Sayısal değerleri bilimsel (üstel) biçimde görüntüler.
F Sayısal değerleri sabit biçimde görüntüler.
G Sayısal değerleri genel biçimde görüntüler.
N Sayısal değerleri sayı biçiminde görüntüler.
X Sayısal değerleri onaltılık biçimde görüntüler.

Not

Biçim karakterleri, belirtilen durumda onaltılık karakterleri görüntüleyen dışında Xbüyük/küçük harfe duyarlı değildir.

Biçim karakterinden sonraki değer (genel örnekte xx), görüntülenecek anlamlı basamak veya ondalık basamak sayısını belirtir. Örneğin, "{0:F2}" biçim dizesi 2 ondalık basamaklı sabit noktalı bir sayı görüntüler.

Biçimlendirme hakkında daha fazla bilgi için bkz . Biçimlendirme Türleri.

Şunlara uygulanır

Ayrıca bkz.