Compartir vía

BulletedList.BulletImageUrl Propiedad

  • Referencia

Definición

Espacio de nombres:
System.Web.UI.WebControls
Ensamblado:
System.Web.dll

Obtiene o establece la ruta de acceso a una imagen que se muestra en todas las viñetas de un control BulletedList.

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

Valor de propiedad

String

Ruta de acceso a una imagen que se muestra en todas las viñetas de BulletedList.

Ejemplos

En el ejemplo de código siguiente se muestra cómo crear un BulletedList control y establecer la BulletImageUrl propiedad para especificar la ruta de acceso a una imagen personalizada que se va a usar para cada viñeta.

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

Comentarios

Utilice la BulletImageUrl propiedad para especificar la ruta de acceso a una imagen que se va a mostrar como cada viñeta de un BulletedList control. Para especificar una imagen personalizada para las viñetas, también debe establecer la BulletStyle propiedad en el valor CustomImage.

Nota

El BulletedList control no admite la AlternateText propiedad porque las viñetas son intrínsecamente decorativas y no proporcionan información adicional que se debe transmitir a través de la tecnología de asistencia. Sin embargo, si desea usar una imagen personalizada para transmitir un concepto al usuario, debe agregar texto adicional a cada uno de los elementos de lista con viñetas o usar un control que le permita especificar texto alternativo para cada imagen.

Puede especificar una ruta de acceso relativa o absoluta a la imagen. Una ruta de acceso relativa relaciona la ubicación de la imagen con la ubicación de la página web sin especificar una ruta de acceso completa en el servidor. La ruta de acceso es relativa a la ubicación de la página web. Esto facilita el traslado del sitio completo a otro directorio del servidor sin actualizar el código.

En el ejemplo de código siguiente se muestra una ruta de acceso relativa a un archivo de imagen:

\\Images\\image1.jpg

"Images\image1.jpg"

En el ejemplo de código siguiente se muestra una ruta de acceso absoluta a un archivo de imagen:

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

"c"\MyImagesDir\image1.jpg"

El valor de esta propiedad se almacena en estado de vista.

Se aplica a

Consulte también