Udostępnij za pośrednictwem

ImageField.DataAlternateTextFormatString Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web.UI.WebControls
Zestaw:
System.Web.dll

Pobiera lub ustawia ciąg określający format, w którym jest renderowany tekst alternatywny dla każdego obrazu w ImageField obiekcie.

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

Wartość właściwości

String

Ciąg określający format, w którym jest renderowany alternatywny tekst dla każdego obrazu w ImageField obiekcie. Wartość domyślna to pusty ciąg (""), który wskazuje, że teraz do tekstu alternatywnego zastosowano specjalne formatowanie.

Przykłady

W poniższym przykładzie kodu pokazano, jak za pomocą DataAlternateTextFormatString właściwości zastosować format niestandardowy do alternatywnych wartości tekstowych obrazów w ImageField obiekcie.


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

Uwagi

Użyj właściwości , DataAlternateTextFormatString aby określić niestandardowy format dla alternatywnych wartości tekstowych obrazów wyświetlanych w ImageField obiekcie.

Uwaga

Ciąg formatu jest stosowany tylko wtedy, gdy właściwość jest ustawiona DataAlternateTextField . Nie jest stosowany, gdy właściwość jest ustawiona AlternateText .

Jest to przydatne, gdy trzeba zmodyfikować oryginalną wartość zawartą w polu. Jeśli właściwość nie jest ustawiona DataAlternateTextFormatString , wartości tekstu alternatywnego nie otrzymują żadnego specjalnego formatowania.

Ciąg formatu może być dowolnym ciągiem literału i zwykle zawiera symbol zastępczy wartości pola. Na przykład w ciągu formatu "Item Value: {0}", symbol zastępczy "{0}" jest zastępowany wartością pól określonych przez DataAlternateTextField właściwość. Pozostała część ciągu formatu jest wyświetlana jako tekst literału.

Uwaga

Jeśli ciąg formatu nie zawiera symbolu zastępczego, wartość pola ze źródła danych nie jest uwzględniona w ostatnim tekście wyświetlania.

Symbol zastępczy składa się z dwóch części oddzielonych dwukropkiem (":") i opakowanych w nawiasy klamrowe ("{}"), w postaci {A:Bxx}. Wartość przed dwukropkiem (A w ogólnym przykładzie) określa indeks wartości pola na liście parametrów opartych na zera.

Uwaga

Ten parametr jest częścią składni formatowania. Ponieważ w każdej komórce istnieje tylko jedna wartość pola, tę wartość można ustawić tylko na wartość 0.

Dwukropek i wartości po dwukropku są opcjonalne. Znak po dwukropku (B w ogólnym przykładzie) określa format, w którym ma być wyświetlana wartość. W poniższej tabeli wymieniono typowe formaty.

Formatuj znak Opis
C Wyświetla wartości liczbowe w formacie waluty.
D Wyświetla wartości liczbowe w formacie dziesiętny.
E Wyświetla wartości liczbowe w formacie naukowym (wykładniczym).
F Wyświetla wartości liczbowe w stałym formacie.
G Wyświetla wartości liczbowe w formacie ogólnym.
N Wyświetla wartości liczbowe w formacie liczbowym.
X Wyświetla wartości liczbowe w formacie szesnastkowym.

Uwaga

Znaki formatu nie są uwzględniane w wielkości liter, z wyjątkiem znaków szesnastkowej, z wyjątkiem Xznaków szesnastkowej w określonym przypadku.

Wartość po znaku formatu (xx w ogólnym przykładzie) określa liczbę cyfr znaczących lub miejsc dziesiętnych do wyświetlenia. Na przykład ciąg formatu "{0:F2}" wyświetla stałą liczbę z 2 miejscami dziesiętnymi.

Aby uzyskać więcej informacji na temat formatowania, zobacz Typy formatowania.

Dotyczy

Zobacz też