BulletedList.BulletImageUrl 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 het pad naar een afbeelding opgehaald of ingesteld om voor elk opsommingsteken in een BulletedList besturingselement weer te geven.
public:
virtual property System::String ^ BulletImageUrl { System::String ^ get(); void set(System::String ^ value); };
public virtual string BulletImageUrl { get; set; }
member this.BulletImageUrl : string with get, set
Public Overridable Property BulletImageUrl As String
Waarde van eigenschap
Het pad naar een afbeelding die moet worden weergegeven als elk opsommingsteken in een BulletedList.
Voorbeelden
In het volgende codevoorbeeld ziet u hoe u een BulletedList besturingselement maakt en de BulletImageUrl eigenschap instelt om het pad op te geven naar een aangepaste afbeelding die voor elk opsommingsteken moet worden gebruikt.
<%@ 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>BulletImageUrl Example</title>
</head>
<body>
<h3>BulletImageUrl Example</h3>
<form id="form1" runat="server">
<asp:BulletedList id="ItemsBulletedList"
DisplayMode="Text"
BulletStyle="CustomImage"
BulletImageUrl="Images/image1.jpg"
runat="server">
<asp:ListItem Value="0">Coho Winery</asp:ListItem>
<asp:ListItem Value="1">Contoso, Ltd.</asp:ListItem>
<asp:ListItem Value="2">Tailspin Toys</asp:ListItem>
</asp:BulletedList>
</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>BulletImageUrl Example</title>
</head>
<body>
<h3>BulletImageUrl Example</h3>
<form id="form1" runat="server">
<asp:BulletedList id="ItemsBulletedList"
DisplayMode="Text"
BulletStyle="CustomImage"
BulletImageUrl="Images/image1.jpg"
runat="server">
<asp:ListItem Value="0">Coho Winery</asp:ListItem>
<asp:ListItem Value="1">Contoso, Ltd.</asp:ListItem>
<asp:ListItem Value="2">Tailspin Toys</asp:ListItem>
</asp:BulletedList>
</form>
</body>
</html>
Opmerkingen
Gebruik de BulletImageUrl eigenschap om het pad naar een afbeelding op te geven om weer te geven als elk opsommingsteken in een BulletedList besturingselement. Als u een aangepaste afbeelding voor de opsommingstekens wilt opgeven, moet u de BulletStyle eigenschap ook instellen op de waarde CustomImage.
Note
Het BulletedList besturingselement biedt geen ondersteuning voor de AlternateText eigenschap omdat de opsommingstekens inherent decoratief zijn en geen aanvullende informatie bieden die via ondersteunende technologie moet worden overgebracht. Als u echter een aangepaste afbeelding wilt gebruiken om een concept over te brengen aan de gebruiker, moet u extra tekst toevoegen aan elk van de items in de lijst met opsommingstekens of een besturingselement gebruiken waarmee u alternatieve tekst voor elke afbeelding kunt opgeven.
U kunt een relatief of een absoluut pad naar de afbeelding opgeven. Een relatief pad heeft betrekking op de locatie van de afbeelding op de locatie van de webpagina zonder een volledig pad op de server op te geven. Het pad is relatief ten opzichte van de locatie van de webpagina. Hierdoor is het eenvoudiger om de hele site naar een andere map op de server te verplaatsen zonder de code bij te werken.
In het volgende codevoorbeeld ziet u een relatief pad naar een afbeeldingsbestand:
\\Images\\image1.jpg
"Images\image1.jpg"
In het volgende codevoorbeeld ziet u een absoluut pad naar een afbeeldingsbestand:
"c:\\MyImagesDir\\image1.jpg"
"c"\MyImagesDir\image1.jpg"
De waarde van deze eigenschap wordt opgeslagen in de weergavestatus.