Sdílet prostřednictvím

ImageField.DataAlternateTextFormatString Vlastnost

  • Reference

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 alternativní text pro každý obrázek v objektu ImageField je vykreslena.

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ď na alternativní text používá 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 určete vlastní formát pro alternativní textové hodnoty obrázků zobrazených v objektuImageField.

Poznámka

Formátovací řetězec se použije pouze při DataAlternateTextField nastavení vlastnosti . Při nastavení vlastnosti se nepoužije AlternateText .

To je užitečné, když potřebujete upravit původní hodnotu obsaženou v poli. DataAlternateTextFormatString Pokud vlastnost není nastavená, alternativní textové hodnoty nezískají žádné zvláštní 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}" je zástupný symbol "{0}" nahrazen hodnotou polí určených DataAlternateTextField vlastností . Zbytek formátovaného řetězce se zobrazí jako literálový text.

Poznámka

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čka (":") a zabalených do složených závorek ("{}") ve tvaru {A:Bxx}. Hodnota před dvojtečka (A v obecném příkladu) určuje index hodnoty pole v seznamu parametrů od nuly.

Poznámka

Tento parametr je součástí syntaxe formátování. Vzhledem k tomu, že v každé buňce je jenom jedna hodnota pole, dá se tato hodnota nastavit jenom na 0.

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

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.

Poznámka

Formátové znaky nerozlišují malá a velká písmena, s výjimkou Xpříkazu , který v zadaném případě zobrazuje šestnáctkové znaky.

Hodnota za znakem formátu (v obecném příkladu xx) 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 pevnou desetinnou čárkou se 2 desetinnými místy.

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

Platí pro

Viz také