ImageField.DataImageUrlFormatString 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 je adresa URL pro každý obrázek v objektu ImageField vykreslena.

public:
 virtual property System::String ^ DataImageUrlFormatString { System::String ^ get(); void set(System::String ^ value); };
public virtual string DataImageUrlFormatString { get; set; }
member this.DataImageUrlFormatString : string with get, set
Public Overridable Property DataImageUrlFormatString As String

Hodnota vlastnosti

String

Řetězec, který určuje formát, ve kterém je vykreslena adresa URL pro každý obrázek v objektu ImageField . Výchozí hodnota je prázdný řetězec (""), který označuje, že na adresy URL se nepoužije žádné speciální formátování.

Příklady

Následující příklad kódu ukazuje, jak použít DataImageUrlFormatString vlastnost použít vlastní formát na hodnoty ADRESY URL 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="LastName"
            dataimageurlformatstring="~\Images\{0}.jpg"
            alternatetext="Employee Photo"
            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] 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="LastName"
            dataimageurlformatstring="~\Images\{0}.jpg"
            alternatetext="Employee Photo"
            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] From [Employees]"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" 
        runat="server"/>
            
    </form>
  </body>
</html>

Poznámky

DataImageUrlFormatString Vlastnost slouží k určení vlastního formátu adres URL obrázků zobrazených v objektuImageField. To je užitečné, když potřebujete vygenerovat adresu URL, například když ImageField objekt jednoduše obsahuje název souboru. DataImageUrlFormatString Pokud vlastnost není nastavena, hodnoty adresy URL nezískají žá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 DataImageUrlField vlastností. Zbytek řetězce formátu se zobrazí jako literálový text.

Poznámka

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

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

Poznámka

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

Dvojtečka a hodnoty za dvojtečku jsou volitelné. Znak za dvojtečka (B v obecném příkladu) určuje formát, ve kterém se má zobrazit hodnota. V následující tabulce jsou uvedeny 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 ve formátu čísla.
X Zobrazí číselné hodnoty v šestnáctkovém formátu.

Poznámka

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 významný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é