ImageField.DataAlternateTextFormatString Vlastnost

Definice

Obor názvů:
System.Web.UI.WebControls
Sestavení:
System.Web.dll

Získá nebo nastaví řetězec, který určuje formát, ve kterém je vykreslen alternativní text pro každý obrázek v objektu 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

Hodnota vlastnosti

String

Řetězec, který určuje formát, ve kterém je vykreslen alternativní text pro každý obrázek v objektu ImageField . Výchozí hodnota je prázdný řetězec (""), který označuje, že se teď u alternativního textu použije speciální formátování.

Příklady

Následující příklad kódu ukazuje, jak použít DataAlternateTextFormatString vlastnost použít vlastní formát na alternativní textové hodnoty pro obrázky v objektu 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>

Poznámky

DataAlternateTextFormatString Pomocí vlastnosti zadejte vlastní formát pro alternativní textové hodnoty obrázků zobrazených v objektuImageField.

Note

Formátovací řetězec se použije pouze v případech, kdy je vlastnost nastavena DataAlternateTextField . Při nastavení vlastnosti se nepoužije AlternateText .

To je užitečné, když potřebujete upravit původní hodnotu obsaženou v poli. Pokud vlastnost DataAlternateTextFormatString není nastavena, alternativní textové hodnoty nezískání žádné speciální formátování.

Formátovací řetězec může být libovolný řetězec literálu a obvykle obsahuje zástupný symbol pro hodnotu pole. Například ve formátovacím řetězci "Item Value: {0}", "" zástupný symbol "{0}" je nahrazen hodnotou polí určených DataAlternateTextField vlastností. Zbývající formátovací řetězec se zobrazí jako literálový text.

Note

Pokud formátovací řetězec neobsahuje zástupný symbol, hodnota pole ze zdroje dat se do konečného zobrazovaného textu nezahrne.

Zástupný symbol se skládá ze dvou částí oddělených dvojtečky (":") a zalomené do složených závorek ("{}"), ve formuláři {A:Bxx}. Hodnota před dvojtečku (A v obecném příkladu) určuje index hodnoty pole v seznamu parametrů založených na nule.

Note

Tento parametr je součástí syntaxe formátování. Protože v každé buňce je jenom jedna hodnota pole, může být tato hodnota nastavená pouze na 0.

Dvojtečka a hodnoty za dvojtečku jsou volitelné. Znak za dvojtečku (B v obecném příkladu) určuje formát, ve kterém se má hodnota zobrazit. Následující tabulka uvádí běžné formáty.

Formát znaku Description
C Zobrazí číselné hodnoty ve formátu měny.
D Zobrazí číselné hodnoty v desítkovém formátu.
E Zobrazí číselné hodnoty ve vědeckém (exponenciálním) formátu.
F Zobrazí číselné hodnoty v pevném formátu.
G Zobrazí číselné hodnoty v obecném formátu.
N Zobrazí číselné hodnoty v číselném formátu.
X Zobrazí číselné hodnoty v šestnáctkovém formátu.

Note

Znaky formátu nerozlišují malá a velká písmena, s výjimkou Xznaků , které zobrazují šestnáctkové znaky v zadaném případě.

Hodnota za znakem formátu (xx v obecném příkladu) určuje počet platných číslic nebo desetinných míst, která se mají zobrazit. Například formátovací řetězec "{0:F2}" zobrazí číslo s pevným bodem se 2 desetinnými místy.

Další informace o formátování naleznete v tématu Typy formátování.

Platí pro

Viz také