Freigeben über

ImageField.NullDisplayText Eigenschaft

Definition

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

Dient zum Abrufen oder Festlegen des Texts, der in einem ImageField Objekt angezeigt werden soll, wenn der Wert des durch die DataImageUrlField Eigenschaft angegebenen Felds ist null.

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

Eigenschaftswert

String

Der Text, der angezeigt werden soll, 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 NullDisplayText Eigenschaft verwendet wird, um den anzuzeigenden Text anzugeben, wenn der Wert des durch die DataImageUrlField Eigenschaft angegebenen Felds 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"
            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], [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"
            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], [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 NullDisplayText Eigenschaft, um den Text anzugeben, der an der Stelle des Bilds angezeigt werden soll. Der Text gibt in der Regel an, dass das normale Bild nicht verfügbar ist oder nicht gefunden werden kann.

Hinweis

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

Der Wert dieser Eigenschaft kann automatisch mithilfe eines Designertools in einer Ressourcendatei gespeichert werden. Weitere Informationen finden Sie unter LocalizableAttribute"Globalisierung und Lokalisierung".

Gilt für:

Weitere Informationen