Freigeben über

ImageField.NullImageUrl Eigenschaft

Definition

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Dient zum Abrufen oder Festlegen der URL auf ein alternatives Bild, das in einem ImageField Objekt angezeigt wird, wenn der Wert des durch die DataImageUrlField Eigenschaft angegebenen Felds ist 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

Eigenschaftswert

String

Die URL zu einem alternativen Bild, das angezeigt wird, wenn der Wert eines Felds ist null. Der Standardwert ist eine leere Zeichenfolge (""), die angibt, dass diese Eigenschaft nicht festgelegt ist.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie die NullImageUrl Eigenschaft verwendet wird, um die URL für ein alternatives Bild anzugeben, das angezeigt werden soll, wenn der Wert des felds, das durch die DataImageUrlField Eigenschaft angegeben wird 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>

Hinweise

Wenn der Wert des durch die DataImageUrlField Eigenschaft angegebenen Felds lautet null, kann ein Bild nicht in einem ImageField Objekt angezeigt werden. Verwenden Sie die NullImageUrl Eigenschaft, um die URL für ein alternatives Anzuzeigende Bild anzugeben. Das alternative Bild ist in der Regel ein Bild, das angibt, dass das normale Bild nicht verfügbar ist oder nicht gefunden werden kann.

Hinweis

Alternativ können Sie text einfach anzeigen, wenn der Feldwert ist null , indem Sie die NullDisplayText Eigenschaft anstelle dieser Eigenschaft festlegen. Wenn beide NullImageUrl Eigenschaften NullDisplayText festgelegt sind, hat die NullImageUrl Eigenschaft Vorrang.

Gilt für:

Weitere Informationen