ImageField.NullImageUrl Eigenschaft

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft die URL für ein alternatives Bild ab, das in einem ImageField-Objekt angezeigt wird, wenn der Wert des durch die DataImageUrlField-Eigenschaft angegebenen Felds null ist, oder legt diese URL fest.

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 für ein alternatives Bild, das angezeigt wird, wenn der Wert eines Felds null ist. Der Standardwert ist eine leere Zeichenfolge ("") und gibt an, dass diese Eigenschaft nicht festgelegt ist.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie Sie die NullImageUrl Eigenschaft verwenden, um die URL für ein alternatives Bild anzugeben, das angezeigt werden soll, wenn der Wert des felds, das durch die DataImageUrlField Eigenschaft angegeben ist 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 nullangegebenen Felds lautet, kann ein Bild nicht in einem ImageField Objekt angezeigt werden. Verwenden Sie die NullImageUrl Eigenschaft, um die URL für ein alternatives Bild anzugeben, das angezeigt werden soll. 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 NullDisplayText Feldwert null die Eigenschaft anstelle dieser Eigenschaft festlegt. Wenn die Eigenschaften beide festgelegt sind, hat die NullImageUrl NullDisplayText NullImageUrl Eigenschaft Vorrang.

Gilt für

Siehe auch

NullDisplayText