LiteralControl-Klasse

Stellt HTML-Elemente, Text und alle anderen Zeichenfolgen auf einer ASP.NET-Seite dar, die nicht auf dem Server verarbeitet werden müssen.

Namespace: System.Web.UI
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
Public Class LiteralControl
    Inherits Control
    Implements ITextControl
'Usage
Dim instance As LiteralControl

public class LiteralControl : Control, ITextControl

public ref class LiteralControl : public Control, ITextControl

public class LiteralControl extends Control implements ITextControl

public class LiteralControl extends Control implements ITextControl

Hinweise

ASP.NET kompiliert alle HTML-Elemente und lesbaren Text, für die keine serverseitige Verarbeitung in Instanzen dieser Klasse erforderlich ist. Ein HTML-Element, das kein runat="server"-Attribut-Wert-Paar in seinem öffnenden Tag enthält, wird beispielsweise in ein LiteralControl-Objekt kompiliert. LiteralControl-Objekte behalten den Ansichtszustand nicht bei. Daher muss der Inhalt eines LiteralControl-Objekts bei jeder Anforderung neu erstellt werden.

Literale Steuerelemente enthalten Text, d. h., Sie können aus dem literalen Steuerelement Text extrahieren und das literale Steuerelement aus der ControlCollection-Auflistung des übergeordneten Serversteuerelements über die Controls-Eigenschaft des übergeordneten Elements entfernen. Vergewissern Sie sich also bei der Entwicklung eines benutzerdefinierten Steuerelements, das von der LiteralControl-Klasse abgeleitet wird, dass Ihr Steuerelement alle erforderlichen vorverarbeitenden Schritte selbst ausführt, anstatt hierfür die LiteralControl.Render-Methode aufzurufen. Damit können Sie i. d. R. die Antwortzeit der Webanwendung verkürzen.

Mithilfe der ControlCollection.Add-Methode bzw. der ControlCollection.Remove-Methode können Sie einer Seite oder einem Serversteuerelement literale Steuerelemente programmgesteuert hinzufügen bzw. diese programmgesteuert aus ihnen entfernen.

Beispiel

Im folgenden Codebeispiel wird die Verwendung des überladenen LiteralControl-Konstruktors beim Überschreiben der Control.CreateChildControls-Methode veranschaulicht. Durch den Code werden der Control.Controls-Eigenschaft des aktuellen Serversteuerelements zwei neue LiteralControl-Objekte und ein TextBox-Webserversteuerelement hinzugefügt.

' Add two LiteralControls that render HTML H3 elements and text.
<System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand, Name:="FullTrust")> _
Protected Overrides Sub CreateChildControls()

    Me.Controls.Add(New LiteralControl("<h3>Value: "))

    Dim Box As New TextBox
    Box.Text = "0"
    Me.Controls.Add(box)

    Me.Controls.Add(New LiteralControl("</h3>"))
End Sub

// Add two LiteralControls that render HTML H3 elements and text.
[System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand, Name="FullTrust")] 
protected override void CreateChildControls() {

    this.Controls.Add(new LiteralControl("<h3>Value: "));

    TextBox box = new TextBox();
    box.Text = "0";
    this.Controls.Add(box);

    this.Controls.Add(new LiteralControl("</h3>"));
}

// Add two LiteralControls that render HTML H3 elements and text.
protected void CreateChildControls()
{
    this.get_Controls().Add(new LiteralControl("<h3>Value: "));

    TextBox box = new TextBox();
    box.set_Text("0");
    this.get_Controls().Add(box);

    this.get_Controls().Add(new LiteralControl("</h3>"));
} //CreateChildControls

.NET Framework-Sicherheit

• AspNetHostingPermission  für den Betrieb in einer Hostumgebung. Anforderungswert: LinkDemand, Berechtigungswert: Minimal.
• AspNetHostingPermission  für den Betrieb in einer Hostumgebung. Anforderungswert: InheritanceDemand, Berechtigungswert: Minimal.

Vererbungshierarchie

System.Object
   System.Web.UI.Control
    System.Web.UI.LiteralControl

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

LiteralControl-Member
System.Web.UI-Namespace
Control-Klasse