Das Panel-Webserversteuerelement stellt ein Containersteuerelement innerhalb einer ASP.NET-Webseite bereit, das Sie als übergeordnetes Element für statischen Text und andere Steuerelemente verwenden können.
1. Hintergrund
Sie können ein Panel-Steuerelement als Container für andere Steuerelemente verwenden. Diese Methode ist besonders nützlich, wenn Sie Inhalte programmgesteuert erstellen und eine Möglichkeit benötigen, den Inhalt in die Seite einzufügen. In den folgenden Abschnitten werden weitere Möglichkeiten zur Verwendung des Panel-Steuerelements beschrieben.
1. Container dynamisch generierter Steuerelemente
Das Panel-Steuerelement bietet einen praktischen Container für zur Laufzeit erstellte Steuerelemente.
2. Gruppieren Sie Steuerelemente und Markierungen
Eine Gruppe von Steuerelementen und zugehörigen Tags kann als Einheit verwaltet werden, indem man sie in einem Panel-Steuerelement platziert und dann das Panel-Steuerelement bearbeitet. Sie können beispielsweise eine Gruppe von Steuerelementen in einem Bedienfeld ausblenden oder anzeigen, indem Sie die Visible-Eigenschaft des Bedienfelds festlegen.
3. Ein Formular mit Standardschaltflächen
Sie können das TextBox-Steuerelement und das Button-Steuerelement in einem Panel-Steuerelement platzieren und dann eine Standardschaltfläche definieren, indem Sie die DefaultButton-Eigenschaft des Panel-Steuerelements auf die ID einer Schaltfläche im Bedienfeld festlegen. Wenn der Benutzer die Eingabetaste drückt, während er in ein Textfeld innerhalb des Bedienfelds eingibt, hat dies den gleichen Effekt, als ob der Benutzer auf eine bestimmte Standardschaltfläche geklickt hätte. Dadurch können Benutzer effizienter mit Projektformularen arbeiten.
4. Fügen Sie Bildlaufleisten zu anderen Steuerelementen hinzu
Einige Steuerelemente (z. B. das TreeView-Steuerelement) verfügen nicht über integrierte Bildlaufleisten. Sie können ein Bildlaufverhalten hinzufügen, indem Sie ein Bildlaufleisten-Steuerelement in einem Panel-Steuerelement platzieren. Um einem Panel-Steuerelement Bildlaufleisten hinzuzufügen, legen Sie die Eigenschaften „Height“ und „Width“ fest, beschränken Sie das Panel-Steuerelement auf eine bestimmte Größe und legen Sie dann die ScrollBars-Eigenschaft fest.
4. Benutzerdefinierte Bereiche auf der Seite
Mit dem Panel-Steuerelement können Sie wie folgt Bereiche auf der Seite mit benutzerdefiniertem Erscheinungsbild und Verhalten erstellen:
·Erstellen Sie ein Gruppenfeld mit einem Titel: Sie können die GroupingText-Eigenschaft so festlegen, dass der Titel angezeigt wird. Beim Rendern der Seite wird um das Panel-Steuerelement herum ein Feld mit einem Titel angezeigt, wobei der Titel der von Ihnen angegebene Text ist.
Hinweis: Sie können im Panel-Steuerelement nicht gleichzeitig Bildlaufleisten und gruppierten Text angeben. Wenn gruppierter Text eingestellt ist, ist seine Priorität höher als die der Bildlaufleiste.
·Erstellen Sie Bereiche auf der Seite mit benutzerdefinierten Farben oder anderen Erscheinungsbildern: Das Panel-Steuerelement unterstützt Erscheinungsbildeigenschaften (z. B. BackColor und BorderWidth), die so eingestellt werden können, dass ein einzigartiges Erscheinungsbild für einen Bereich auf der Seite erstellt wird.
Beschreibung: Durch Festlegen der GroupingText-Eigenschaft wird automatisch ein Rahmen um das Panel-Steuerelement gerendert.
2. Vorgehensweise: Hinzufügen eines Panel-Steuerelements zu einer Web Forms-Seite
1. Ziehen Sie in der Ansicht „Design“ aus der Registerkarte „Standard“ der Toolbox das Panel-Steuerelement auf die Seite.
2. Um statischen Text zu erstellen, klicken Sie in das Steuerelement und geben Sie dann den Text ein. Um Steuerelemente hinzuzufügen, ziehen Sie sie aus der Toolbox in das Panel-Steuerelement.
Hinweis: Um zur Laufzeit statischen Text zu einem Panel-Steuerelement hinzuzufügen, müssen Sie ein Literal-Steuerelement erstellen und dessen Text-Eigenschaft festlegen. Literalobjekte können dann wie jedes andere Steuerelement programmgesteuert zum Panel hinzugefügt werden. Weitere Informationen zum Hinzufügen von Steuerelementen finden Sie unter Gewusst wie: Programmgesteuertes Hinzufügen von Steuerelementen zu einer ASP.NET-Webseite.
3. Sie können auch den Rand des Bedienfelds ziehen, um die Größe des Steuerelements zu ändern.
Beschreibung: Die Größe dieses Steuerelements wird automatisch angepasst, um alle untergeordneten Steuerelemente anzuzeigen (auch wenn diese die festgelegte Höhe überschreiten).
4. Sie können auch die Eigenschaften des Panel-Steuerelements festlegen (wie in der folgenden Tabelle beschrieben), um anzugeben, wie das Fenster mit seinen untergeordneten Steuerelementen interagiert.
Objektbeschreibung
HorizontalAlign
Gibt die Ausrichtung untergeordneter Steuerelemente innerhalb des Bedienfelds an (links, rechts, zentriert oder ausgerichtet).
Wickeln
Gibt an, ob Inhalte, die innerhalb des Panels zu breit sind, in die nächste Zeile umgebrochen oder am Rand des Panels abgeschnitten werden.
Richtung
Gibt an, ob der Inhalt des Steuerelements von links nach rechts oder von rechts nach links gerendert wird. Diese Eigenschaft ist nützlich, wenn Sie Bereiche auf der Seite erstellen, die anders ausgerichtet sind als die gesamte Seite.
Bildlaufleisten
Wenn Sie die Eigenschaften „Height“ und „Width“ festgelegt haben, um das Panel-Steuerelement auf eine bestimmte Größe zu beschränken, können Sie Bildlaufleisten hinzufügen, indem Sie die Eigenschaft „ScrollBars“ festlegen.
Gruppierungstext
Rendert einen Rahmen und Titel um das Panel-Steuerelement.
veranschaulichen:
Das Festlegen der GroupingText-Eigenschaft führt dazu, dass Bildlaufleisten nicht angezeigt werden (wenn Sie Bildlaufleisten angeben).
3. Panel-Klasse
Panel-Steuerelemente sind Container für andere Steuerelemente. Dieses Steuerelement ist besonders nützlich, wenn Sie Steuerelemente programmgesteuert generieren, eine Reihe von Steuerelementen ein-/ausblenden oder eine Reihe von Steuerelementen lokalisieren möchten.
Die Direction-Eigenschaft ist nützlich, um den Inhalt eines Panel-Steuerelements zu lokalisieren, um Text in Sprachen anzuzeigen, die von rechts nach links geschrieben werden, z. B. Arabisch oder Hebräisch.
Das Panel-Steuerelement bietet mehrere Eigenschaften, mit denen Sie das Verhalten und die Anzeige des Steuerelementinhalts anpassen können. Verwenden Sie die BackImageUrl-Eigenschaft, um ein benutzerdefiniertes Bild für das Panel-Steuerelement anzuzeigen. Verwenden Sie die ScrollBars-Eigenschaft, um Bildlaufleisten für das Steuerelement anzugeben.
Beispiel
1. Das folgende Beispiel veranschaulicht, wie Sie mit dem Panel-Steuerelement programmgesteuert Steuerelemente generieren und eine Gruppe von Steuerelementen ein-/ausblenden können.
Hinweis: Das folgende Codebeispiel verwendet ein Einzeldatei-Codemodell und funktioniert möglicherweise nicht ordnungsgemäß, wenn es direkt in eine Code-Behind-Datei kopiert wird. Dieses Codebeispiel muss in eine leere Textdatei mit der Erweiterung .aspx kopiert werden.
<%@ 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>
<Kopf>
<title>Panel-Beispiel</title>
<script runat="server">
void Page_Load(Object sender, EventArgs e) {
// Panel-Inhalte anzeigen oder ausblenden.
if (Check1.Checked) {
Panel1.Visible=false;
}
anders {
Panel1.Visible=true;
}
// Erzeuge die Label-Steuerelemente.
int numlabels = Int32.Parse(DropDown1.SelectedItem.Value);
for (int i=1; i<=numlabels; i++) {
Label l = new Label();
l.Text = "Label" + (i).ToString();
l.ID = "Label" + (i).ToString();
Panel1.Controls.Add(l);
Panel1.Controls.Add(new LiteralControl("<br />"));
}
// Generieren Sie die Textbox-Steuerelemente.
int numtexts = Int32.Parse(DropDown2.SelectedItem.Value);
for (int i=1; i<=numtexts; i++) {
TextBox t = new TextBox();
t.Text = "TextBox" + (i).ToString();
t.ID = "TextBox" + (i).ToString();
Panel1.Controls.Add(t);
Panel1.Controls.Add(new LiteralControl("<br />"));
}
}
</script>
</head>
<Körper>
<h3>Panel-Beispiel</h3>
<form id="form1" runat="server">
<asp:Panel id="Panel1" runat="server"
BackColor="gainsboro"
Höhe="200px"
Breite="300px">
Panel1: Hier sind einige statische Inhalte ...
<br />
</asp:Panel>
<br />
Etiketten generieren:
<asp:DropDownList id="DropDown1" runat="server">
<asp:ListItem Value="0">0</asp:ListItem>
<asp:ListItem Value="1">1</asp:ListItem>
<asp:ListItem Value="2">2</asp:ListItem>
<asp:ListItem Value="3">3</asp:ListItem>
<asp:ListItem Value="4">4</asp:ListItem>
</asp:DropDownList>
<br />
Textfelder generieren:
<asp:DropDownList id="DropDown2" runat="server">
<asp:ListItem Value="0">0</asp:ListItem>
<asp:ListItem Value="1">1</asp:ListItem>
<asp:ListItem Value="2">2</asp:ListItem>
<asp:ListItem Value="3">3</asp:ListItem>
<asp:ListItem Value="4">4</asp:ListItem>
</asp:DropDownList>
<br />
<asp:CheckBox id="Check1" Text="Bedienfeld ausblenden" runat="server"/>
<br />
<asp:Button Text="Panel aktualisieren" runat="server"/>
</form>
</body>