MasterPage Klasse

Definition

Dient als Vorlage und Zusammenführungscontainer für Seiten, die nur aus Content-Steuerelementen und ihre jeweiligen untergeordneten Steuerelementen bestehen.

public ref class MasterPage : System::Web::UI::UserControl
public class MasterPage : System.Web.UI.UserControl
type MasterPage = class
    inherit UserControl
Public Class MasterPage
Inherits UserControl
Vererbung

Beispiele

Dieser Abschnitt enthält vier Codebeispiele:

  • Im ersten Codebeispiel wird veranschaulicht, wie eine master Seite deklarativ erstellt wird.

  • Das zweite Codebeispiel stellt die Inhaltsseite dar, die der master Seite zugeordnet ist, die im ersten Codebeispiel erstellt wurde.

  • Im dritten Codebeispiel wird veranschaulicht, wie einer master Seite eine Eigenschaft hinzugefügt wird.

  • Im vierten Codebeispiel wird veranschaulicht, wie sie mithilfe einer Inhaltsseite auf eine öffentliche Eigenschaft auf der seite master zugreifen.

Im folgenden Beispiel wird veranschaulicht, wie Sie eine master Seite deklarativ erstellen und ihr mithilfe einer Inhaltsseite Inhalte hinzufügen. Die erste Webseite ist die . master Seite mit dem Namen MasterPageSample_1.master.

<%@ Master Language="C#" %>  
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">  
<html >  
<head runat="server">  
    <title>MasterPage Example</title>  
</head>  
<body>  
    <form id="form1" runat="server">  
    <div>  
        <asp:contentplaceholder id="ContentPlaceHolder1" runat="server" />  
    </div>  
    </form>  
</body>  
</html>  
<%@ Master Language="VB" %>  
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">  
<html >  
<head runat="server">  
    <title>MasterPage Example</title>  
</head>  
<body>  
    <form id="form1" runat="server">  
    <div>  
        <asp:contentplaceholder id="ContentPlaceHolder1" runat="server" />  
    </div>  
    </form>  
</body>  
</html>  

Das folgende Beispiel stellt die Inhaltsseite dar, die zugeordnet MasterPageSample_1.masterist. Es enthält ein Content -Steuerelement und identifiziert das ContentPlaceHolder Steuerelement, dem der Inhalt zugeordnet ist, mithilfe der ContentPlaceHolderID -Eigenschaft.

<%@ Page Language="C#" MasterPageFile="~/MasterPageSample_1cs.master" Title="Content Page"%>  

<asp:content   
    runat="server"  
    contentplaceholderid="ContentPlaceHolder1" >Hello, Master Pages!</asp:content>  
<%@ Page Language="VB" MasterPageFile="~/MasterPageSample_1vb.master" Title="Content Page"%>  

<asp:content   
    runat="server"  
    contentplaceholderid="ContentPlaceHolder1" >Hello, Master Pages!</asp:content>  

Im folgenden Beispiel wird veranschaulicht, wie sie einer master Seite eine Eigenschaft hinzufügen. Das ClassName Attribut wird verwendet, um die master Seite zu benennen.

<%@ Master Language="C#" ClassName="MasterExample" %>  

<script runat="server">  
        public string SiteName  
        {  
            get { return "My Site Name"; }  
        }  
</script>  

<html >  
<head runat="server">  
    <title>MasterPage Example</title>  
</head>  
<body>  
    <form id="form1" runat="server">  
    <div>  
        <asp:contentplaceholder id="ContentPlaceHolder1" runat="server">  
        </asp:contentplaceholder>  
    </div>  
    </form>  
</body>  
</html>  
<%@ Master Language="VB" ClassName="MasterExample" %>  

<script runat="server">  
  Public ReadOnly Property SiteName() As String  
    Get  
      Return "My Site Name"  
    End Get  
  End Property  

</script>  

<html >  
<head runat="server">  
    <title>MasterPage Example</title>  
</head>  
<body>  
    <form id="form1" runat="server">  
    <div>  
        <asp:contentplaceholder id="ContentPlaceHolder1" runat="server">  
        </asp:contentplaceholder>  
    </div>  
    </form>  
</body>  
</html>  

Das folgende Beispiel zeigt, wie Sie mithilfe einer Inhaltsseite auf die öffentliche Eigenschaft SiteName auf der seite master im vorherigen Codebeispiel zugreifen.

<%@ Page Language="C#" MasterPageFile="~/MasterPage.master" Title="MasterPage Example" %>  

<script runat="server">  
  protected void Page_Load(object sender, EventArgs e)  
  {  
    MasterExample m = (MasterExample)Page.Master;  
    mylabel.Text = m.SiteName;  
  }  
</script>  

<asp:Content ID="Content1" ContentPlaceHolderID="ContentPlaceHolder1" runat="Server">  
    Hello, Master Pages!  
    <asp:Label runat="server" Text="Label" ID="mylabel"></asp:Label>  
</asp:Content>  
<%@ Page Language="VB" MasterPageFile="~/MasterPage.master" Title="MasterPage Example" %>  

<script runat="server">  

  Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs)  
    Dim m As MasterExample = CType(Page.Master, MasterPage)  
    mylabel.Text = m.SiteName  
  End Sub  
</script>  

<asp:Content ID="Content1" ContentPlaceHolderID="ContentPlaceHolder1" runat="Server">  
    Hello, Master Pages!  
    <asp:Label runat="server" Text="Label" ID="mylabel"></asp:Label>  
</asp:Content>  

Hinweise

Eine master Seite fungiert als Vorlagencontainer und zusammenführende Seite für Inhaltsseiten in Ihrer ASP.NET-Webanwendung. Gestaltungsvorlagen bieten eine bequeme Möglichkeit, Struktur und Inhalt für eine Reihe von Inhaltsseiten freizugeben. Sie verwenden Inhaltsplatzhalter, um die Abschnitte der master Seite zu definieren, die durch Inhalte aus den Inhaltsseiten ersetzt werden sollen.

Wenn Sie eine master Seite und die zugehörigen Inhaltsseiten verwenden, fügen Sie die erforderlichen XHTML-Dokumenttags (zhtml. B. , headund body) nur der master Seite hinzu und erstellen Ihre anderen ASPX-Dateien (ASP.NET Seiten) nicht mehr als eigenständige Webseiten. Die Inhaltsseiten definieren den Inhalt, der in die Platzhalter auf der master Seite eingefügt werden soll.

Wenn zur Laufzeit eine HTTP-Anforderung für eine Seite gestellt wird, werden die master- und Inhaltsseiten zu einer einzelnen Klasse mit demselben Namen wie die Inhaltsseiten kombiniert. Die resultierende kompilierte, zusammengeführte Klasse leitet sich von der Page -Klasse ab.

Eine master Seite kann direktes Markup und Serversteuerelemente sowie Containersteuerelemente enthalten. Jedes Element, das auf der master Seite außerhalb eines ContentPlaceHolder Steuerelements platziert wird, wird auf allen Seiten gerendert, die sich aus der Zusammenführung der master-Seite und der Inhaltsseiten ergeben.

Jede Inhaltsseite, die mit der master-Seite verknüpft ist, muss in einem MasterPageFile Attribut der @Page-Direktive auf die master-Seite verweisen. Inhaltsseiten dürfen nur eine @ Page Direktive und ein oder Content mehrere Steuerelemente enthalten. Alle Seitentext-, Markup- und Serversteuerelemente müssen in Content Steuerelementen platziert werden. Sie identifizieren das ContentPlaceHolder Steuerelement einer master Seite, der ein Content Steuerelement zugeordnet ist, indem Sie die ContentPlaceHolderID -Eigenschaft des Steuerelements Content festlegen.

Zur Laufzeit wird der dynamische Inhalt jedes Content Steuerelements auf der angeforderten Seite mit der master Seite an der genauen Position des zugehörigen ContentPlaceHolder Steuerelements zusammengeführt. Alle anderen Markups und Steuerelemente auf der master Seite sind davon nicht betroffen. Ereignishandler können sowohl in der master-Klasse als auch auf der Inhaltsseite definiert werden. Weitere Informationen finden Sie unter Ereignisse in ASP.NET Master- und Inhaltsseiten.

Die MasterPage -Klasse ist Dateien zugeordnet, die die Erweiterung .master aufweisen. Diese Dateien werden zur Laufzeit als MasterPage Objekte kompiliert und im Serverspeicher zwischengespeichert.

Die master Seite wird der Inhaltsseite über die Master -Eigenschaft der Basisklasse Page zur Verfügung gestellt. Die Master -Eigenschaft gibt den instance der master Seite zurück. Sie wird jedoch als Basisklasse MasterPage eingegeben. Um auf Steuerelemente, Eigenschaften und Funktionen der master-Seite zuzugreifen, kann die Master -Eigenschaft in ein MasterPage -Objekt umgewandelt werden. Der Klassenname der master Seite wird mithilfe des ClassName Attributs der @ Master-Direktive definiert.

Hinweis

Dateien mit . master Erweiterungen werden nicht für einen Browser bereitgestellt.

Die auf einer master Seite gültigen Anweisungen sind identisch mit denen, die für ein UserControl Objekt verfügbar sind. Sie können die folgenden Attribute enthalten:

  • AutoEventWireup

  • ClassName

  • CodeFile

  • CompilerMode

  • CompilerOptions

  • Debug

  • Description

  • EnableTheming

  • EnableViewState

  • Explicit

  • Inherits

  • Language

  • LinePragmas

  • MasterPageFile

  • Src

  • Strict

  • WarningLevel

Gestaltungsvorlagendirektiven überschreiben die Anweisungen auf einzelnen Inhaltsseiten nicht.

Gestaltungsvorlagen werden am häufigsten deklarativ erstellt. Wenn Sie eine master Seite programmgesteuert erstellen möchten, leiten Sie direkt von der MasterPage -Klasse ab. Zusätzlich zum Erweitern der MasterPage -Klasse müssen Sie die .master-Datei erstellen, um die Benutzeroberfläche visuell anzuzeigen, die den Klassen zugeordnet ist, die Sie in Ihrer Quelldatei aufgerufen haben.

Hinweis

Wenn Sie eine master Seite erstellen, indem Sie zuerst Ihre eigene Klasse erstellen, müssen Sie alle Namespaces einschließen, die für die von der Seite verwendeten Klassen erforderlich sind.

Weitere Informationen zu master Seiten finden Sie unter ASP.NET Gestaltungsvorlagen.

Konstruktoren

MasterPage()

Erstellt eine neue Instanz der MasterPage-Klasse.

Eigenschaften

Adapter

Ruft den browserspezifischen Adapter für das Steuerelement ab.

(Geerbt von Control)
Application

Ruft das Application-Objekt für die aktuelle Webanforderung ab.

(Geerbt von UserControl)
AppRelativeTemplateSourceDirectory

Ruft das anwendungsrelative virtuelle Verzeichnis des Page-Objekts oder des UserControl-Objekt ab, das dieses Steuerelement enthält, oder legt dieses Verzeichnis fest.

(Geerbt von Control)
AppRelativeVirtualPath

Ruft den anwendungsbezogenen virtuellen Verzeichnispfad zur Datei ab, von der aus das Steuerelement analysiert und kompiliert wird, oder legt diesen fest.

(Geerbt von TemplateControl)
Attributes

Ruft eine Auflistung aller Attributname-Wert-Paare ab, die innerhalb der ASPX-Datei im Benutzersteuerelementtag deklariert sind.

(Geerbt von UserControl)
AutoHandlers
Veraltet.

Die AutoHandlers-Eigenschaft ist seit ASP.NET-Version 2.0 veraltet. Sie wird von generierten Klassen verwendet und ist nicht zur Verwendung im Code bestimmt.

(Geerbt von TemplateControl)
BindingContainer

Ruft das Steuerelement ab, das die Datenbindung dieses Steuerelements enthält.

(Geerbt von Control)
Cache

Ruft das Cache-Objekt ab, das der Anwendung zugeordnet ist, die das Benutzersteuerelement enthält.

(Geerbt von UserControl)
CachePolicy

Ruft einen Verweis auf eine Auflistung von Zwischenspeicherungsparametern für dieses Benutzersteuerelement ab.

(Geerbt von UserControl)
ChildControlsCreated

Ruft einen Wert ab, der angibt, ob die untergeordneten Steuerelemente des Serversteuerelements erstellt wurden.

(Geerbt von Control)
ClientID

Ruft die Steuerelement-ID für HTML-Markup ab, das von ASP.NET generiert wird.

(Geerbt von Control)
ClientIDMode

Ruft den Algorithmus ab, mit dem der Wert der ClientID-Eigenschaft generiert wird, oder legt diesen fest.

(Geerbt von Control)
ClientIDSeparator

Ruft einen Zeichenwert ab, der das in der ClientID-Eigenschaft verwendete Trennzeichen darstellt.

(Geerbt von Control)
ContentPlaceHolders

Ruft eine Liste von ContentPlaceHolder-Steuerelementen ab, mit deren Hilfe die Masterseite andere Inhaltsbereiche definiert.

ContentTemplates

Ruft eine Liste von Inhaltssteuerelementen ab, die der Masterseite zugeordnet sind.

Context

Ruft das dem Serversteuerelement für die aktuelle Webanforderung zugeordnete HttpContext-Objekt ab.

(Geerbt von Control)
Controls

Ruft ein ControlCollection-Objekt ab, das die untergeordneten Steuerelemente für ein angegebenes Serversteuerelement in der Hierarchie der Benutzeroberfläche darstellt.

(Geerbt von Control)
DataItemContainer

Ruft einen Verweis auf den Namenscontainer ab, wenn vom Namenscontainer IDataItemContainer implementiert wird.

(Geerbt von Control)
DataKeysContainer

Ruft einen Verweis auf den Namenscontainer ab, wenn vom Namenscontainer IDataKeysControl implementiert wird.

(Geerbt von Control)
DesignMode

Ruft einen Wert ab, der angibt, ob ein Steuerelement auf einer Entwurfsoberfläche verwendet wird.

(Geerbt von Control)
EnableTheming

Ruft einen booleschen Wert ab, der angibt, ob Designs für das Steuerelement gelten, das von der TemplateControl-Klasse abgeleitet wird, oder legt diesen Wert fest.

(Geerbt von TemplateControl)
EnableViewState

Ruft einen Wert ab, der dem anfordernden Client angibt, ob das Serversteuerelement seinen Ansichtszustand sowie den Ansichtszustand von jedem enthaltenen untergeordneten Steuerelement beibehält, oder legt diesen fest.

(Geerbt von Control)
Events

Ruft eine Liste von Ereignishandlerdelegaten für das Steuerelement ab. Diese Eigenschaft ist schreibgeschützt.

(Geerbt von Control)
HasChildViewState

Ruft einen Wert ab, der angibt, ob in den untergeordneten Steuerelementen des aktuellen Serversteuerelements gespeicherte Einstellungen für den Ansichtszustand vorhanden sind.

(Geerbt von Control)
ID

Ruft den programmgesteuerten Bezeichner ab, der dem Serversteuerelement zugewiesen ist, oder legt diesen fest.

(Geerbt von Control)
IdSeparator

Ruft das als Trennzeichen für Steuerelementbezeichner verwendete Zeichen ab.

(Geerbt von Control)
IsChildControlStateCleared

Ruft einen Wert ab, der angibt, ob in diesem Steuerelements enthaltene Steuerelemente über einen Steuerelementzustand verfügen.

(Geerbt von Control)
IsPostBack

Ruft einen Wert ab, der angibt, ob das Benutzersteuerelement als Antwort auf ein Postback des Clients geladen wird oder ob das Laden und der Zugriff zum ersten Mal erfolgen.

(Geerbt von UserControl)
IsTrackingViewState

Ruft einen Wert ab, der angibt, ob das Serversteuerelement Änderungen des Ansichtszustands speichert.

(Geerbt von Control)
IsViewStateEnabled

Ruft einen Wert ab, der angibt, ob der Ansichtszustand für dieses Steuerelement aktiviert ist.

(Geerbt von Control)
LoadViewStateByID

Ruft einen Wert ab, der angibt, ob das Steuerelement seinen Ansichtszustand über ID anstatt über den Index lädt.

(Geerbt von Control)
Master

Ruft die übergeordnete Masterseite des aktuellen Masters in Szenarios mit geschachtelten Masterseiten ab.

MasterPageFile

Ruft den Namen der Masterseite ab, die den aktuellen Inhalt enthält, oder legt diesen fest.

NamingContainer

Ruft einen Verweis auf den Benennungscontainer des Serversteuerelements ab, der einen eindeutigen Namespace erstellt, damit zwischen Serversteuerelementen mit demselben ID-Eigenschaftswert unterschieden werden kann.

(Geerbt von Control)
Page

Ruft einen Verweis auf die Page-Instanz ab, die das Serversteuerelement enthält.

(Geerbt von Control)
Parent

Ruft einen Verweis auf das übergeordnete Steuerelement des Serversteuerelements in der Steuerelementhierarchie der Seite ab.

(Geerbt von Control)
RenderingCompatibility

Ruft einen Wert ab, der die ASP.NET-Version angibt, mit der gerenderte HTML-Objekte kompatibel sind.

(Geerbt von Control)
Request

Ruft das HttpRequest-Objekt für die aktuelle Webanforderung ab.

(Geerbt von UserControl)
Response

Ruft das HttpResponse-Objekt für die aktuelle Webanforderung ab.

(Geerbt von UserControl)
Server

Ruft das HttpServerUtility-Objekt für die aktuelle Webanforderung ab.

(Geerbt von UserControl)
Session

Ruft das HttpSessionState-Objekt für die aktuelle Webanforderung ab.

(Geerbt von UserControl)
Site

Ruft Informationen zum Container ab, der das aktuelle Steuerelement hostet, wenn es auf einer Entwurfsoberfläche gerendert wird.

(Geerbt von Control)
SkinID

Ruft das Design ab, das auf das Steuerelement angewendet werden soll.

(Geerbt von Control)
SupportAutoEvents

Ruft einen Wert ab, der angibt, ob das TemplateControl-Steuerelement automatische Ereignisse unterstützt.

(Geerbt von TemplateControl)
TemplateControl

Ruft einen Verweis auf die Vorlage ab, die dieses Steuerelement enthält, oder legt den Verweis fest.

(Geerbt von Control)
TemplateSourceDirectory

Ruft das virtuelle Verzeichnis der Page oder des UserControl ab, in dem das aktuelle Serversteuerelement enthalten ist.

(Geerbt von Control)
Trace

Ruft das TraceContext-Objekt für die aktuelle Webanforderung ab.

(Geerbt von UserControl)
UniqueID

Ruft den eindeutigen, hierarchisierten Bezeichner für das Serversteuerelement ab.

(Geerbt von Control)
ValidateRequestMode

Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob das Steuerelement Clienteingaben des Browser auf gefährliche Werte überprüft.

(Geerbt von Control)
ViewState

Ruft ein Wörterbuch mit Zustandsinformationen ab, mit dem Sie den Ansichtszustand eines Serversteuerelements über mehrere Anforderungen für dieselbe Seite hinweg speichern und wiederherstellen können.

(Geerbt von Control)
ViewStateIgnoresCase

Ruft einen Wert ab, der angibt, ob bei dem StateBag-Objekt die Groß- und Kleinschreibung nicht berücksichtigt wird.

(Geerbt von Control)
ViewStateMode

Ruft den Ansichtszustandsmodus des Steuerelements ab oder legt ihn fest.

(Geerbt von Control)
Visible

Ruft einen Wert ab, der angibt, ob ein Serversteuerelement auf der Seite als Benutzeroberfläche gerendert wird.

(Geerbt von Control)

Methoden

AddContentTemplate(String, ITemplate)

Fügt dem Content-Wörterbuch ein ContentTemplates-Steuerelement hinzu.

AddedControl(Control, Int32)

Wird aufgerufen, nachdem ein untergeordnetes Steuerelement zur Controls-Auflistung des Control-Objekts hinzugefügt wurde.

(Geerbt von Control)
AddParsedSubObject(Object)

Benachrichtigt das Serversteuerelement, dass entweder ein XML-Element oder HTML-Element analysiert wurde, und fügt das Element dem ControlCollection-Objekt des Serversteuerelements hinzu.

(Geerbt von Control)
ApplyStyleSheetSkin(Page)

Übernimmt die im Stylesheet der Seite definierten Stileigenschaften für das Steuerelement.

(Geerbt von Control)
BeginRenderTracing(TextWriter, Object)

Startet die Entwurfszeitablaufverfolgung des Renderns von Daten.

(Geerbt von Control)
BuildProfileTree(String, Boolean)

Sammelt Informationen zum Serversteuerelement und übermittelt sie an die Trace-Eigenschaft, sodass diese angezeigt werden, wenn die Ablaufverfolgung für die Seite aktiviert ist.

(Geerbt von Control)
ClearCachedClientID()

Legt den zwischengespeicherten ClientID-Wert auf null fest.

(Geerbt von Control)
ClearChildControlState()

Löscht die Informationen zum Steuerelementzustand für die untergeordneten Steuerelemente des Serversteuerelements.

(Geerbt von Control)
ClearChildState()

Löscht die Informationen zum Ansichtszustand sowie zum Steuerelementzustand für alle untergeordneten Steuerelemente des Serversteuerelements.

(Geerbt von Control)
ClearChildViewState()

Löscht die Informationen über den Ansichtszustand für alle untergeordneten Steuerelemente des Serversteuerelements.

(Geerbt von Control)
ClearEffectiveClientIDMode()

Legt die ClientIDMode-Eigenschaft der aktuellen Steuerelementinstanz und aller untergeordneten Steuerelemente auf Inherit fest.

(Geerbt von Control)
Construct()

Führt die Entwurfszeitlogik aus.

(Geerbt von TemplateControl)
CreateChildControls()

Wird durch das ASP.NET-Seitenframework aufgerufen, um Serversteuerelemente anzuweisen, die eine kompositionsbasierte Implementierung verwenden, um alle untergeordneten Steuerelemente zu erstellen, die sie in Vorbereitung auf ein Postback oder Rendering enthalten.

(Geerbt von Control)
CreateControlCollection()

Erstellt ein neues ControlCollection-Objekt, das die untergeordneten Steuerelemente (sowohl literale als auch Serversteuerelemente) des Serversteuerelements enthält.

(Geerbt von Control)
CreateResourceBasedLiteralControl(Int32, Int32, Boolean)

Greift auf die in einer Ressource gespeicherten Literalzeichenfolgen zu. Die CreateResourceBasedLiteralControl(Int32, Int32, Boolean)-Methode ist nicht für die Verwendung aus dem Code heraus vorgesehen.

(Geerbt von TemplateControl)
DataBind()

Bindet eine Datenquelle an das aufgerufene Serversteuerelement und alle untergeordneten Steuerelemente.

(Geerbt von Control)
DataBind(Boolean)

Bindet eine Datenquelle an das aufgerufene Serversteuerelement und alle untergeordneten Steuerelemente mit der Option, das DataBinding-Ereignis auszulösen.

(Geerbt von Control)
DataBindChildren()

Bindet eine Datenquelle an die untergeordneten Steuerelemente des Serversteuerelements.

(Geerbt von Control)
DesignerInitialize()

Führt alle für RAD-Designer erforderlichen Initialisierungsschritte am Benutzersteuerelement aus.

(Geerbt von UserControl)
Dispose()

Ermöglicht es einem Serversteuerelement, die letzte Bereinigung durchzuführen, bevor es aus dem Speicher freigegeben wird.

(Geerbt von Control)
EndRenderTracing(TextWriter, Object)

Beendet die Entwurfszeitablaufverfolgung des Renderns von Daten.

(Geerbt von Control)
EnsureChildControls()

Stellt fest, ob das Serversteuerelement untergeordnete Steuerelemente enthält. Wenn das nicht der Fall ist, werden untergeordnete Steuerelemente erstellt.

(Geerbt von Control)
EnsureID()

Erstellt einen Bezeichner für Steuerelemente, die nicht über einen zugewiesenen Bezeichner verfügen.

(Geerbt von Control)
Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
Eval(String)

Wertet einen Datenbindungsausdruck aus.

(Geerbt von TemplateControl)
Eval(String, String)

Wertet mithilfe der angegebenen Formatzeichenfolge einen XPath-Datenbindungsausdruck aus und zeigt das Ergebnis an.

(Geerbt von TemplateControl)
FindControl(String)

Durchsucht den aktuellen Benennungscontainer nach dem angegebenen Serversteuerelement mit dem angegebenen id-Parameter.

(Geerbt von Control)
FindControl(String, Int32)

Durchsucht den aktuellen Benennungscontainer nach einem Serversteuerelement mit der angegebenen id und einer ganzen Zahl, die im pathOffset-Parameter angegeben ist, der die Suche unterstützt. Sie sollten diese Version der FindControl-Methode nicht überschreiben.

(Geerbt von Control)
Focus()

Legt den Eingabefokus auf ein Steuerelement fest.

(Geerbt von Control)
FrameworkInitialize()

Initialisiert das Steuerelement, das von der TemplateControl-Klasse abgeleitet wurde.

(Geerbt von TemplateControl)
GetDesignModeState()

Ruft die Entwurfszeitdaten für ein Steuerelement ab.

(Geerbt von Control)
GetGlobalResourceObject(String, String)

Ruft auf der Grundlage der angegebenen ClassKey-Eigenschaft und ResourceKey-Eigenschaft ein Ressourcenobjekt auf Anwendungsebene ab.

(Geerbt von TemplateControl)
GetGlobalResourceObject(String, String, Type, String)

Ruft ein Ressourcenobjekt auf Anwendungsebene ab, das auf den Angaben zur ClassKey-Eigenschaft und zur ResourceKey-Eigenschaft, zum Objekttyp und zum Eigenschaftennamen der Ressource basiert.

(Geerbt von TemplateControl)
GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetLocalResourceObject(String)

Ruft auf der Grundlage der angegebenen ResourceKey-Eigenschaft ein Ressourcenobjekt auf Seitenebene ab.

(Geerbt von TemplateControl)
GetLocalResourceObject(String, Type, String)

Ruft auf der Grundlage der angegebenen ResourceKey-Eigenschaft sowie des angegebenen Objekttyps und Eigenschaftennamens ein Ressourcenobjekt auf Seitenebene ab.

(Geerbt von TemplateControl)
GetRouteUrl(Object)

Ruft die URL ab, die einem Satz von Routenparametern entspricht.

(Geerbt von Control)
GetRouteUrl(RouteValueDictionary)

Ruft die URL ab, die einem Satz von Routenparametern entspricht.

(Geerbt von Control)
GetRouteUrl(String, Object)

Ruft die URL ab, die einem Satz von Routenparametern und einem Routennamen entspricht.

(Geerbt von Control)
GetRouteUrl(String, RouteValueDictionary)

Ruft die URL ab, die einem Satz von Routenparametern und einem Routennamen entspricht.

(Geerbt von Control)
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
GetUniqueIDRelativeTo(Control)

Gibt den mit einem Präfix versehenen Abschnitt der UniqueID-Eigenschaft des angegebenen Steuerelements zurück.

(Geerbt von Control)
HasControls()

Ermittelt, ob das Serversteuerelement untergeordnete Steuerelemente enthält.

(Geerbt von Control)
HasEvents()

Gibt einen Wert zurück, der angibt, ob Ereignisse für das Steuerelement oder für untergeordnete Steuerelemente registriert werden.

(Geerbt von Control)
InitializeAsUserControl(Page)

Initialisiert das deklarativ erstellte UserControl-Objekt. Da einige Unterschiede zwischen Seiten und Benutzersteuerelementen bestehen, stellt diese Methode sicher, dass das Benutzersteuerelement fehlerfrei initialisiert wird.

(Geerbt von UserControl)
InstantiateInContentPlaceHolder(Control, ITemplate)

Stellt eine Methode bereit, um das aktuelle Vorlagensteuerelement auf eine Seite festzulegen, die die Masterseite besitzt.

IsLiteralContent()

Ermittelt, ob das Serversteuerelement nur literalen Inhalt enthält.

(Geerbt von Control)
LoadControl(String)

Lädt ein Control-Objekt aus einer Datei auf der Grundlage eines angegebenen virtuellen Pfads.

(Geerbt von TemplateControl)
LoadControl(Type, Object[])

Lädt auf der Grundlage eines angegebenen Typs und der angegebenen Konstruktorparameter ein Control-Objekt.

(Geerbt von TemplateControl)
LoadControlState(Object)

Stellt die Informationen zum Steuerelementzustand aus einer früheren Seitenanforderung wieder her, die durch die SaveControlState()-Methode gespeichert wurden.

(Geerbt von Control)
LoadTemplate(String)

Ruft aus einer externen Datei eine Instanz der ITemplate-Schnittstelle ab.

(Geerbt von TemplateControl)
LoadViewState(Object)

Stellt die Ansichtszustandsinformationen aus einer früheren Benutzersteuerelementanforderung wieder her, die von der SaveViewState()-Methode gespeichert wurde.

(Geerbt von UserControl)
MapPath(String)

Weist einem physischen Dateipfad einen absoluten oder relativen virtuellen Dateipfad zu.

(Geerbt von UserControl)
MapPathSecure(String)

Ruft den physikalischen Pfad ab, auf den ein absoluter bzw. relativer virtueller Pfad verweist.

(Geerbt von Control)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
OnAbortTransaction(EventArgs)

Löst das AbortTransaction-Ereignis aus.

(Geerbt von TemplateControl)
OnBubbleEvent(Object, EventArgs)

Bestimmt, ob das Ereignis für das Serversteuerelement in der UI-Serversteuerelementhierarchie der Seite nach oben übergeben wird.

(Geerbt von Control)
OnCommitTransaction(EventArgs)

Löst das CommitTransaction-Ereignis aus.

(Geerbt von TemplateControl)
OnDataBinding(EventArgs)

Löst das DataBinding-Ereignis aus.

(Geerbt von Control)
OnError(EventArgs)

Löst das Error-Ereignis aus.

(Geerbt von TemplateControl)
OnInit(EventArgs)

Löst das Init-Ereignis aus.

(Geerbt von UserControl)
OnLoad(EventArgs)

Löst das Load-Ereignis aus.

(Geerbt von Control)
OnPreRender(EventArgs)

Löst das PreRender-Ereignis aus.

(Geerbt von Control)
OnUnload(EventArgs)

Löst das Unload-Ereignis aus.

(Geerbt von Control)
OpenFile(String)

Ruft einen Stream zum Lesen einer Datei ab.

(Geerbt von Control)
ParseControl(String)

Analysiert eine Eingabezeichenfolge für ein Control-Objekt in einer Web Forms-Seite oder einem Benutzersteuerelement.

(Geerbt von TemplateControl)
ParseControl(String, Boolean)

Analysiert eine Eingabezeichenfolge für ein Control-Objekt auf einer ASP.NET-Webseite oder in einem Benutzersteuerelement.

(Geerbt von TemplateControl)
RaiseBubbleEvent(Object, EventArgs)

Weist dem übergeordneten Element des Steuerelements alle Ereignisquellen und zugehörige Informationen zu.

(Geerbt von Control)
ReadStringResource()

Liest eine Zeichenfolgenressource. Die ReadStringResource()-Methode ist nicht für die Verwendung aus dem Code heraus vorgesehen.

(Geerbt von TemplateControl)
RemovedControl(Control)

Wird aufgerufen, nachdem ein untergeordnetes Steuerelement aus der Controls-Auflistung des Control-Objekts entfernt wurde.

(Geerbt von Control)
Render(HtmlTextWriter)

Sendet den Inhalt des Steuerelements an ein angegebenes HtmlTextWriter-Objekt, das den auf dem Client zu rendernden Inhalt schreibt.

(Geerbt von Control)
RenderChildren(HtmlTextWriter)

Gibt den Inhalt der untergeordneten Elemente eines Serversteuerelements an ein bereitgestelltes HtmlTextWriter-Objekt aus, das den auf dem Client zu rendernden Inhalt schreibt.

(Geerbt von Control)
RenderControl(HtmlTextWriter)

Gibt Inhalte von Serversteuerelementen an ein bereitgestelltes HtmlTextWriter-Objekt aus und speichert Ablaufverfolgungsinformationen zum Steuerelement, sofern die Ablaufverfolgung aktiviert ist.

(Geerbt von Control)
RenderControl(HtmlTextWriter, ControlAdapter)

Gibt Inhalte von Serversteuerelementen mithilfe eines bereitgestellten HtmlTextWriter-Objekts an ein bereitgestelltes ControlAdapter-Objekt aus.

(Geerbt von Control)
ResolveAdapter()

Ruft den Steuerelementadapter ab, der für das Rendern des angegebenen Steuerelements verantwortlich ist.

(Geerbt von Control)
ResolveClientUrl(String)

Ruft eine URL ab, die vom Browser verwendet werden kann.

(Geerbt von Control)
ResolveUrl(String)

Konvertiert eine URL in eine vom anfordernden Client verwendbare URL.

(Geerbt von Control)
SaveControlState()

Speichert alle Zustandsänderungen des Serversteuerelements, die seit dem Zeitpunkt aufgetreten sind, zu dem die Seite an den Server zurückgesendet wurde.

(Geerbt von Control)
SaveViewState()

Speichert alle Änderungen im Ansichtszustand des Steuerelements, die seit dem letzten Postback der Seite aufgetreten sind.

(Geerbt von UserControl)
SetDesignModeState(IDictionary)

Legt die Entwurfszeitdaten für ein Steuerelement fest.

(Geerbt von Control)
SetRenderMethodDelegate(RenderMethod)

Beauftragt einen Ereignishandlerdelegaten, das Serversteuerelement und seinen Inhalt im übergeordneten Steuerelement zu rendern.

(Geerbt von Control)
SetStringResourcePointer(Object, Int32)

Legt einen Zeiger auf eine Zeichenfolgenressource fest. Die SetStringResourcePointer(Object, Int32)-Methode wird von generierten Klassen verwendet und ist nicht für die direkte Verwendung im Code vorgesehen.

(Geerbt von TemplateControl)
SetTraceData(Object, Object)

Legt Ablaufverfolgungsdaten für die Nachverfolgung der Entwurfszeit von Rendering-Daten mithilfe des Ablaufverfolgungsdatenschlüssels und Ablaufverfolgungsdatenwerts fest.

(Geerbt von Control)
SetTraceData(Object, Object, Object)

Legt Ablaufverfolgungsdaten für die Nachverfolgung der Entwurfszeit von Rendering-Daten mithilfe des verfolgten Objekts, des Ablaufverfolgungsdatenschlüssels und Ablaufverfolgungsdatenwerts fest.

(Geerbt von Control)
TestDeviceFilter(String)

Gibt einen booleschen Wert zurück, der angibt, ob ein Gerätefilter auf die HTTP-Anforderung angewendet wird.

(Geerbt von TemplateControl)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)
TrackViewState()

Veranlasst die Überwachung von Änderungen am Ansichtszustand des Serversteuerelements, sodass die Änderungen im StateBag-Objekt des Serversteuerelements gespeichert werden können. Auf dieses Objekt kann über die ViewState-Eigenschaft zugegriffen werden.

(Geerbt von Control)
TryUpdateModel<TModel>(TModel)

Versucht, die Modellinstanz mit Werten vom datengebundenen Steuerelement zu aktualisieren.

(Geerbt von UserControl)
TryUpdateModel<TModel>(TModel, IValueProvider)

Versucht, die Modellinstanz mit Werten vom Wertanbieter zu aktualisieren.

(Geerbt von UserControl)
UpdateModel<TModel>(TModel)

Aktualisiert die Modellinstanz mithilfe von Werten aus dem datengebundenen Steuerelement.

(Geerbt von UserControl)
UpdateModel<TModel>(TModel, IValueProvider)

Aktualisiert die angegebene Modellinstanz mit von Werten vom Wertanbieter des Benutzersteuerelements.

(Geerbt von UserControl)
WriteUTF8ResourceString(HtmlTextWriter, Int32, Int32, Boolean)

Schreibt eine Ressourcenzeichenfolge in ein HtmlTextWriter-Steuerelement. Die WriteUTF8ResourceString(HtmlTextWriter, Int32, Int32, Boolean)-Methode wird von generierten Klassen verwendet und ist nicht für die direkte Verwendung im Code vorgesehen.

(Geerbt von TemplateControl)
XPath(String)

Wertet einen XPath-Datenbindungsausdruck aus.

(Geerbt von TemplateControl)
XPath(String, IXmlNamespaceResolver)

Wertet einen XPath-Datenbindungsausdruck mithilfe der angegebenen Präfix- und Namespacezuordnungen für die Namespaceauflösung aus.

(Geerbt von TemplateControl)
XPath(String, String)

Wertet mithilfe der angegebenen Formatzeichenfolge einen XPath-Datenbindungsausdruck aus und zeigt das Ergebnis an.

(Geerbt von TemplateControl)
XPath(String, String, IXmlNamespaceResolver)

Wertet einen XPath-Datenbindungsausdruck mithilfe der angegebenen Präfix- und Namespacezuordnungen für die Namespaceauflösung aus und zeigt mit der angegebenen Formatzeichenfolge das Ergebnis an.

(Geerbt von TemplateControl)
XPathSelect(String)

Wertet einen XPath-Datenbindungsausdruck aus und gibt eine Knotenauflistung zurück, die die IEnumerable-Schnittstelle implementiert.

(Geerbt von TemplateControl)
XPathSelect(String, IXmlNamespaceResolver)

Wertet einen XPath-Datenbindungsausdruck mithilfe der angegebenen Präfix- und Namespacezuordnungen für die Namespaceauflösung aus und gibt eine Knotenauflistung zurück, die die IEnumerable-Schnittstelle implementiert.

(Geerbt von TemplateControl)

Ereignisse

AbortTransaction

Tritt ein, wenn ein Benutzer eine Transaktion beendet.

(Geerbt von TemplateControl)
CommitTransaction

Tritt ein, wenn eine Transaktion abgeschlossen wird.

(Geerbt von TemplateControl)
DataBinding

Tritt ein, wenn das Serversteuerelement eine Bindung an eine Datenquelle durchführt.

(Geerbt von Control)
Disposed

Tritt ein, wenn ein Serversteuerelement im Speicher freigegeben wird. Dies ist die letzte Stufe des Lebenszyklus des Serversteuerelements bei der Anforderung einer ASP.NET-Seite.

(Geerbt von Control)
Error

Tritt beim Auslösen einer nicht behandelten Ausnahme ein.

(Geerbt von TemplateControl)
Init

Tritt bei der Initialisierung des Serversteuerelements ein. Dies ist der erste Schritt in dessen Lebenszyklus.

(Geerbt von Control)
Load

Tritt ein, wenn das Serversteuerelement in das Page-Objekt geladen wird.

(Geerbt von Control)
PreRender

Tritt nach dem Laden des Control-Objekts, jedoch vor dem Rendern ein.

(Geerbt von Control)
Unload

Tritt ein, wenn das Serversteuerelement aus dem Speicher entladen wird.

(Geerbt von Control)

Explizite Schnittstellenimplementierungen

IAttributeAccessor.GetAttribute(String)

Gibt den Wert des angegebenen Benutzersteuerelement-Attributs zurück.

(Geerbt von UserControl)
IAttributeAccessor.SetAttribute(String, String)

Legt den Wert des angegebenen Benutzersteuerelement-Attributs fest.

(Geerbt von UserControl)
IControlBuilderAccessor.ControlBuilder

Eine Beschreibung dieses Elements finden Sie unter ControlBuilder.

(Geerbt von Control)
IControlDesignerAccessor.GetDesignModeState()

Eine Beschreibung dieses Elements finden Sie unter GetDesignModeState().

(Geerbt von Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Eine Beschreibung dieses Elements finden Sie unter SetDesignModeState(IDictionary).

(Geerbt von Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Eine Beschreibung dieses Elements finden Sie unter SetOwnerControl(Control).

(Geerbt von Control)
IControlDesignerAccessor.UserData

Eine Beschreibung dieses Elements finden Sie unter UserData.

(Geerbt von Control)
IDataBindingsAccessor.DataBindings

Eine Beschreibung dieses Elements finden Sie unter DataBindings.

(Geerbt von Control)
IDataBindingsAccessor.HasDataBindings

Eine Beschreibung dieses Elements finden Sie unter HasDataBindings.

(Geerbt von Control)
IExpressionsAccessor.Expressions

Eine Beschreibung dieses Elements finden Sie unter Expressions.

(Geerbt von Control)
IExpressionsAccessor.HasExpressions

Eine Beschreibung dieses Elements finden Sie unter HasExpressions.

(Geerbt von Control)
IFilterResolutionService.CompareFilters(String, String)

Gibt einen Wert zurück, der angibt, ob zwischen zwei angegeben Gerätefiltern eine Beziehung zwischen übergeordnetem und untergeordnetem Element existiert.

(Geerbt von TemplateControl)
IFilterResolutionService.EvaluateFilter(String)

Gibt einen Wert zurück, der angibt, ob der angegebene Filter ein Typ des aktuellen Filterobjekts ist.

(Geerbt von TemplateControl)
IParserAccessor.AddParsedSubObject(Object)

Eine Beschreibung dieses Elements finden Sie unter AddParsedSubObject(Object).

(Geerbt von Control)
IUserControlDesignerAccessor.InnerText

Ruft den Text zwischen den öffnenden und schließenden Tags eines Benutzersteuerelements ab oder legt diesen fest.

(Geerbt von UserControl)
IUserControlDesignerAccessor.TagName

Ruft den vollständigen Tagnamen für das Benutzersteuerelement ab oder legt diesen fest.

(Geerbt von UserControl)

Erweiterungsmethoden

FindDataSourceControl(Control)

Gibt die Datenquelle zurück, die dem Datensteuerelement für das angegebene Steuerelement zugeordnet ist.

FindFieldTemplate(Control, String)

Gibt die Feldvorlage für die angegebene Spalte im Benennungscontainer des angegebenen Steuerelements zurück.

FindMetaTable(Control)

Gibt das Metatabellenobjekt für das enthaltende Datensteuerelement zurück.

GetDefaultValues(INamingContainer)

Ruft die Auflistung der Standardwerte für das angegebene Datensteuerelement ab.

GetMetaTable(INamingContainer)

Ruft die Tabellenmetadaten für das angegebene Datensteuerelement ab.

SetMetaTable(INamingContainer, MetaTable)

Legt die Tabellenmetadaten für das angegebene Datensteuerelement fest.

SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>)

Legt die Zuordnung für Tabellenmetadaten und Standardwerte für das angegebene Datensteuerelement fest.

SetMetaTable(INamingContainer, MetaTable, Object)

Legt die Zuordnung für Tabellenmetadaten und Standardwerte für das angegebene Datensteuerelement fest.

TryGetMetaTable(INamingContainer, MetaTable)

Bestimmt, ob Tabellenmetadaten verfügbar sind.

EnableDynamicData(INamingContainer, Type)

Aktiviert das Verhalten dynamischer Daten für das angegebene Datensteuerelement

EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>)

Aktiviert das Verhalten dynamischer Daten für das angegebene Datensteuerelement

EnableDynamicData(INamingContainer, Type, Object)

Aktiviert das Verhalten dynamischer Daten für das angegebene Datensteuerelement

Gilt für:

Weitere Informationen