Panel.BackImageUrl Property
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Gets or sets the URL of the background image for the panel control.
public:
virtual property System::String ^ BackImageUrl { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.Bindable(true)]
public virtual string BackImageUrl { get; set; }
public virtual string BackImageUrl { get; set; }
[<System.ComponentModel.Bindable(true)>]
member this.BackImageUrl : string with get, set
member this.BackImageUrl : string with get, set
Public Overridable Property BackImageUrl As String
Property Value
The URL of the background image for the panel control. The default is Empty.
- Attributes
Examples
The following example illustrates how to programmatically set the BackImageUrl property of the Panel.
Note
The following code sample uses the single-file code model and may not work correctly if copied directly into a code-behind file. This code sample must be copied into an empty text file that has an .aspx extension. For more information on the Web Forms code model, see ASP.NET Web Forms Page Code Model.
<%@ Page Language="C#" AutoEventWireup="True" %>
<!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>
<title>Panel Example</title>
<script language="C#" runat="server">
void Page_Load(Object sender, EventArgs e) {
Label l = new Label();
l.Text = "This panel contains a right justified label.";
Panel1.Controls.Add(l);
}
void Button1_Click(Object sender, EventArgs e) {
Panel1.BackImageUrl =
"//localhost/quickstart/aspplus/images/warning.gif";
}
</script>
</head>
<body>
<h3>Panel Example</h3>
<form id="form1" runat="server">
<asp:Panel id="Panel1" Height="200" Width="200" BackColor="Gainsboro"
Wrap="True" HorizontalAlign="Right" runat="server"/>
<asp:Button id="Button1" OnClick="Button1_Click"
Text="Set the label background" runat="server"/>
</form>
</body>
</html>
<%@ Page Language="VB" AutoEventWireup="True" %>
<!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>
<title>Panel Example</title>
<script language="VB" runat="server">
Sub Page_Load(sender As Object, e As EventArgs)
Dim l As New Label()
l.Text = "This panel contains a right justified label."
Panel1.Controls.Add(l)
End Sub
Sub Button1_Click(sender As Object, e As EventArgs)
Panel1.BackImageUrl = _
"//localhost/quickstart/aspplus/images/warning.gif"
End Sub
</script>
</head>
<body>
<h3>Panel Example</h3>
<form id="form1" runat="server">
<asp:Panel id="Panel1" Height="200" Width="200" BackColor="Gainsboro"
Wrap="True" HorizontalAlign="Right" runat="server"/>
<asp:Button id="Button1" OnClick="Button1_Click"
Text="Set the label background" runat="server"/>
</form>
</body>
</html>
Remarks
Use this property to display a custom image for the Panel control.
If the image is smaller than the Panel, it will be tiled to fill in the Panel.
Note
This property is supported only on browsers that support HTML 4.0 or later.