ImageField.NullImageUrl 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 URL opgehaald of ingesteld op een alternatieve afbeelding die wordt weergegeven in een ImageField object wanneer de waarde van het veld dat is opgegeven door de DataImageUrlField eigenschap is 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, setPublic Overridable Property NullImageUrl As StringWaarde van eigenschap
De URL naar een alternatieve afbeelding die wordt 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 NullImageUrl eigenschap gebruikt om de URL naar een alternatieve afbeelding 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"
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>
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 NullImageUrl eigenschap om de URL naar een alternatieve afbeelding op te geven die moet worden weergegeven. De alternatieve afbeelding is meestal een afbeelding die aangeeft dat de normale afbeelding niet beschikbaar is of niet kan worden gevonden.
Note
Als alternatief kunt u tekst weergeven wanneer de veldwaarde is null door de NullDisplayText eigenschap in te stellen in plaats van deze eigenschap. Als de NullImageUrl eigenschappen NullDisplayText beide zijn ingesteld, heeft de NullImageUrl eigenschap voorrang.
