Aracılığıyla paylaş

ImageField.DataImageUrlFormatString Özellik

  • Başvuru

Tanım

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

Bir ImageField nesnedeki her görüntünün URL'sinin işlendiği biçimi belirten dizeyi alır veya ayarlar.

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

Özellik Değeri

String

Bir nesnedeki her görüntünün URL'sinin işlendiği biçimi belirten dize ImageField . Varsayılan değer, URL'lere özel biçimlendirme uygulanmadığını gösteren boş dizedir ("") .

Örnekler

Aşağıdaki örnek kod, bir nesnedeki görüntülerin DataImageUrlFormatString ImageField URL 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="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>

Açıklamalar

Bir nesnede DataImageUrlFormatString görüntülenen görüntülerin URL'leri için özel bir ImageField biçim belirtmek için özelliğini kullanın. Bu, nesnenin yalnızca dosya adını içermesi gibi ImageField bir URL oluşturmanız gerektiğinde yararlıdır. DataImageUrlFormatString Özellik ayarlanmadıysa, URL 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 DataImageUrlField 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.