Udostępnij za pośrednictwem


ImageField.NullImageUrl Właściwość

Definicja

Pobiera lub ustawia adres URL na alternatywny obraz wyświetlany w ImageField obiekcie, gdy wartość pola określonego DataImageUrlField przez właściwość to null.

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

Wartość właściwości

Adres URL alternatywnego obrazu wyświetlanego, gdy wartość pola to null. Wartość domyślna to pusty ciąg (""), który wskazuje, że ta właściwość nie jest ustawiona.

Przykłady

W poniższym przykładzie pokazano, jak za pomocą NullImageUrl właściwości określić adres URL alternatywnego obrazu do wyświetlenia, gdy wartość pola określonego DataImageUrlField przez właściwość to null.


<%@ 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"
            alternatetext="Employee Photo"
            nullimageurl="~\Images\NoPhoto.jpg"
            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"
            alternatetext="Employee Photo"
            nullimageurl="~\Images\NoPhoto.jpg"
            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

Jeśli wartość pola określonego DataImageUrlField przez właściwość to null, obraz nie może być wyświetlany w ImageField obiekcie. NullImageUrl Użyj właściwości , aby określić adres URL alternatywnego obrazu do wyświetlenia. Alternatywny obraz jest zwykle obrazem wskazującym, że normalny obraz jest niedostępny lub nie można go odnaleźć.

Uwaga

Alternatywnie można po prostu wyświetlić tekst, gdy wartość pola jest null przez ustawienie NullDisplayText właściwości zamiast tej właściwości. NullImageUrl Jeśli właściwości i NullDisplayText są ustawione, NullImageUrl właściwość ma pierwszeństwo.

Dotyczy

Zobacz też