AppearanceEditorPart Klasse
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.
Stellt ein Editor-Steuerelement bereit, mit dem Endbenutzer mehrere Benutzeroberflächeneigenschaften für ein zugeordnetes WebPart Steuerelement bearbeiten können. Diese Klasse kann nicht vererbt werden.
public ref class AppearanceEditorPart sealed : System::Web::UI::WebControls::WebParts::EditorPartpublic sealed class AppearanceEditorPart : System.Web.UI.WebControls.WebParts.EditorParttype AppearanceEditorPart = class
inherit EditorPartPublic NotInheritable Class AppearanceEditorPart
Inherits EditorPart- Vererbung
Beispiele
Im folgenden Codebeispiel wird veranschaulicht, wie sie ein AppearanceEditorPart Steuerelement auf einer Webseite deklarieren und es ermöglichen, mehrere UI-Eigenschaften eines WebPart Steuerelements zu bearbeiten. Das Codebeispiel enthält vier Teile:
Ein Benutzersteuerelement, mit dem Sie Anzeigemodi auf einer Webparts-Seite ändern können.
Eine Webseite, die ein EditorZone Steuerelement und ein AppearanceEditorPart Steuerelement enthält, zusammen mit einem Verweis auf ein benutzerdefiniertes WebPart Steuerelement.
Eine Klasse, die ein benutzerdefiniertes WebPart Steuerelement enthält.
Eine Erläuterung der Funktionsweise des Beispiels beim Laden der Seite in einem Browser.
Der Quellcode für das Benutzersteuerelement stammt aus einem anderen Thema. Damit dieses Codebeispiel funktioniert, müssen Sie die ASCX-Datei für das Benutzersteuerelement aus der exemplarischen Vorgehensweise abrufen: Ändern von Anzeigemodi in einem Webpart-Seitenthema und Platzieren der Datei im selben Ordner wie die .aspx Seite in diesem Codebeispiel.
Der zweite Teil des Codebeispiels ist die Webseite. Es enthält einen deklarativen Verweis auf ein EditorZone Steuerelement mit einem untergeordneten <zonetemplate> Element, das deklarative Verweise auf ein AppearanceEditorPart Steuerelement enthält. Außerdem verweist die Seite auf das benutzerdefinierte WebPart Steuerelement, wobei eine Register Direktive für die Assembly und das <aspSample:TextDisplayWebPart> Element für das Steuerelement verwendet wird.
<%@ page language="c#" %>
<%@ register TagPrefix="uc1"
TagName="DisplayModeMenu"
Src="DisplayModecs.ascx" %>
<%@ register tagprefix="aspSample"
Namespace="Samples.AspNet.CS.Controls"
Assembly="TextDisplayWebPartCS" %>
<!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 id="Head1" runat="server">
<title>
Text Display WebPart with AppearanceEditorPart
</title>
</head>
<body>
<form id="form1" runat="server">
<asp:webpartmanager id="WebPartManager1" runat="server" />
<uc1:DisplayModeMenu ID="DisplayModeMenu1" runat="server" />
<asp:webpartzone id="zone1" runat="server">
<zonetemplate>
<aspSample:TextDisplayWebPart
runat="server"
id="textwebpart"
title = "Text Content WebPart" />
</zonetemplate>
</asp:webpartzone>
<asp:EditorZone ID="EditorZone1" runat="server">
<ZoneTemplate>
<asp:AppearanceEditorPart ID="AppearanceEditorPart1"
runat="server"
Title="Edit TextDisplayWebPart Properties" />
</ZoneTemplate>
</asp:EditorZone>
</form>
</body>
</html>
<%@ page language="vb" %>
<%@ register TagPrefix="uc1"
TagName="DisplayModeMenu"
Src="DisplayModevb.ascx" %>
<%@ register tagprefix="aspSample"
Namespace="Samples.AspNet.VB.Controls"
Assembly="TextDisplayWebPartVB" %>
<!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 id="Head1" runat="server">
<title>
Text Display WebPart with AppearanceEditorPart
</title>
</head>
<body>
<form id="form1" runat="server">
<asp:webpartmanager id="WebPartManager1" runat="server" />
<uc1:DisplayModeMenu ID="DisplayModeMenu1" runat="server" />
<asp:webpartzone id="zone1" runat="server">
<zonetemplate>
<aspSample:TextDisplayWebPart
runat="server"
id="textwebpart"
title = "Text Content WebPart" />
</zonetemplate>
</asp:webpartzone>
<asp:EditorZone ID="EditorZone1" runat="server">
<ZoneTemplate>
<asp:AppearanceEditorPart ID="AppearanceEditorPart1"
runat="server"
Title="Edit TextDisplayWebPart Properties" />
</ZoneTemplate>
</asp:EditorZone>
</form>
</body>
</html>
Der dritte Teil des Codebeispiels ist eine benutzerdefinierte WebPart Klasse mit dem Namen TextDisplayWebPart, auf die auf der Webseite verwiesen wird. Damit das Codebeispiel ausgeführt werden kann, müssen Sie diesen Quellcode kompilieren. Sie können sie explizit kompilieren und die resultierende Assembly im Ordner "Bin" ihrer Website oder im globalen Assemblycache ablegen. Alternativ können Sie den Quellcode im App_Code Ordner Ihrer Website ablegen, in dem er zur Laufzeit dynamisch kompiliert wird. Eine exemplarische Vorgehensweise, die das Kompilieren veranschaulicht, finden Sie unter Walkthrough: Developing and Using a Custom Web Server Control.
using System;
using System.Collections;
using System.ComponentModel;
using System.Drawing;
using System.Security.Permissions;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;
namespace Samples.AspNet.CS.Controls
{
[AspNetHostingPermission(SecurityAction.Demand,
Level = AspNetHostingPermissionLevel.Minimal)]
[AspNetHostingPermission(SecurityAction.InheritanceDemand,
Level = AspNetHostingPermissionLevel.Minimal)]
public class TextDisplayWebPart : WebPart
{
private String _contentText = null;
TextBox input;
Label DisplayContent;
Literal lineBreak;
[Personalizable(), WebBrowsable]
public String ContentText
{
get { return _contentText; }
set { _contentText = value; }
}
protected override void CreateChildControls()
{
Controls.Clear();
DisplayContent = new Label();
DisplayContent.BackColor = Color.LightBlue;
DisplayContent.Text = this.ContentText;
this.Controls.Add(DisplayContent);
lineBreak = new Literal();
lineBreak.Text = @"<br />";
Controls.Add(lineBreak);
input = new TextBox();
this.Controls.Add(input);
Button update = new Button();
update.Text = "Set Label Content";
update.Click += new EventHandler(this.submit_Click);
this.Controls.Add(update);
}
private void submit_Click(object sender, EventArgs e)
{
// Update the label string.
if (!string.IsNullOrEmpty(input.Text))
{
_contentText = input.Text + @"<br />";
input.Text = String.Empty;
DisplayContent.Text = this.ContentText;
}
}
}
}
Imports System.Collections
Imports System.ComponentModel
Imports System.Drawing
Imports System.Security.Permissions
Imports System.Web
Imports System.Web.UI
Imports System.Web.UI.WebControls
Imports System.Web.UI.WebControls.WebParts
Namespace Samples.AspNet.VB.Controls
<AspNetHostingPermission(SecurityAction.Demand, _
Level:=AspNetHostingPermissionLevel.Minimal)> _
<AspNetHostingPermission(SecurityAction.InheritanceDemand, _
Level:=AspNetHostingPermissionLevel.Minimal)> _
Public Class TextDisplayWebPart
Inherits WebPart
Private _contentText As String = Nothing
Private _fontStyle As String = Nothing
Private input As TextBox
Private DisplayContent As Label
Private lineBreak As Literal
<Personalizable(), WebBrowsable()> _
Public Property ContentText() As String
Get
Return _contentText
End Get
Set(ByVal value As String)
_contentText = value
End Set
End Property
Protected Overrides Sub CreateChildControls()
Controls.Clear()
DisplayContent = New Label()
DisplayContent.BackColor = Color.LightBlue
DisplayContent.Text = Me.ContentText
Me.Controls.Add(DisplayContent)
lineBreak = New Literal()
lineBreak.Text = "<br />"
Controls.Add(lineBreak)
input = New TextBox()
Me.Controls.Add(input)
Dim update As New Button()
update.Text = "Set Label Content"
AddHandler update.Click, AddressOf Me.submit_Click
Me.Controls.Add(update)
End Sub
Private Sub submit_Click(ByVal sender As Object, _
ByVal e As EventArgs)
' Update the label string.
If input.Text <> String.Empty Then
_contentText = input.Text + "<br />"
input.Text = String.Empty
DisplayContent.Text = Me.ContentText
End If
End Sub
End Class
End Namespace
Wenn Sie die Seite in einem Browser laden, können Sie im Dropdownsteuerelement "Anzeigemodus" den Bearbeitungsmodus auswählen, um zum Bearbeitungsmodus zu wechseln. Sie können auf das Verbenmenü (nach unten) in der Titelleiste des TextDisplayWebPart Steuerelements klicken und auf "Bearbeiten" klicken, um das Steuerelement zu bearbeiten. Wenn die Bearbeitungs-UI sichtbar ist, können Sie das AppearanceEditorPart Steuerelement sehen. Wenn Sie einige Änderungen an der Bearbeitungsbenutzeroberfläche vornehmen und auf die Schaltfläche " Übernehmen " klicken, können Sie die Dropdownliste " Anzeigemodus " verwenden, um die Seite im Navigationsmodus zurückzugeben und den vollständigen Effekt der Bearbeitungsänderungen anzuzeigen.
Hinweise
Die AppearanceEditorPart Klasse ist ein Editor-Steuerelement, das von der EditorPart Klasse abgeleitet wird und zum Bearbeiten von Eigenschaften verwendet wird, die sich auf das Erscheinungsbild eines zugeordneten WebPart oder anderen Serversteuerelements auswirken.
Mit dem AppearanceEditorPart Steuerelement können Endbenutzer mehrere Benutzeroberflächeneigenschaften eines WebPart Steuerelements bearbeiten. Der Typ des Steuerelements, das auf der Seite angezeigt wird, um jeden Eigenschaftswert zu bearbeiten, wird in der angrenzenden Zelle der folgenden Tabelle aufgeführt.
| Eigentum | Steuerelement zum Bearbeiten der Eigenschaft |
|---|---|
| Title | Ein TextBox Steuerelement wird verwendet, um den Text für den Titel festzulegen. |
| ChromeType | Ein DropDownList Steuerelement wird verwendet, um auszuwählen, welche Art von Titel- und Rahmenoption verwendet wird. |
| Direction | Ein DropDownList Steuerelement wird verwendet, um die Richtung auszuwählen, in die der Inhalt auf der Seite fließt. |
| Height | Ein TextBox Steuerelement wird verwendet, um eine Zahl für die Höhe festzulegen, und ein DropDownList Steuerelement wird verwendet, um die Einheiten auszuwählen. |
| Width | Ein TextBox Steuerelement wird verwendet, um eine Zahl für die Höhe festzulegen, und ein DropDownList Steuerelement wird verwendet, um die Einheiten auszuwählen. |
| Hidden | Ein CheckBox Steuerelement wird verwendet, um anzugeben, ob das Steuerelement ausgeblendet ist. |
Das AppearanceEditorPart Steuerelement wird nur angezeigt, wenn sich eine Webpartseite im Bearbeitungsmodus befindet und ein bestimmtes WebPart Steuerelement zur Bearbeitung ausgewählt wurde. Das AppearanceEditorPart Steuerelement befindet sich wie alle anderen EditorPart Steuerelemente in einer EditorZone Zone.
Von Bedeutung
Eine EditorZone Zone kann nur EditorPart Steuerelemente enthalten, und EditorPart Steuerelemente können nicht in einem anderen Zonentyp platziert werden.
Die AppearanceEditorPart Klasse verfügt über einen minimalen Satz von Eigenschaften. Die Title Eigenschaft wird verwendet, um eine Zeichenfolge abzurufen oder festzulegen, die als Titel angezeigt wird, wenn das Steuerelement sichtbar ist. Die DefaultButton Eigenschaft legt die geerbte Eigenschaft vom Panel Steuerelement fest, sodass das Standardsteuerelement, das den Fokus innerhalb des AppearanceEditorPart Steuerelements empfängt, mit dem Standard im Basissteuerelement Panel identisch ist.
Die AppearanceEditorPart Klasse verfügt auch über zwei wichtige Methoden. Die SyncChanges Methode überschreibt die Basismethode aus der EditorPart Klasse. Diese Methode ist wichtig, da sie das Abrufen der Eigenschaftswerte aus dem WebPart Steuerelement ermöglicht, das sie bearbeitet und den Feldern im Editor-Steuerelement zugewiesen wird. Die ApplyChanges Methode ist auch wichtig, da sie die vom Benutzer in den Bearbeitungssteuerelementen festgelegten Werte akzeptiert und diese Eigenschaftswerte für das zu bearbeitende Steuerelement aktualisiert.
In den meisten Fällen sollte das AppearanceEditorPart Steuerelement im Seitenpersistenzformat verwendet werden, indem ein Element innerhalb eines <asp:appearanceditorpart><zonetemplate> Elements deklariert wird, das wiederum von einem <asp:editorzone> Element auf einer Webseite enthalten ist.
Um andere Eigenschaften und Verhalten von WebPart Steuerelementen zu bearbeiten, können Sie die anderen EditorPart Steuerelemente verwenden, die mit dem Webpart-Steuerelementsatz bereitgestellt werden. Zu diesen Steuerelementen gehören die BehaviorEditorPart, die LayoutEditorPart, und die PropertyGridEditorPart. Die bereitgestellten EditorPart Steuerelemente sollten die meisten Bearbeitungsfeatures bereitstellen, die zum Bearbeiten WebPart von Steuerelementen erforderlich sind. Sie können jedoch auch ein benutzerdefiniertes Editor-Steuerelement erstellen, indem Sie von der EditorPart Klasse erben. Ein Codebeispiel finden Sie im EditorPart Thema "Klassenübersicht".
Hinweis
Um die Barrierefreiheit zu verbessern, wird das AppearanceEditorPart Steuerelement innerhalb eines <fieldset> Elements gerendert. Das <fieldset> Element gruppiert den zugehörigen Satz von Steuerelementen, die für die AppearanceEditorPart Bearbeitung im Steuerelement verwendet werden, und es erleichtert die Navigation zwischen diesen Steuerelementen für visuelle Steuerelemente (z. B. normale Webbrowser) und sprachorientierte Benutzer-Agents (z. B. Bildschirmlesesoftware).
Zugänglichkeit
Das standardmäßig für dieses Steuerelement gerenderte Markup entspricht möglicherweise nicht den Barrierefreiheitsstandards wie den Richtlinien für die Webinhaltsbarrierefreiheit 1.0 (WCAG) Priorität 1. Ausführliche Informationen zur Unterstützung der Barrierefreiheit für dieses Steuerelement finden Sie unter ASP.NET Steuerelemente und Barrierefreiheit.
Konstruktoren
| Name | Beschreibung |
|---|---|
| AppearanceEditorPart() |
Initialisiert eine neue Instanz der AppearanceEditorPart-Klasse. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| AccessKey |
Dient zum Abrufen oder Festlegen der Zugriffstaste, mit der Sie schnell zum Webserversteuerelement navigieren können. (Geerbt von WebControl) |
| Adapter |
Ruft den browserspezifischen Adapter für das Steuerelement ab. (Geerbt von Control) |
| AppRelativeTemplateSourceDirectory |
Dient zum Abrufen oder Festlegen des anwendungsrelativen virtuellen Verzeichnisses des Page Objekts UserControl , das dieses Steuerelement enthält. (Geerbt von Control) |
| Attributes |
Ruft die Auflistung beliebiger Attribute (nur für das Rendern) ab, die nicht den Eigenschaften des Steuerelements entsprechen. (Geerbt von WebControl) |
| BackColor |
Dient zum Abrufen oder Festlegen der Hintergrundfarbe des Webserversteuerelements. (Geerbt von WebControl) |
| BackImageUrl |
Dient zum Abrufen oder Festlegen der URL des Hintergrundbilds für das Panel-Steuerelement. (Geerbt von Panel) |
| BindingContainer |
Ruft das Steuerelement ab, das die Datenbindung dieses Steuerelements enthält. (Geerbt von Control) |
| BorderColor |
Ruft die Rahmenfarbe des Websteuerelements ab oder legt diese fest. (Geerbt von WebControl) |
| BorderStyle |
Dient zum Abrufen oder Festlegen des Rahmenstils des Webserversteuerelements. (Geerbt von WebControl) |
| BorderWidth |
Ruft die Rahmenbreite des Webserversteuerelements ab oder legt diese fest. (Geerbt von WebControl) |
| ChildControlsCreated |
Ruft einen Wert ab, der angibt, ob die untergeordneten Steuerelemente des Serversteuerelements erstellt wurden. (Geerbt von Control) |
| ChromeState |
Ruft ab oder legt fest, ob sich ein Teilsteuerelement in einem minimierten oder normalen Zustand befindet. (Geerbt von Part) |
| ChromeType |
Dient zum Abrufen oder Festlegen des Rahmentyps, der ein Webpart-Steuerelement umrahmt. (Geerbt von Part) |
| ClientID |
Ruft die Steuerelement-ID für HTML-Markup ab, das von ASP.NET generiert wird. (Geerbt von Control) |
| ClientIDMode |
Dient zum Abrufen oder Festlegen des Algorithmus, der zum Generieren des Werts der ClientID Eigenschaft verwendet wird. (Geerbt von Control) |
| ClientIDSeparator |
Ruft einen Zeichenwert ab, der das Trennzeichen darstellt, das in der ClientID Eigenschaft verwendet wird. (Geerbt von Control) |
| Context |
Ruft das Objekt ab, das HttpContext dem Serversteuerelement für die aktuelle Webanforderung zugeordnet ist. (Geerbt von Control) |
| Controls |
Ruft ein ControlCollection Objekt ab, das die untergeordneten Steuerelemente für ein angegebenes Serversteuerelement in der Benutzeroberflächenhierarchie enthält. (Geerbt von Part) |
| ControlStyle |
Ruft den Stil des Webserversteuerelements ab. Diese Eigenschaft wird hauptsächlich von Steuerelemententwicklern verwendet. (Geerbt von WebControl) |
| ControlStyleCreated |
Ruft einen Wert ab, der angibt, ob ein Style Objekt für die ControlStyle Eigenschaft erstellt wurde. Diese Eigenschaft wird in erster Linie von Steuerelemententwicklern verwendet. (Geerbt von WebControl) |
| CssClass |
Dient zum Abrufen oder Festlegen der Cascading StyleSheet (CSS)-Klasse, die vom Webserversteuerelement auf dem Client gerendert wird. (Geerbt von WebControl) |
| DataItemContainer |
Ruft einen Verweis auf den Benennungscontainer ab, wenn der Benennungscontainer IDataItemContainerimplementiert wird. (Geerbt von Control) |
| DataKeysContainer |
Ruft einen Verweis auf den Benennungscontainer ab, wenn der Benennungscontainer IDataKeysControlimplementiert wird. (Geerbt von Control) |
| DefaultButton |
Überschreibt die vom Steuerelement geerbte Panel Basiseigenschaft, um die Eigenschaft von Designern auszublenden und zu verhindern, dass sie von Designs betroffen ist. Obwohl es öffentlich ist, wird diese Eigenschaft für das Standardmäßige Rendering dieses Steuerelements verwendet und ist nicht für den Aufruf aus Entwicklercode vorgesehen. |
| Description |
Dient zum Abrufen oder Festlegen eines kurzen Ausdrucks, der zusammenfasst, was das Webpartsteuerelement tut, für die Verwendung in QuickInfos und Katalogen von Teilsteuerelementen. (Geerbt von Part) |
| DesignMode |
Ruft einen Wert ab, der angibt, ob ein Steuerelement auf einer Entwurfsoberfläche verwendet wird. (Geerbt von Control) |
| Direction |
Ruft ab oder legt die Richtung fest, in der Steuerelemente angezeigt werden, die Text in ein Panel Steuerelement enthalten. (Geerbt von Panel) |
| Display |
Ruft einen Wert ab, der angibt, ob ein Steuerelement angezeigt werden soll, wenn sich das zugeordnete WebPart Steuerelement im Bearbeitungsmodus befindet. (Geerbt von EditorPart) |
| DisplayTitle |
Ruft eine Zeichenfolge ab, die den Titeltext enthält, der in der Titelleiste eines EditorPart Steuerelements angezeigt wird. (Geerbt von EditorPart) |
| Enabled |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Webserversteuerelement aktiviert ist. (Geerbt von WebControl) |
| EnableTheming |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob Designs für dieses Steuerelement gelten. (Geerbt von WebControl) |
| EnableViewState |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Serversteuerelement den Ansichtszustand und den Ansichtszustand aller enthaltenen untergeordneten Steuerelemente für den anfordernden Client behält. (Geerbt von Control) |
| Events |
Ruft eine Liste von Ereignishandlerdelegatten für das Steuerelement ab. Diese Eigenschaft ist schreibgeschützt. (Geerbt von Control) |
| Font |
Ruft die Schriftarteigenschaften ab, die dem Webserversteuerelement zugeordnet sind. (Geerbt von WebControl) |
| ForeColor |
Ruft die Vordergrundfarbe (in der Regel die Farbe des Texts) des Webserversteuerelements ab oder legt sie fest. (Geerbt von WebControl) |
| GroupingText |
Dient zum Abrufen oder Festlegen der Beschriftung für die Gruppe von Steuerelementen, die im Panel-Steuerelement enthalten sind. (Geerbt von Panel) |
| HasAttributes |
Ruft einen Wert ab, der angibt, ob das Steuerelement Attribute festgelegt hat. (Geerbt von WebControl) |
| HasChildViewState |
Ruft einen Wert ab, der angibt, ob die untergeordneten Steuerelemente des aktuellen Serversteuerelements über gespeicherte Ansichtszustandseinstellungen verfügen. (Geerbt von Control) |
| Height |
Ruft die Höhe des Webserversteuerelements ab oder legt sie fest. (Geerbt von WebControl) |
| HorizontalAlign |
Ruft die horizontale Ausrichtung des Inhalts innerhalb des Panels ab oder legt sie fest. (Geerbt von Panel) |
| ID |
Ruft den programmgesteuerten Bezeichner ab, der dem Serversteuerelement zugewiesen ist, oder legt diesen fest. (Geerbt von Control) |
| IdSeparator |
Ruft das Zeichen ab, das zum Trennen von Steuerelementbezeichnern verwendet wird. (Geerbt von Control) |
| IsChildControlStateCleared |
Ruft einen Wert ab, der angibt, ob In diesem Steuerelement enthaltene Steuerelemente den Steuerelementstatus aufweisen. (Geerbt von Control) |
| IsEnabled |
Ruft einen Wert ab, der angibt, ob das Steuerelement aktiviert ist. (Geerbt von WebControl) |
| IsTrackingViewState |
Ruft einen Wert ab, der angibt, ob das Serversteuerelement Änderungen am Ansichtszustand 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 am Laden des Ansichtszustands anstelle ID von Index teilnimmt. (Geerbt von Control) |
| NamingContainer |
Ruft einen Verweis auf den Benennungscontainer des Serversteuerelements ab, der einen eindeutigen Namespace für die Unterscheidung zwischen Serversteuerelementen mit demselben ID Eigenschaftswert erstellt. (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 Seitensteuerelementhierarchie ab. (Geerbt von Control) |
| RenderingCompatibility |
Ruft einen Wert ab, der die ASP.NET Version angibt, mit der html gerendert wird, kompatibel ist. (Geerbt von Control) |
| ScrollBars |
Dient zum Abrufen oder Festlegen der Sichtbarkeit und Position von Bildlaufleisten in einem Panel Steuerelement. (Geerbt von Panel) |
| Site |
Ruft Informationen zum Container ab, der das aktuelle Steuerelement hostt, wenn es auf einer Entwurfsoberfläche gerendert wird. (Geerbt von Control) |
| SkinID |
Ruft die Haut ab, die auf das Steuerelement angewendet werden soll, oder legt sie fest. (Geerbt von WebControl) |
| Style |
Ruft eine Auflistung von Textattributen ab, die als Formatvorlagenattribute auf dem äußeren Tag des Webserversteuerelements gerendert werden. (Geerbt von WebControl) |
| SupportsDisabledAttribute |
Ruft einen Wert ab, der angibt, ob das Steuerelement das |
| TabIndex |
Dient zum Abrufen oder Festlegen des Registerkartenindex des Webserversteuerelements. (Geerbt von WebControl) |
| TagKey |
Ruft den Wert ab, der HtmlTextWriterTag diesem Webserversteuerelement entspricht. Diese Eigenschaft wird hauptsächlich von Steuerelemententwicklern verwendet. (Geerbt von WebControl) |
| TagName |
Ruft den Namen des Steuerelementtags ab. Diese Eigenschaft wird hauptsächlich von Steuerelemententwicklern verwendet. (Geerbt von WebControl) |
| TemplateControl |
Dient zum Abrufen oder Festlegen eines Verweises auf die Vorlage, die dieses Steuerelement enthält. (Geerbt von Control) |
| TemplateSourceDirectory |
Ruft das virtuelle Verzeichnis des Page oder UserControl das aktuelle Serversteuerelement ab. (Geerbt von Control) |
| Title |
Dient zum Abrufen oder Festlegen eines Titels für das Editor-Steuerelement. |
| ToolTip |
Ruft den Text ab, der angezeigt wird, wenn der Mauszeiger auf das Webserversteuerelement zeigt, oder legt diesen fest. (Geerbt von WebControl) |
| UniqueID |
Ruft den eindeutigen hierarchisch qualifizierten Bezeichner für das Serversteuerelement ab. (Geerbt von Control) |
| ValidateRequestMode |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Steuerelement Clienteingaben aus dem Browser auf potenziell gefährliche Werte überprüft. (Geerbt von Control) |
| ViewState |
Ruft ein Wörterbuch mit Statusinformationen ab, mit dem Sie den Ansichtszustand eines Serversteuerelements für mehrere Anforderungen für dieselbe Seite speichern und wiederherstellen können. (Geerbt von Control) |
| ViewStateIgnoresCase |
Ruft einen Wert ab, der angibt, ob die Groß-/Kleinschreibung des StateBag Objekts nicht beachtet wird. (Geerbt von Control) |
| ViewStateMode |
Ruft den Ansichtszustandsmodus dieses Steuerelements ab oder legt diesen fest. (Geerbt von Control) |
| Visible |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob ein Serversteuerelement als Benutzeroberfläche auf der Seite gerendert wird. (Geerbt von Control) |
| WebPartManager |
Ruft einen Verweis auf das Steuerelement ab, das WebPartManager der aktuellen Webseite zugeordnet ist. (Geerbt von EditorPart) |
| WebPartToEdit |
Ruft einen Verweis auf das WebPart Steuerelement ab, das gerade bearbeitet wird. (Geerbt von EditorPart) |
| Width |
Dient zum Abrufen oder Festlegen der Breite des Webserversteuerelements. (Geerbt von WebControl) |
| Wrap |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob der Inhalt innerhalb des Panels umbrochen wird. (Geerbt von Panel) |
| Zone |
Ruft einen Verweis auf die Zone ab, die EditorZoneBase ein EditorPart Steuerelement enthält. (Geerbt von EditorPart) |
Methoden
| Name | Beschreibung |
|---|---|
| AddAttributesToRender(HtmlTextWriter) |
Fügt Informationen zum Hintergrundbild, zur Ausrichtung, zum Umbruch und zur Richtung zur Liste der zu rendernden Attribute hinzu. (Geerbt von Panel) |
| AddedControl(Control, Int32) |
Wird aufgerufen, nachdem der Auflistung des Objekts ein untergeordnetes Control Steuerelement hinzugefügt Controls wurde. (Geerbt von Control) |
| AddParsedSubObject(Object) |
Benachrichtigt das Serversteuerelement, dass ein Element, entweder XML oder HTML, analysiert wurde, und fügt das Element dem Objekt des Serversteuerelements ControlCollection hinzu. (Geerbt von Control) |
| ApplyChanges() |
Speichert die Werte aus einem AppearanceEditorPart Steuerelement in den entsprechenden Eigenschaften im zugeordneten WebPart Steuerelement. |
| ApplyStyle(Style) |
Kopiert alle nicht leeren Elemente der angegebenen Formatvorlage in das Websteuerelement, wobei alle vorhandenen Formatvorlagenelemente des Steuerelements überschrieben werden. Diese Methode wird in erster Linie von Steuerelemententwicklern verwendet. (Geerbt von WebControl) |
| ApplyStyleSheetSkin(Page) |
Wendet die im Seitenstylesheet definierten Formatvorlageneigenschaften auf das Steuerelement an. (Geerbt von Control) |
| BeginRenderTracing(TextWriter, Object) |
Beginnt mit der Entwurfszeitablaufverfolgung von Renderingdaten. (Geerbt von Control) |
| BuildProfileTree(String, Boolean) |
Sammelt Informationen über das Serversteuerelement und liefert sie an die Eigenschaft, die Trace angezeigt werden soll, wenn die Ablaufverfolgung für die Seite aktiviert ist. (Geerbt von Control) |
| ClearCachedClientID() |
Legt den zwischengespeicherten ClientID Wert auf |
| ClearChildControlState() |
Löscht die Steuerelementstatusinformationen für die untergeordneten Steuerelemente des Serversteuerelements. (Geerbt von Control) |
| ClearChildState() |
Löscht die Ansichts- und Steuerelementstatusinformationen für alle untergeordneten Steuerelemente des Serversteuerelements. (Geerbt von Control) |
| ClearChildViewState() |
Löscht die Ansichtsstatusinformationen für alle untergeordneten Steuerelemente des Serversteuerelements. (Geerbt von Control) |
| ClearEffectiveClientIDMode() |
Legt die ClientIDMode Eigenschaft der aktuellen Steuerelementinstanz und aller untergeordneten Steuerelemente auf Inherit. (Geerbt von Control) |
| CopyBaseAttributes(WebControl) |
Kopiert die Eigenschaften, die nicht vom Objekt aus dem Style angegebenen Webserversteuerelement in das Webserversteuerelement gekapselt werden, von dem diese Methode aufgerufen wird. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet. (Geerbt von WebControl) |
| CreateChildControls() |
Wird vom ASP.NET Seitenframework aufgerufen, um Serversteuerelemente zu benachrichtigen, die kompositionsbasierte Implementierung verwenden, um alle untergeordneten Steuerelemente zu erstellen, die sie in Vorbereitung auf das Veröffentlichen von Zurück- oder Rendering enthalten. (Geerbt von Control) |
| CreateControlCollection() |
Erstellt ein neues ControlCollection Objekt, das die untergeordneten Steuerelemente (literal und server) des Serversteuerelements enthält. (Geerbt von Control) |
| CreateControlStyle() |
Erstellt ein Formatvorlagenobjekt, das intern vom Panel Steuerelement verwendet wird, um alle formatbezogenen Eigenschaften zu implementieren. (Geerbt von Panel) |
| DataBind() |
Bindet eine Datenquelle an das aufgerufene Serversteuerelement und alle untergeordneten Steuerelemente. (Geerbt von Part) |
| DataBind(Boolean) |
Bindet eine Datenquelle an das aufgerufene Serversteuerelement und alle untergeordneten Steuerelemente mit einer Option zum Auslösen des DataBinding Ereignisses. (Geerbt von Control) |
| DataBindChildren() |
Bindet eine Datenquelle an die untergeordneten Steuerelemente des Serversteuerelements. (Geerbt von Control) |
| Dispose() |
Ermöglicht es einem Serversteuerelement, die endgültige Bereinigung durchzuführen, bevor es aus dem Arbeitsspeicher freigegeben wird. (Geerbt von Control) |
| EndRenderTracing(TextWriter, Object) |
Beendet die Entwurfszeitablaufverfolgung von Renderingdaten. (Geerbt von Control) |
| EnsureChildControls() |
Bestimmt, ob das Serversteuerelement untergeordnete Steuerelemente enthält. Wenn dies nicht der Fall ist, werden untergeordnete Steuerelemente erstellt. (Geerbt von Control) |
| EnsureID() |
Erstellt einen Bezeichner für Steuerelemente, denen kein Bezeichner zugewiesen ist. (Geerbt von Control) |
| Equals(Object) |
Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object) |
| FindControl(String, Int32) |
Durchsucht den aktuellen Benennungscontainer für ein Serversteuerelement mit der angegebenen |
| FindControl(String) |
Durchsucht den aktuellen Benennungscontainer für ein Serversteuerelement mit dem angegebenen |
| Focus() |
Legt den Eingabefokus auf ein Steuerelement fest. (Geerbt von Control) |
| GetDesignModeState() |
Ruft den aktuellen Status der übergeordneten Zone eines EditorPart Steuerelements ab. (Geerbt von EditorPart) |
| GetHashCode() |
Dient als Standardhashfunktion. (Geerbt von Object) |
| 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 die Type der aktuellen Instanz ab. (Geerbt von Object) |
| GetUniqueIDRelativeTo(Control) |
Gibt den präfixierten Teil der UniqueID Eigenschaft des angegebenen Steuerelements zurück. (Geerbt von Control) |
| HasControls() |
Bestimmt, 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 untergeordnete Steuerelemente registriert sind. (Geerbt von Control) |
| IsLiteralContent() |
Bestimmt, ob das Serversteuerelement nur Literalinhalte enthält. (Geerbt von Control) |
| LoadControlState(Object) |
Stellt Steuerstatusinformationen aus einer vorherigen Seitenanforderung wieder her, die von der SaveControlState() Methode gespeichert wurde. (Geerbt von Control) |
| LoadViewState(Object) |
Stellt Ansichtsstatusinformationen aus einer vorherigen Anforderung wieder her, die mit der SaveViewState() Methode gespeichert wurde. (Geerbt von WebControl) |
| MapPathSecure(String) |
Ruft den physischen Pfad ab, dem ein virtueller Pfad, entweder absolut oder relativ, zugeordnet ist. (Geerbt von Control) |
| MemberwiseClone() |
Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object) |
| MergeStyle(Style) |
Kopiert alle nicht leeren Elemente der angegebenen Formatvorlage in das Websteuerelement, überschreibt jedoch keine vorhandenen Formatvorlagenelemente des Steuerelements. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet. (Geerbt von WebControl) |
| OnBubbleEvent(Object, EventArgs) |
Bestimmt, ob das Ereignis für das Serversteuerelement an die Ui-Serversteuerelementhierarchie der Seite übergeben wird. (Geerbt von Control) |
| OnDataBinding(EventArgs) |
Löst das DataBinding-Ereignis aus. (Geerbt von Control) |
| OnInit(EventArgs) |
Löst das Init-Ereignis aus. (Geerbt von Control) |
| OnLoad(EventArgs) |
Löst das Load-Ereignis aus. (Geerbt von Control) |
| OnPreRender(EventArgs) |
Löst das PreRender-Ereignis aus. (Geerbt von EditorPart) |
| OnUnload(EventArgs) |
Löst das Unload-Ereignis aus. (Geerbt von Control) |
| OpenFile(String) |
Ruft einen Stream Verwendeten zum Lesen einer Datei ab. (Geerbt von Control) |
| RaiseBubbleEvent(Object, EventArgs) |
Weist alle Quellen des Ereignisses und dessen Informationen dem übergeordneten Element des Steuerelements zu. (Geerbt von Control) |
| RemovedControl(Control) |
Wird aufgerufen, nachdem ein untergeordnetes Steuerelement aus der Controls Auflistung des Control Objekts entfernt wurde. (Geerbt von Control) |
| Render(HtmlTextWriter) |
Rendert das Steuerelement an den angegebenen HTML-Writer. (Geerbt von WebControl) |
| RenderBeginTag(HtmlTextWriter) |
Rendert das HTML-Öffnungstag des Panel Steuerelements an den angegebenen Writer. (Geerbt von Panel) |
| RenderChildren(HtmlTextWriter) |
Gibt den Inhalt der untergeordneten Elemente eines Serversteuerelements in ein bereitgestelltes HtmlTextWriter Objekt aus, das den inhalt schreibt, der auf dem Client gerendert werden soll. (Geerbt von Control) |
| RenderContents(HtmlTextWriter) |
Rendert den Inhalt des Steuerelements an den angegebenen Writer. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet. (Geerbt von WebControl) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Gibt den Inhalt des Serversteuerelements mithilfe eines bereitgestellten Objekts an ein bereitgestelltes HtmlTextWriterControlAdapter Objekt aus. (Geerbt von Control) |
| RenderControl(HtmlTextWriter) |
Gibt Den Inhalt des Serversteuerelements an ein bereitgestelltes HtmlTextWriter Objekt aus und speichert Ablaufverfolgungsinformationen zum Steuerelement, wenn die Ablaufverfolgung aktiviert ist. (Geerbt von Control) |
| RenderEndTag(HtmlTextWriter) |
Rendert das HTML-Schließen-Tag des Panel Steuerelements in den angegebenen Writer. (Geerbt von Panel) |
| 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) |
Wandelt eine URL in eine URL um, die auf dem anfordernden Client verwendet werden kann. (Geerbt von Control) |
| SaveControlState() |
Speichert alle Änderungen des Serversteuerelementstatus, die seit dem Zeitpunkt der Zurückpostung der Seite auf dem Server aufgetreten sind. (Geerbt von Control) |
| SaveViewState() |
Speichert jeden Zustand, der geändert wurde, nachdem die TrackViewState() Methode aufgerufen wurde. (Geerbt von WebControl) |
| SetDesignModeState(IDictionary) |
Wendet die Merkmale des Entwurfsmoduszustands auf die aktuelle EditorZoneBase Zone an, die ein EditorPart Steuerelement enthält. (Geerbt von EditorPart) |
| SetRenderMethodDelegate(RenderMethod) |
Weist einen Ereignishandlerdelegat zu, um das Serversteuerelement und dessen Inhalt in seinem übergeordneten Steuerelement zu rendern. (Geerbt von Control) |
| SetTraceData(Object, Object, Object) |
Legt Ablaufverfolgungsdaten für die Entwurfszeitablaufverfolgung von Renderingdaten mithilfe des ablaufverfolgungsobjekts, des Ablaufverfolgungsdatenschlüssels und des Ablaufverfolgungsdatenwerts fest. (Geerbt von Control) |
| SetTraceData(Object, Object) |
Legt Ablaufverfolgungsdaten für die Entwurfszeitablaufverfolgung von Renderingdaten mithilfe des Ablaufverfolgungsdatenschlüssels und des Ablaufverfolgungsdatenwerts fest. (Geerbt von Control) |
| SyncChanges() |
Ruft die Eigenschaftswerte aus einem WebPart Steuerelement ab und weist sie dem zugeordneten AppearanceEditorPart Steuerelement zu. |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |
| TrackViewState() |
Bewirkt, dass das Steuerelement Änderungen am Ansichtszustand nachverfolgt, sodass sie in der Eigenschaft des ViewState Objekts gespeichert werden können. (Geerbt von WebControl) |
Ereignisse
| Name | Beschreibung |
|---|---|
| DataBinding |
Tritt auf, wenn das Serversteuerelement eine Bindung an eine Datenquelle ausführt. (Geerbt von Control) |
| Disposed |
Tritt auf, wenn ein Serversteuerelement aus dem Arbeitsspeicher freigegeben wird. Dies ist die letzte Phase des Lebenszyklus des Serversteuerelements, wenn eine ASP.NET Seite angefordert wird. (Geerbt von Control) |
| Init |
Tritt auf, wenn das Serversteuerelement initialisiert wird, was der erste Schritt im Lebenszyklus ist. (Geerbt von Control) |
| Load |
Tritt auf, wenn das Serversteuerelement in das Page Objekt geladen wird. (Geerbt von Control) |
| PreRender |
Tritt ein, nachdem das Control Objekt geladen wurde, aber vor dem Rendern. (Geerbt von Control) |
| Unload |
Tritt auf, wenn das Serversteuerelement aus dem Arbeitsspeicher entladen wird. (Geerbt von Control) |
Explizite Schnittstellenimplementierungen
| Name | Beschreibung |
|---|---|
| IAttributeAccessor.GetAttribute(String) |
Ruft ein Attribut des Websteuerelements mit dem angegebenen Namen ab. (Geerbt von WebControl) |
| IAttributeAccessor.SetAttribute(String, String) |
Legt ein Attribut des Websteuerelements auf den angegebenen Namen und Wert fest. (Geerbt von WebControl) |
| ICompositeControlDesignerAccessor.RecreateChildControls() |
Ermöglicht es dem Entwickler eines Designers für ein zusammengesetztes Webpart-Steuerelement, die untergeordneten Steuerelemente des Steuerelements auf der Entwurfsoberfläche neu zu erstellen. (Geerbt von Part) |
| IControlBuilderAccessor.ControlBuilder |
Eine Beschreibung dieses Mitglieds finden Sie unter ControlBuilder. (Geerbt von Control) |
| IControlDesignerAccessor.GetDesignModeState() |
Eine Beschreibung dieses Mitglieds finden Sie unter GetDesignModeState(). (Geerbt von Control) |
| IControlDesignerAccessor.SetDesignModeState(IDictionary) |
Eine Beschreibung dieses Mitglieds finden Sie unter SetDesignModeState(IDictionary). (Geerbt von Control) |
| IControlDesignerAccessor.SetOwnerControl(Control) |
Eine Beschreibung dieses Mitglieds finden Sie unter SetOwnerControl(Control). (Geerbt von Control) |
| IControlDesignerAccessor.UserData |
Eine Beschreibung dieses Mitglieds finden Sie unter UserData. (Geerbt von Control) |
| IDataBindingsAccessor.DataBindings |
Eine Beschreibung dieses Mitglieds finden Sie unter DataBindings. (Geerbt von Control) |
| IDataBindingsAccessor.HasDataBindings |
Eine Beschreibung dieses Mitglieds finden Sie unter HasDataBindings. (Geerbt von Control) |
| IExpressionsAccessor.Expressions |
Eine Beschreibung dieses Mitglieds finden Sie unter Expressions. (Geerbt von Control) |
| IExpressionsAccessor.HasExpressions |
Eine Beschreibung dieses Mitglieds finden Sie unter HasExpressions. (Geerbt von Control) |
| IParserAccessor.AddParsedSubObject(Object) |
Eine Beschreibung dieses Mitglieds finden Sie unter AddParsedSubObject(Object). (Geerbt von Control) |
Erweiterungsmethoden
| Name | Beschreibung |
|---|---|
| EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>) |
Aktiviert das Dynamische Datenverhalten für das angegebene Datensteuerelement. |
| EnableDynamicData(INamingContainer, Type, Object) |
Aktiviert das Dynamische Datenverhalten für das angegebene Datensteuerelement. |
| EnableDynamicData(INamingContainer, Type) |
Aktiviert das Dynamische Datenverhalten für das angegebene Datensteuerelement. |
| 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 metatable -Objekt 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, IDictionary<String,Object>) |
Legt die Tabellenmetadaten und die Standardwertzuordnung für das angegebene Datensteuerelement fest. |
| SetMetaTable(INamingContainer, MetaTable, Object) |
Legt die Tabellenmetadaten und die Standardwertzuordnung für das angegebene Datensteuerelement fest. |
| SetMetaTable(INamingContainer, MetaTable) |
Legt die Tabellenmetadaten für das angegebene Datensteuerelement fest. |
| TryGetMetaTable(INamingContainer, MetaTable) |
Bestimmt, ob Tabellenmetadaten verfügbar sind. |
