ImageField.NullDisplayText Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee wordt de tekst opgehaald of ingesteld om weer te geven in een ImageField object wanneer de waarde van het veld dat is opgegeven door de DataImageUrlField eigenschap is 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, setPublic Overridable Property NullDisplayText As StringWaarde van eigenschap
De tekst die moet worden weergegeven wanneer de waarde van een veld is null. De standaardwaarde is een lege tekenreeks (""), die aangeeft dat deze eigenschap niet is ingesteld.
Voorbeelden
In het volgende voorbeeld ziet u hoe u de NullDisplayText eigenschap gebruikt om de tekst op te geven die moet worden weergegeven wanneer de waarde van het veld dat door de DataImageUrlField eigenschap is nullopgegeven.
<%@ 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>
Opmerkingen
Wanneer de waarde van het veld dat door de DataImageUrlField eigenschap is nullopgegeven, kan een afbeelding niet worden weergegeven in een ImageField object. Gebruik de NullDisplayText eigenschap om de tekst op te geven die moet worden weergegeven op de plaats van de afbeelding. De tekst geeft meestal aan dat de normale afbeelding niet beschikbaar is of niet kan worden gevonden.
Note
Als alternatief kunt u een alternatieve afbeelding weergeven wanneer de veldwaarde is null door de NullImageUrl eigenschap in te stellen in plaats van deze eigenschap. Als de NullImageUrl eigenschappen NullDisplayText beide zijn ingesteld, heeft de NullImageUrl eigenschap voorrang.
De waarde van deze eigenschap, wanneer deze is ingesteld, kan automatisch worden opgeslagen in een resourcebestand met behulp van een ontwerpprogramma. Zie en LocalizableAttribute voor meer informatie.
