BulletedList.Target Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft das Zielfenster oder den Zielframe ab, in dem der Inhalt der verknüpften Webseite bei Klicken auf einen Link im BulletedList-Steuerelement angezeigt werden soll, oder legt dieses Fenster bzw. diesen Frame fest.
public:
virtual property System::String ^ Target { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.TypeConverter(typeof(System.Web.UI.WebControls.TargetConverter))]
public virtual string Target { get; set; }
[<System.ComponentModel.TypeConverter(typeof(System.Web.UI.WebControls.TargetConverter))>]
member this.Target : string with get, set
Public Overridable Property Target As String
Eigenschaftswert
Das Zielfenster oder der Zielframe, in dem die verknüpfte Webseite dargestellt werden soll, wenn auf einen Link in einer BulletedList geklickt wird. Der Standardwert ist eine leere Zeichenfolge ("").
- Attribute
Beispiele
Im folgenden Codebeispiel wird veranschaulicht, wie Sie ein BulletedList Steuerelement erstellen und die Target Eigenschaft festlegen. Wenn der Benutzer den HyperLink Anzeigemodus aus dem Listenfeld auswählt, wird die Eigenschaft so _blank
festgelegt, dass die Target verknüpfte Seite in einem neuen Browserfenster angezeigt wird.
<%@ 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>DisplayMode Example</title>
<script runat="server">
void Index_Changed(object sender, System.EventArgs e)
{
// Change the message displayed, based on
// the display mode selected from the list box.
if (DisplayModeListBox.SelectedIndex > -1)
{
Message1.Text = "You chose: " + DisplayModeListBox.SelectedItem.Text;
}
// Change the display mode, based on
// the mode selected from the list box.
switch (DisplayModeListBox.SelectedIndex)
{
case 0:
ItemsBulletedList.DisplayMode = BulletedListDisplayMode.Text;
Message2.Text = "";
break;
case 1:
ItemsBulletedList.DisplayMode = BulletedListDisplayMode.HyperLink;
// Opens a new browser window to display the page linked to.
ItemsBulletedList.Target = "_blank";
Message2.Text = "";
break;
case 2:
ItemsBulletedList.DisplayMode = BulletedListDisplayMode.LinkButton;
break;
default:
throw new Exception("You did not select a valid display mode.");
break;
}
}
void ItemsBulletedList_Click(object sender, System.Web.UI.WebControls.BulletedListEventArgs e)
{
// Change the message displayed, based on the index
// of the bulletedlist list item that was clicked.
switch (e.Index)
{
case 0:
Message2.Text = "You clicked list item 1.";
break;
case 1:
Message2.Text = "You clicked list item 2.";
break;
case 2:
Message2.Text = "You clicked list item 3.";
break;
default:
throw new Exception("You did not click a valid list item.");
break;
}
}
</script>
</head>
<body>
<h3>DisplayMode Example</h3>
<form id="form1" runat="server">
<h3>BulletedListDisplayMode Example</h3>
<p>
<asp:BulletedList id="ItemsBulletedList"
BulletStyle="Disc"
DisplayMode="Text"
OnClick="ItemsBulletedList_Click"
runat="server">
<asp:ListItem Value="http://www.cohowinery.com">Coho Winery</asp:ListItem>
<asp:ListItem Value="http://www.contoso.com">Contoso, Ltd.</asp:ListItem>
<asp:ListItem Value="http://www.tailspintoys.com">Tailspin Toys</asp:ListItem>
</asp:BulletedList></p>
<hr />
<h4>Select from the list to change the display mode:</h4>
<asp:ListBox id="DisplayModeListBox"
Rows="1"
SelectionMode="Single"
AutoPostBack="True"
OnSelectedIndexChanged="Index_Changed"
runat="server">
<asp:ListItem>Text</asp:ListItem>
<asp:ListItem>Hyperlink</asp:ListItem>
<asp:ListItem>LinkButton</asp:ListItem>
</asp:ListBox>
<asp:Label id="Message1"
runat="server"
AssociatedControlID="DisplayModeListBox"/><br /><br />
<asp:Label id="Message2"
runat="server"
AssociatedControlID="DisplayModeListBox"/>
</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>DisplayMode Example</title>
<script runat="server">
Sub Index_Changed(ByVal sender As Object, ByVal e As System.EventArgs)
' Change the message displayed, based on
' the display mode selected from the list box.
If DisplayModeListBox.SelectedIndex > -1 Then
Message1.Text = "You chose: " & DisplayModeListBox.SelectedItem.Text
End If
' Change the display mode, based on
' the mode selected from the list box.
Select Case (DisplayModeListBox.SelectedIndex)
Case 0
ItemsBulletedList.DisplayMode = BulletedListDisplayMode.Text
Message2.Text = ""
Case 1
ItemsBulletedList.DisplayMode = BulletedListDisplayMode.HyperLink
' Opens a new browser window to display the page linked to.
ItemsBulletedList.Target = "_blank"
Message2.Text = ""
Case 2
ItemsBulletedList.DisplayMode = BulletedListDisplayMode.LinkButton
Case Else
Throw New Exception("You did not select a valid display mode.")
End Select
End Sub
Sub ItemsBulletedList_Click(ByVal sender As Object, _
ByVal e As System.Web.UI.WebControls.BulletedListEventArgs)
' Change the message displayed, based on the index
' of the bulletedlist list item that was clicked.
Select Case (e.Index)
Case 0
Message2.Text = "You clicked list item 1."
Case 1
Message2.Text = "You clicked list item 2."
Case 2
Message2.Text = "You clicked list item 3."
Case Else
Throw New Exception("You did not click a valid list item.")
End Select
End Sub
</script>
</head>
<body>
<h3>DisplayMode Example</h3>
<form id="form1" runat="server">
<h3>BulletedListDisplayMode Example</h3>
<p>
<asp:BulletedList id="ItemsBulletedList"
BulletStyle="Disc"
DisplayMode="Text"
OnClick="ItemsBulletedList_Click"
runat="server">
<asp:ListItem Value="http://www.cohowinery.com">Coho Winery</asp:ListItem>
<asp:ListItem Value="http://www.contoso.com">Contoso, Ltd.</asp:ListItem>
<asp:ListItem Value="http://www.tailspintoys.com">Tailspin Toys</asp:ListItem>
</asp:BulletedList></p>
<hr />
<h4>Select from the list to change the display mode:</h4>
<asp:ListBox id="DisplayModeListBox"
Rows="1"
SelectionMode="Single"
AutoPostBack="True"
OnSelectedIndexChanged="Index_Changed"
runat="server">
<asp:ListItem>Text</asp:ListItem>
<asp:ListItem>Hyperlink</asp:ListItem>
<asp:ListItem>LinkButton</asp:ListItem>
</asp:ListBox>
<asp:Label id="Message1"
runat="server"
AssociatedControlID="DisplayModeListBox"/><br /><br />
<asp:Label id="Message2"
runat="server"
AssociatedControlID="DisplayModeListBox"/>
</form>
</body>
</html>
Hinweise
Werte müssen mit einem Buchstaben im Bereich von A bis Z (Groß- und Kleinschreibung) beginnen, außer für die speziellen Werte, die in der folgenden Tabelle aufgeführt sind, die mit einem Unterstrich beginnen.
Wert | BESCHREIBUNG |
---|---|
_blank |
Stellt den Inhalt in einem neuen Fenster ohne Frames dar. |
_parent |
Rendert den Inhalt im übergeordneten Element des unmittelbaren Framesatzes. |
_search |
Gibt den Inhalt im Suchbereich wieder. |
_self |
Stellt den Inhalt in dem Frame dar, der den Fokus besitzt. |
_top |
Stellt den Inhalt im gesamten Fenster ohne Frames dar. |
Hinweis
Sie können der Browserdokumentation entnehmen, ob der _search
-Wert unterstützt wird. Beispielsweise unterstützen Microsoft Internet Explorer 5.0 und höhere Versionen den _search
-Zielwert.
Verwenden Sie die Target Eigenschaft, um den Rahmen oder das Fenster anzugeben, mit der die Webseite angezeigt wird, die verknüpft ist, wenn ein Link in einem BulletedList Steuerelement geklickt wird. Um den Inhalt der Listenelemente als Hyperlinks in einem BulletedList Steuerelement anzuzeigen, legen Sie die BulletedListDisplayMode Eigenschaft auf den Wert HyperLinkfest. Legen Sie dann die Value Eigenschaft jedes Listenelements auf die URL der Webseite fest, um zu navigieren.
Wenn die Target Eigenschaft nicht festgelegt ist, wird der Browser oder das Fenster mit Fokusaktualisierungen aktualisiert, wenn der Link geklickt wird.
Hinweis
Die Target Eigenschaft rendert als target
Attribut. Das target
Attribut für anchor
Elemente ist in der XHTML 1.1-Dokumenttypdefinition nicht zulässig. Legen Sie die Eigenschaft nicht fest, wenn die Target gerenderte Ausgabe für die BulletedList XHTML 1.1-Konform sein muss. Weitere Informationen finden Sie im Thema XHTML-Standards in Visual Studio und ASP.NET.
Beim Erstellen barrierefreier Webseiten wird dringend empfohlen, die Eigenschaft zum Ziel eines anderen Fensters zu verwenden Target . Weitere Informationen finden Sie unter Barrierefreiheit in Visual Studio und ASP.NET.
Der Wert dieser Eigenschaft wird im Ansichtszustand gespeichert.