BulletedList.BulletImageUrl Eigenschaft

  • Referenz

Definition

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

Ruft den Pfad zu einem Bild ab, das für jedes einzelne Aufzählungszeichen in einem BulletedList-Steuerelement angezeigt werden soll, oder legt diesen fest.

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

Eigenschaftswert

String

Der Pfad zu einem Bild, das für jedes einzelne Aufzählungszeichen in einem BulletedList angezeigt werden soll.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie ein BulletedList Steuerelement erstellen und die BulletImageUrl -Eigenschaft festlegen, um den Pfad zu einem benutzerdefinierten Bild anzugeben, das für jedes Aufzählungszeichen verwendet werden soll.

<%@ 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>

Hinweise

Verwenden Sie die BulletImageUrl -Eigenschaft, um den Pfad zu einem Bild anzugeben, das als jedes Aufzählungszeichen in einem BulletedList Steuerelement angezeigt werden soll. Um ein benutzerdefiniertes Bild für die Aufzählungszeichen anzugeben, müssen Sie auch die BulletStyle -Eigenschaft auf den Wert CustomImagefestlegen.

Hinweis

Das BulletedList Steuerelement unterstützt die AlternateText -Eigenschaft nicht, da die Aufzählungszeichen von Natur aus dekorativ sind und keine zusätzlichen Informationen bereitstellen, die über Hilfstechnologien vermittelt werden müssen. Wenn Sie jedoch ein benutzerdefiniertes Bild verwenden möchten, um dem Benutzer ein Konzept zu vermitteln, sollten Sie jedem der Aufzählungselemente zusätzlichen Text hinzufügen oder ein Steuerelement verwenden, mit dem Sie alternativen Text für jedes Bild angeben können.

Sie können entweder einen relativen oder einen absoluten Pfad zum Bild angeben. Ein relativer Pfad verknüpft den Speicherort des Bilds mit dem Speicherort der Webseite, ohne einen vollständigen Pfad auf dem Server anzugeben. Der Pfad ist relativ zum Speicherort der Webseite. Dies erleichtert das Verschieben des gesamten Standorts in ein anderes Verzeichnis auf dem Server, ohne den Code zu aktualisieren.

Das folgende Codebeispiel zeigt einen relativen Pfad zu einer Bilddatei:

\\Images\\image1.jpg

"Images\image1.jpg"

Das folgende Codebeispiel zeigt einen absoluten Pfad zu einer Bilddatei:

"c:\\MyImagesDir\\image1.jpg"

"c"\MyImagesDir\image1.jpg"

Der Wert dieser Eigenschaft wird im Ansichtszustand gespeichert.

Gilt für:

Weitere Informationen