ImportCatalogPart 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.
Importiert eine Beschreibungsdatei für ein WebPart-Steuerelement (oder andere ASP.NET-Serversteuerelemente, die als WebPart-Steuerelement verwendet werden), sodass Benutzer das Steuerelement zu einer Webseite mit vordefinierten Einstellungen hinzufügen können. Diese Klasse kann nicht vererbt werden.
public ref class ImportCatalogPart sealed : System::Web::UI::WebControls::WebParts::CatalogPartpublic sealed class ImportCatalogPart : System.Web.UI.WebControls.WebParts.CatalogParttype ImportCatalogPart = class
inherit CatalogPartPublic NotInheritable Class ImportCatalogPart
Inherits CatalogPart- Vererbung
Beispiele
Im folgenden Codebeispiel wird veranschaulicht, wie das ImportCatalogPart Steuerelement deklarativ und programmgesteuert auf einer Webseite verwendet wird. Das Beispiel umfasst vier Teile:
Ein Benutzersteuerelement, mit dem Sie die Anzeigemodi auf einer Webparts-Seite ändern können.
Eine Webseite, die ein CatalogZone -Steuerelement und ein ImportCatalogPart -Steuerelement enthält.
Eine Quellcodedatei, die zwei benutzerdefinierte WebPart Steuerelemente enthält.
Eine Erläuterung, wie das Beispiel funktioniert, wenn Sie die Seite in einem Browser laden.
Der erste Teil dieses Codebeispiels ist das Benutzersteuerelement, mit dem Benutzer die Anzeigemodi auf einer Webseite ändern können. Sie sollten den folgenden Quellcode in einer Datei platzieren und ihr den Namen Displaymodemenucs.ascx oder Displaymodemenuvb.ascx geben (je nachdem, welche Sprache Sie verwenden). Ausführliche Informationen zu Anzeigemodi und eine Beschreibung des Quellcodes in diesem Steuerelement finden Sie unter Exemplarische Vorgehensweise: Ändern von Anzeigemodi auf einer Webparts-Seite.
<%@ control language="C#" classname="DisplayModeMenuCS"%>
<script runat="server">
// Use a field to reference the current WebPartManager.
WebPartManager _manager;
void Page_Init(object sender, EventArgs e)
{
Page.InitComplete += new EventHandler(InitComplete);
}
void InitComplete(object sender, System.EventArgs e)
{
_manager = WebPartManager.GetCurrentWebPartManager(Page);
String browseModeName = WebPartManager.BrowseDisplayMode.Name;
// Fill the dropdown with the names of supported display modes.
foreach (WebPartDisplayMode mode in _manager.SupportedDisplayModes)
{
String modeName = mode.Name;
// Make sure a mode is enabled before adding it.
if (mode.IsEnabled(_manager))
{
ListItem item = new ListItem(modeName, modeName);
DisplayModeDropdown.Items.Add(item);
}
}
// If shared scope is allowed for this user, display the scope-switching
// UI and select the appropriate radio button for the current user scope.
if (_manager.Personalization.CanEnterSharedScope)
{
Panel2.Visible = true;
if (_manager.Personalization.Scope == PersonalizationScope.User)
RadioButton1.Checked = true;
else
RadioButton2.Checked = true;
}
}
// Change the page to the selected display mode.
void DisplayModeDropdown_SelectedIndexChanged(object sender, EventArgs e)
{
String selectedMode = DisplayModeDropdown.SelectedValue;
WebPartDisplayMode mode = _manager.SupportedDisplayModes[selectedMode];
if (mode != null)
_manager.DisplayMode = mode;
}
// Set the selected item equal to the current display mode.
void Page_PreRender(object sender, EventArgs e)
{
ListItemCollection items = DisplayModeDropdown.Items;
int selectedIndex =
items.IndexOf(items.FindByText(_manager.DisplayMode.Name));
DisplayModeDropdown.SelectedIndex = selectedIndex;
}
// Reset all of a user's personalization data for the page.
protected void LinkButton1_Click(object sender, EventArgs e)
{
_manager.Personalization.ResetPersonalizationState();
}
// If not in User personalization scope, toggle into it.
protected void RadioButton1_CheckedChanged(object sender, EventArgs e)
{
if (_manager.Personalization.Scope == PersonalizationScope.Shared)
_manager.Personalization.ToggleScope();
}
// If not in Shared scope, and if user is allowed, toggle the scope.
protected void RadioButton2_CheckedChanged(object sender, EventArgs e)
{
if (_manager.Personalization.CanEnterSharedScope &&
_manager.Personalization.Scope == PersonalizationScope.User)
_manager.Personalization.ToggleScope();
}
</script>
<div>
<asp:Panel ID="Panel1" runat="server"
Borderwidth="1"
Width="230"
BackColor="lightgray"
Font-Names="Verdana, Arial, Sans Serif" >
<asp:Label ID="Label1" runat="server"
Text=" Display Mode"
Font-Bold="true"
Font-Size="8"
Width="120"
AssociatedControlID="DisplayModeDropdown"/>
<asp:DropDownList ID="DisplayModeDropdown" runat="server"
AutoPostBack="true"
Width="120"
OnSelectedIndexChanged="DisplayModeDropdown_SelectedIndexChanged" />
<asp:LinkButton ID="LinkButton1" runat="server"
Text="Reset User State"
ToolTip="Reset the current user's personalization data for the page."
Font-Size="8"
OnClick="LinkButton1_Click" />
<asp:Panel ID="Panel2" runat="server"
GroupingText="Personalization Scope"
Font-Bold="true"
Font-Size="8"
Visible="false" >
<asp:RadioButton ID="RadioButton1" runat="server"
Text="User"
AutoPostBack="true"
GroupName="Scope" OnCheckedChanged="RadioButton1_CheckedChanged" />
<asp:RadioButton ID="RadioButton2" runat="server"
Text="Shared"
AutoPostBack="true"
GroupName="Scope"
OnCheckedChanged="RadioButton2_CheckedChanged" />
</asp:Panel>
</asp:Panel>
</div>
<%@ control language="vb" classname="DisplayModeMenuVB"%>
<script runat="server">
' Use a field to reference the current WebPartManager.
Dim _manager As WebPartManager
Sub Page_Init(ByVal sender As Object, ByVal e As EventArgs)
AddHandler Page.InitComplete, AddressOf InitComplete
End Sub
Sub InitComplete(ByVal sender As Object, ByVal e As System.EventArgs)
_manager = WebPartManager.GetCurrentWebPartManager(Page)
Dim browseModeName As String = WebPartManager.BrowseDisplayMode.Name
' Fill the dropdown with the names of supported display modes.
Dim mode As WebPartDisplayMode
For Each mode In _manager.SupportedDisplayModes
Dim modeName As String = mode.Name
' Make sure a mode is enabled before adding it.
If mode.IsEnabled(_manager) Then
Dim item As New ListItem(modeName, modeName)
DisplayModeDropdown.Items.Add(item)
End If
Next mode
' If shared scope is allowed for this user, display the scope-switching
' UI and select the appropriate radio button for the current user scope.
If _manager.Personalization.CanEnterSharedScope Then
Panel2.Visible = True
If _manager.Personalization.Scope = PersonalizationScope.User Then
RadioButton1.Checked = True
Else
RadioButton2.Checked = True
End If
End If
End Sub
' Change the page to the selected display mode.
Sub DisplayModeDropdown_SelectedIndexChanged(ByVal sender As Object, _
ByVal e As EventArgs)
Dim selectedMode As String = DisplayModeDropdown.SelectedValue
Dim mode As WebPartDisplayMode = _
_manager.SupportedDisplayModes(selectedMode)
If Not (mode Is Nothing) Then
_manager.DisplayMode = mode
End If
End Sub
' Set the selected item equal to the current display mode.
Sub Page_PreRender(ByVal sender As Object, ByVal e As EventArgs)
Dim items As ListItemCollection = DisplayModeDropdown.Items
Dim selectedIndex As Integer = _
items.IndexOf(items.FindByText(_manager.DisplayMode.Name))
DisplayModeDropdown.SelectedIndex = selectedIndex
End Sub
' Reset all of a user's personalization data for the page.
Protected Sub LinkButton1_Click(ByVal sender As Object, _
ByVal e As EventArgs)
_manager.Personalization.ResetPersonalizationState()
End Sub
' If not in User personalization scope, toggle into it.
Protected Sub RadioButton1_CheckedChanged(ByVal sender As Object, _
ByVal e As EventArgs)
If _manager.Personalization.Scope = PersonalizationScope.Shared Then
_manager.Personalization.ToggleScope()
End If
End Sub
' If not in Shared scope, and if user is allowed, toggle the scope.
Protected Sub RadioButton2_CheckedChanged(ByVal sender As Object, _
ByVal e As EventArgs)
If _manager.Personalization.CanEnterSharedScope AndAlso _
_manager.Personalization.Scope = PersonalizationScope.User Then
_manager.Personalization.ToggleScope()
End If
End Sub
</script>
<div>
<asp:Panel ID="Panel1" runat="server"
Borderwidth="1"
Width="230"
BackColor="lightgray"
Font-Names="Verdana, Arial, Sans Serif" >
<asp:Label ID="Label1" runat="server"
Text=" Display Mode"
Font-Bold="true"
Font-Size="8"
Width="120"
AssociatedControlID="DisplayModeDropdown"/>
<asp:DropDownList ID="DisplayModeDropdown" runat="server"
AutoPostBack="true"
Width="120"
OnSelectedIndexChanged="DisplayModeDropdown_SelectedIndexChanged" />
<asp:LinkButton ID="LinkButton1" runat="server"
Text="Reset User State"
ToolTip="Reset the current user's personalization data for the page."
Font-Size="8"
OnClick="LinkButton1_Click" />
<asp:Panel ID="Panel2" runat="server"
GroupingText="Personalization Scope"
Font-Bold="true"
Font-Size="8"
Visible="false" >
<asp:RadioButton ID="RadioButton1" runat="server"
Text="User"
AutoPostBack="true"
GroupName="Scope" OnCheckedChanged="RadioButton1_CheckedChanged" />
<asp:RadioButton ID="RadioButton2" runat="server"
Text="Shared"
AutoPostBack="true"
GroupName="Scope"
OnCheckedChanged="RadioButton2_CheckedChanged" />
</asp:Panel>
</asp:Panel>
</div>
Der zweite Teil des Codebeispiels ist die Webseite. Oben auf der Seite befinden sich zwei register Direktiven, eine für das Benutzersteuerelement und eine für die kompilierte Komponente, die die beiden benutzerdefinierten WebPart Steuerelemente enthält. Beachten Sie, dass die Seite einen deklarativen Verweis auf das Steuerelement enthält, der ImportCatalogPart in der richtigen Hierarchie deklarativer Elemente geschachtelt ist. Beachten Sie auch, dass dem Element mehrere Eigenschaftswerte deklarativ <asp:importcatalogpart> zugewiesen werden. Außerdem aktualisiert die Button1_Click -Methode eine Reihe von Eigenschaftswerten für das ImportCatalogPart Steuerelement.
Im -Steuerelement der Seite WebPartZone werden die beiden benutzerdefinierten WebPart Steuerelemente deklariert. Das <aspSample:userinfowebpart> Steuerelement verfügt über ein exportmode="all" -Attribut. Dieses Attribut ist erforderlich, damit Benutzer eine Beschreibungsdatei für das Steuerelement exportieren können, die dann von anderen Benutzern importiert werden kann, die das Steuerelement mithilfe der Beschreibungsdatei importieren möchten.
Hinweis
Damit Benutzer einer Webparts-Anwendung eine Beschreibungsdatei für WebPart Steuerelemente exportieren können, müssen Sie auch die Exportfunktion in der Webanwendung aktivieren, indem Sie dem <webParts> Element (das ein untergeordnetes <system.web> Element ist) in der Web.config-Datei ein enableExport="true" Attribut hinzufügen. Der Export ist standardmäßig deaktiviert. Wenn Sie den Export für Ihre Anwendung noch nicht aktiviert haben, bearbeiten Sie die Web.config-Datei, und führen Sie dies jetzt aus.
<%@ page language="c#" %>
<%@ register TagPrefix="uc1"
TagName="DisplayModeMenuCS"
Src="DisplayModeMenuCS.ascx" %>
<%@ register tagprefix="aspSample"
Namespace="Samples.AspNet.CS.Controls" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
// <snippet3>
protected void Button1_Click(object sender, EventArgs e)
{
ImportCatalogPart1.Title = "Import Server Controls";
ImportCatalogPart1.BrowseHelpText = "Enter the path to a "
+ "description file.";
ImportCatalogPart1.UploadButtonText = "Upload Description";
ImportCatalogPart1.UploadHelpText = "Upload a description file.";
ImportCatalogPart1.ImportedPartLabelText = "Imported Controls";
ImportCatalogPart1.PartImportErrorLabelText = "An error occurred "
+ "during the import process.";
}
// </snippet3>
protected void Page_Load(object sender, EventArgs e)
{
Button1.Visible = false;
}
protected void ImportCatalogPart1_PreRender(object sender,
EventArgs e)
{
Button1.Visible = true;
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
<title>
ImportCatalogPart Control
</title>
</head>
<body>
<form id="form1" runat="server">
<asp:webpartmanager id="WebPartManager1" runat="server" />
<uc1:DisplayModeMenuCS ID="DisplayModeMenu1" runat="server" />
<asp:webpartzone id="zone1" runat="server" >
<PartTitleStyle BorderWidth="1"
Font-Names="Verdana, Arial"
Font-Size="110%"
BackColor="LightBlue" />
<zonetemplate>
<aspSample:TextDisplayWebPart
runat="server"
id="TextDisplayWebPart1"
title = "Text Display WebPart" />
<aspsample:userinfowebpart id="userinfo1" runat="server"
Title="User Information" exportmode="all" />
</zonetemplate>
</asp:webpartzone>
<asp:EditorZone ID="EditorZone1" runat="server">
<ZoneTemplate>
<asp:PropertyGridEditorPart ID="PropertyGridEditorPart1"
runat="server" />
</ZoneTemplate>
</asp:EditorZone>
<asp:CatalogZone ID="CatalogZone1" runat="server">
<ZoneTemplate>
<asp:ImportCatalogPart ID="ImportCatalogPart1"
runat="server"
Title="My ImportCatalogPart"
OnPreRender="ImportCatalogPart1_PreRender"
BrowseHelpText="Type a path or browse to find a control's
description file."
UploadButtonText="Upload Description File"
UploadHelpText="Click the button to upload the description
file."
ImportedPartLabelText="My User Information WebPart"
PartImportErrorLabelText="An error occurred while trying
to import a description file." />
</ZoneTemplate>
</asp:CatalogZone>
<hr />
<asp:Button ID="Button1" runat="server"
Text="Update ImportCatalogPart"
OnClick="Button1_Click" />
</form>
</body>
</html>
<%@ page language="VB" %>
<%@ register TagPrefix="uc1"
TagName="DisplayModeMenuVB"
Src="DisplayModeMenuVB.ascx" %>
<%@ register tagprefix="aspSample"
Namespace="Samples.AspNet.VB.Controls" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
' <snippet3>
Protected Sub Button1_Click(ByVal sender As Object, _
ByVal e As EventArgs)
ImportCatalogPart1.Title = "Import Server Controls"
ImportCatalogPart1.BrowseHelpText = "Enter the path to a " _
& "description file."
ImportCatalogPart1.UploadButtonText = "Upload Description"
ImportCatalogPart1.UploadHelpText = "Upload a description file."
ImportCatalogPart1.ImportedPartLabelText = "Imported Controls"
ImportCatalogPart1.PartImportErrorLabelText = "An error occurred " _
& "during the import process."
End Sub
' </snippet3>
Protected Sub Page_Load(ByVal sender As Object, _
ByVal e As EventArgs)
Button1.Visible = false
End Sub
Protected Sub ImportCatalogPart1_PreRender(ByVal sender As Object, _
ByVal e As EventArgs)
Button1.Visible = true
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>
ImportCatalogPart Control
</title>
</head>
<body>
<form id="form1" runat="server">
<asp:webpartmanager id="WebPartManager1" runat="server" />
<uc1:DisplayModeMenuVB ID="DisplayModeMenu1" runat="server" />
<asp:webpartzone id="zone1" runat="server" >
<PartTitleStyle BorderWidth="1"
Font-Names="Verdana, Arial"
Font-Size="110%"
BackColor="LightBlue" />
<zonetemplate>
<aspSample:TextDisplayWebPart
runat="server"
id="TextDisplayWebPart1"
title = "Text Display WebPart" />
<aspsample:userinfowebpart id="userinfo1" runat="server"
Title="User Information" exportmode="all" />
</zonetemplate>
</asp:webpartzone>
<asp:EditorZone ID="EditorZone1" runat="server">
<ZoneTemplate>
<asp:PropertyGridEditorPart ID="PropertyGridEditorPart1"
runat="server" />
</ZoneTemplate>
</asp:EditorZone>
<asp:CatalogZone ID="CatalogZone1" runat="server">
<ZoneTemplate>
<asp:ImportCatalogPart ID="ImportCatalogPart1"
runat="server"
Title="My ImportCatalogPart"
OnPreRender="ImportCatalogPart1_PreRender"
BrowseHelpText="Type a path or browse to find a control's
description file."
UploadButtonText="Upload Description File"
UploadHelpText="Click the button to upload the description
file."
ImportedPartLabelText="My User Information WebPart"
PartImportErrorLabelText="An error occurred while trying
to import a description file." />
</ZoneTemplate>
</asp:CatalogZone>
<hr />
<asp:Button ID="Button1" runat="server"
Text="Update ImportCatalogPart"
OnClick="Button1_Click" />
</form>
</body>
</html>
Der dritte Teil des Codebeispiels ist der Quellcode für die beiden WebPart Steuerelemente. Beachten Sie, dass einige Eigenschaften für diese Steuerelemente mit dem WebBrowsable -Attribut gekennzeichnet sind. Dadurch kann das PropertyGridEditorPart Steuerelement dynamisch die Benutzeroberfläche (UI) generieren, damit ein Benutzer diese Eigenschaften bearbeiten kann, wenn sich die Steuerelemente im Bearbeitungsmodus befinden. Die Eigenschaften werden auch mit einem WebDisplayName -Attribut gekennzeichnet, um den Text der Bezeichnung anzugeben, die neben jedem Steuerelement auf der Bearbeitungsoberfläche angezeigt 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 Ordner App_Code Ihrer Website ablegen, wo er zur Laufzeit dynamisch kompiliert wird. In diesem Codebeispiel wird die dynamische Kompilierung verwendet. Eine exemplarische Vorgehensweise, die beide Kompilierungsmethoden veranschaulicht, finden Sie unter Exemplarische Vorgehensweise: Entwickeln und Verwenden eines benutzerdefinierten Webserversteuerelements.
Auf das benutzerdefinierte Steuerelement namens TextDisplayWebPart wird auf der Webseite mit einem <aspSample:TextDisplayWebPart> -Element verwiesen. Das andere Steuerelement mit dem Namen UserInfoWebPartwird zunächst ebenfalls auf der Webseite deklariert. Sie entfernen es jedoch später, um die Möglichkeit zum Importieren einer Beschreibungsdatei für ein Steuerelement zu veranschaulichen.
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 UserInfoWebPart : WebPart
{
HttpServerUtility server = HttpContext.Current.Server;
private String _userNickName = "Add a nickname.";
private String _userPetName = "Add a pet name.";
private DateTime _userSpecialDate = DateTime.Now;
private Boolean _userIsCurrent = true;
private JobTypeName _userJobType = JobTypeName.Unselected;
public enum JobTypeName
{
Unselected = 0,
Support = 1,
Service = 2,
Professional = 3,
Technical = 4,
Manager = 5,
Executive = 6
}
Label NickNameLabel;
Label PetNickNameLabel;
Label SpecialDateLabel;
CheckBox IsCurrentCheckBox;
Label JobTypeLabel;
// Add the Personalizable and WebBrowsable attributes to the
// public properties, so that users can save property values
// and edit them with a PropertyGridEditorPart control.
[Personalizable(), WebBrowsable, WebDisplayName("Nickname")]
public String NickName
{
get
{
object o = ViewState["NickName"];
if (o != null)
return (string)o;
else
return _userNickName;
}
set { _userNickName = server.HtmlEncode(value); }
}
[Personalizable(), WebBrowsable, WebDisplayName("Pet Name")]
public String PetName
{
get
{
object o = ViewState["PetName"];
if (o != null)
return (string)o;
else
return _userPetName;
}
set { _userPetName = server.HtmlEncode(value); }
}
[Personalizable(), WebBrowsable(), WebDisplayName("Special Day")]
public DateTime SpecialDay
{
get
{
object o = ViewState["SpecialDay"];
if (o != null)
return (DateTime)o;
else
return _userSpecialDate;
}
set { _userSpecialDate = value; }
}
[Personalizable(), WebBrowsable(), WebDisplayName("Job Type")]
public JobTypeName UserJobType
{
get
{
object o = ViewState["UserJobType"];
if (o != null)
return (JobTypeName)o;
else
return _userJobType;
}
set { _userJobType = (JobTypeName)value; }
}
[Personalizable(), WebBrowsable(), WebDisplayName("Is Current")]
public Boolean IsCurrent
{
get
{
object o = ViewState["IsCurrent"];
if (o != null)
return (Boolean)o;
else
return _userIsCurrent;
}
set { _userIsCurrent = value; }
}
protected override void CreateChildControls()
{
Controls.Clear();
NickNameLabel = new Label();
NickNameLabel.Text = this.NickName;
SetControlAttributes(NickNameLabel);
PetNickNameLabel = new Label();
PetNickNameLabel.Text = this.PetName;
SetControlAttributes(PetNickNameLabel);
SpecialDateLabel = new Label();
SpecialDateLabel.Text = this.SpecialDay.ToShortDateString();
SetControlAttributes(SpecialDateLabel);
IsCurrentCheckBox = new CheckBox();
IsCurrentCheckBox.Checked = this.IsCurrent;
SetControlAttributes(IsCurrentCheckBox);
JobTypeLabel = new Label();
JobTypeLabel.Text = this.UserJobType.ToString();
SetControlAttributes(JobTypeLabel);
ChildControlsCreated = true;
}
private void SetControlAttributes(WebControl ctl)
{
ctl.BackColor = Color.White;
ctl.BorderWidth = 1;
ctl.Width = 200;
this.Controls.Add(ctl);
}
protected override void RenderContents(HtmlTextWriter writer)
{
writer.Write("Nickname:");
writer.WriteBreak();
NickNameLabel.RenderControl(writer);
writer.WriteBreak();
writer.Write("Pet Name:");
writer.WriteBreak();
PetNickNameLabel.RenderControl(writer);
writer.WriteBreak();
writer.Write("Special Date:");
writer.WriteBreak();
SpecialDateLabel.RenderControl(writer);
writer.WriteBreak();
writer.Write("Job Type:");
writer.WriteBreak();
JobTypeLabel.RenderControl(writer);
writer.WriteBreak();
writer.Write("Current:");
writer.WriteBreak();
IsCurrentCheckBox.RenderControl(writer);
}
}
[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 = Context.Server.HtmlEncode(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 UserInfoWebPart
Inherits WebPart
Private server As HttpServerUtility = HttpContext.Current.Server
Private _userNickName As String = "Add a nickname."
Private _userPetName As String = "Add a pet name."
Private _userSpecialDate As DateTime = DateTime.Now
Private _userIsCurrent As [Boolean] = True
Private _userJobType As JobTypeName = JobTypeName.Unselected
Public Enum JobTypeName
Unselected = 0
Support = 1
Service = 2
Professional = 3
Technical = 4
Manager = 5
Executive = 6
End Enum
Private NickNameLabel As Label
Private PetNickNameLabel As Label
Private SpecialDateLabel As Label
Private IsCurrentCheckBox As CheckBox
Private JobTypeLabel As Label
' Add the Personalizable and WebBrowsable attributes to the
' public properties, so that users can save property values
' and edit them with a PropertyGridEditorPart control.
<Personalizable(), WebBrowsable(), WebDisplayName("Nickname")> _
Public Property NickName() As String
Get
Dim o As Object = ViewState("NickName")
If Not (o Is Nothing) Then
Return CStr(o)
Else
Return _userNickName
End If
End Get
Set(ByVal value As String)
_userNickName = server.HtmlEncode(value)
End Set
End Property
<Personalizable(), WebBrowsable(), WebDisplayName("Pet Name")> _
Public Property PetName() As String
Get
Dim o As Object = ViewState("PetName")
If Not (o Is Nothing) Then
Return CStr(o)
Else
Return _userPetName
End If
End Get
Set(ByVal value As String)
_userPetName = server.HtmlEncode(value)
End Set
End Property
<Personalizable(), WebBrowsable(), WebDisplayName("Special Day")> _
Public Property SpecialDay() As DateTime
Get
Dim o As Object = ViewState("SpecialDay")
If Not (o Is Nothing) Then
Return CType(o, DateTime)
Else
Return _userSpecialDate
End If
End Get
Set(ByVal value As DateTime)
_userSpecialDate = value
End Set
End Property
<Personalizable(), WebBrowsable(), WebDisplayName("Job Type")> _
Public Property UserJobType() As JobTypeName
Get
Dim o As Object = ViewState("UserJobType")
If Not (o Is Nothing) Then
Return CType(o, JobTypeName)
Else
Return _userJobType
End If
End Get
Set(ByVal value As JobTypeName)
_userJobType = CType(value, JobTypeName)
End Set
End Property
<Personalizable(), WebBrowsable(), WebDisplayName("Is Current")> _
Public Property IsCurrent() As [Boolean]
Get
Dim o As Object = ViewState("IsCurrent")
If Not (o Is Nothing) Then
Return CType(o, [Boolean])
Else
Return _userIsCurrent
End If
End Get
Set(ByVal value As [Boolean])
_userIsCurrent = value
End Set
End Property
Protected Overrides Sub CreateChildControls()
Controls.Clear()
NickNameLabel = New Label()
NickNameLabel.Text = Me.NickName
SetControlAttributes(NickNameLabel)
PetNickNameLabel = New Label()
PetNickNameLabel.Text = Me.PetName
SetControlAttributes(PetNickNameLabel)
SpecialDateLabel = New Label()
SpecialDateLabel.Text = Me.SpecialDay.ToShortDateString()
SetControlAttributes(SpecialDateLabel)
IsCurrentCheckBox = New CheckBox()
IsCurrentCheckBox.Checked = Me.IsCurrent
SetControlAttributes(IsCurrentCheckBox)
JobTypeLabel = New Label()
JobTypeLabel.Text = Me.UserJobType.ToString()
SetControlAttributes(JobTypeLabel)
ChildControlsCreated = True
End Sub
Private Sub SetControlAttributes(ByVal ctl As WebControl)
ctl.BackColor = Color.White
ctl.BorderWidth = 1
ctl.Width = 200
Me.Controls.Add(ctl)
End Sub
Protected Overrides Sub RenderContents(ByVal writer As HtmlTextWriter)
writer.Write("Nickname:")
writer.WriteBreak()
NickNameLabel.RenderControl(writer)
writer.WriteBreak()
writer.Write("Pet Name:")
writer.WriteBreak()
PetNickNameLabel.RenderControl(writer)
writer.WriteBreak()
writer.Write("Special Date:")
writer.WriteBreak()
SpecialDateLabel.RenderControl(writer)
writer.WriteBreak()
writer.Write("Job Type:")
writer.WriteBreak()
JobTypeLabel.RenderControl(writer)
writer.WriteBreak()
writer.Write("Current:")
writer.WriteBreak()
IsCurrentCheckBox.RenderControl(writer)
End Sub
End Class
<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 String.IsNullOrEmpty(input.Text) = False Then
_contentText = Context.Server.HtmlEncode(input.Text) + "<br />"
input.Text = String.Empty
DisplayContent.Text = Me.ContentText
End If
End Sub
End Class
End Namespace
Führen Sie nun das Codebeispiel aus. Laden Sie die Webseite in einen Browser. Der erste Schritt besteht darin, das UserInfoWebPart Steuerelement zu bearbeiten. Verwenden Sie das Dropdownlistensteuerelement Anzeigemodus , und wählen Sie Bearbeiten aus, um die Seite in den Bearbeitungsmodus zu wechseln. Klicken Sie auf das Verbenmenü des UserInfoWebPart Steuerelements (den Pfeil nach unten in der Titelleiste), und klicken Sie dann auf Bearbeiten. Wenn die Bearbeitungsbenutzeroberfläche angezeigt wird, werden unter dem UserInfoWebPart Steuerelement mehrere Bearbeitungssteuerelemente angezeigt, die Sie zum Bearbeiten der Feldwerte verwenden können. Bearbeiten Sie einige Felder, klicken Sie auf OK, und verwenden Sie dann die Dropdownliste Anzeigemodus , um die Seite in den Browsermodus zurückzugeben.
Der zweite Schritt besteht darin, eine zu exportieren. WebPart-Beschreibungsdatei für das UserInfoWebPart Steuerelement. Klicken Sie auf das Menü Verben im benutzerdefinierten Steuerelement (dargestellt durch den Pfeil nach unten in der Titelleiste), und klicken Sie auf Exportieren. Befolgen Sie die Anweisungen zum Speichern von . WebPart-Beschreibungsdatei für das Steuerelement. Schließen Sie nun die Webseite, und bearbeiten Sie die Seitenquelle in einem Editor. Löschen Sie das <aspSample:userinfowebpart> Steuerelementdeklarationselement, speichern und schließen Sie die Datei. (Sie führen diesen Schritt aus, um einen Benutzer zu simulieren, der noch nicht über das UserInfoWebPart Steuerelement verfügt, damit Sie das Steuerelement auf die Seite importieren können.)
Laden Sie die Webseite erneut in einem Browser. Das UserInfoWebPart Steuerelement sollte nicht angezeigt werden, da Sie es entfernt haben. Verwenden Sie das Dropdownlistensteuerelement Anzeigemodus , und wählen Sie Katalog aus, um die Seite in den Katalogmodus zu wechseln. Klicken Sie im ImportCatalogPart Steuerelement auf die Schaltfläche Durchsuchen , und navigieren Sie zu . WebPart-Datei, die Sie erstellt haben, und klicken Sie dann auf die Schaltfläche Hochladen . Ein Verweis auf das Steuerelement sollte mit einem Kontrollkästchen daneben angezeigt werden. Aktivieren Sie das Kontrollkästchen, und klicken Sie dann auf Hinzufügen , um das Steuerelement der Seite hinzuzufügen.
Während Sie sich in dieser Ansicht der Seite befinden, klicken Sie unten auf der Seite auf die Schaltfläche ImportCatalogPart aktualisieren , um die Auswirkungen der programmgesteuerten Aktualisierung einer Reihe von Eigenschaftswerten für das ImportCatalogPart Steuerelement anzuzeigen. Nachdem Sie auf die Schaltfläche geklickt haben, beobachten Sie, wie die verschiedenen Eigenschaften in der Benutzeroberfläche geändert werden.
Klicken Sie abschließend auf Schließen , um den Katalogmodus zu beenden und die Seite in den Browsermodus zurückzugeben. Das UserInfoWebPart Steuerelement sollte nun auf der Seite angezeigt werden und die Werte enthalten, die es beim früheren Export hatte.
Hinweise
Mit ImportCatalogPart dem -Steuerelement können Benutzer eine Beschreibungsdatei importieren, die Einstellungen für ein Steuerelement oder Serversteuerelement WebPart beschreibt, die ein Benutzer einer WebPartZoneBase Zone hinzufügen möchte.
Nachdem ein Benutzer eine Beschreibungsdatei importiert hat, wird das WebPart Steuerelement, auf das in der Datei verwiesen wird, innerhalb des ImportCatalogPart Steuerelements angezeigt, und ein Benutzer kann das Steuerelement der Seite hinzufügen.
Die Beschreibungsdatei ist nicht identisch mit dem Steuerelement selbst. Es handelt sich um eine XML-Datei, die mit einer endet. WebPart-Erweiterung und enthält Name-Wert-Paare (hauptsächlich Eigenschaftswerte), die den Zustand des Steuerelements beschreiben. Die Beschreibungsdatei wird gemäß einem angegebenen XML-Format erstellt, wie im Thema Webparts-Steuerelementbeschreibungsdateien beschrieben.
Das Steuerelement, auf das sich die Beschreibungsdatei bezieht, kann entweder in eine Assembly kompiliert werden, oder es kann ein Benutzersteuerelement sein, das in einer ASCX-Datei definiert ist. In beiden Fällen muss das Steuerelement, auf das in einer importierten Beschreibungsdatei verwiesen wird, auf dem Webserver vorhanden sein, der die Seite hostet, die versucht, das Steuerelement zu importieren. Die Beschreibungsdatei verweist auf den Namen des Steuerelements und die Assembly (oder Datei), die das Steuerelement enthält, und die Beschreibungsdatei enthält Einstellungen, die sich auf die Eigenschaftswerte, das Aussehen und das Verhalten des Steuerelements auswirken.
Mit ImportCatalogPart dem -Steuerelement können Benutzer Einstellungen für Steuerelemente freigeben. Ein komplexes Steuerelement kann über viele Eigenschaften und Einstellungen verfügen. In einer typischen Intranetwebsite in einem großen Unternehmen kann ein benutzerdefiniertes WebPart Steuerelement beispielsweise eine Reihe von Eigenschaften enthalten, die spezifische Werte für die Umgebung des Benutzers enthalten, z. B. deren Datenbankverbindungen, Abteilungsinformationen usw. Das Steuerelement kann auch eine Reihe von Eigenschaften enthalten, die sich auf seine Darstellung auswirken. Ein Benutzer könnte das Steuerelement auf einer bestimmten Website personalisieren und ordnungsgemäß funktionieren lassen, eine Beschreibungsdatei für das Steuerelement exportieren und dann die Beschreibungsdatei für andere Benutzer freigeben, die die Datei importieren könnten, um das vollständig konfigurierte Steuerelement anderen Intranetwebsites hinzuzufügen, die sie personalisieren dürfen. Solange die kompilierte Assembly- oder Benutzersteuerelementdatei, die das Steuerelement enthält, auf dem Webserver vorhanden ist, der ihre Website hostet, können Benutzer das Steuerelement anderen Websites hinzufügen.
Der Mechanismus, mit dem Benutzer eine Beschreibungsdatei (und damit das zugehörige Serversteuerelement) in eine Webseite importieren, ist das ImportCatalogPart Steuerelement, das ein Seitenentwickler einer Webseite hinzufügen muss. Wenn ein Benutzer die Seite in den Kataloganzeigemodus wechselt, wird das ImportCatalogPart Steuerelement angezeigt, und der Benutzer kann dieses Steuerelement verwenden, um zum zu navigieren. WebPart-Beschreibungsdatei, die dem zu importierenden Serversteuerelement entspricht. Gemäß der Benutzeroberfläche und den Anweisungen des ImportCatalogPart Steuerelements kann ein Benutzer das gewünschte Serversteuerelement der Webseite hinzufügen, wobei sein Aussehen und die Eigenschaften vollständig konfiguriert sind, wie in der importierten Beschreibungsdatei angegeben.
Bevor die Beschreibungsdatei eines WebPart Steuerelements importiert werden kann, muss ein Benutzer zuerst die Datei basierend auf einem vorhandenen WebPart Steuerelement erstellen (exportieren). Eine Beschreibungsdatei kann für ein Steuerelement exportiert werden, wenn die folgenden Bedingungen erfüllt sind:
Das Steuerelement verfügt über Eigenschaften, die mit dem
Personalizable-Attribut gekennzeichnet sind.Für die Web.config-Datei ist der
enableExportAttributwert für das<webParts>-Element auftruefestgelegt.Ein Entwickler legt den Wert der ExportMode -Eigenschaft für das Steuerelement auf einen anderen Wert als den Standardwert von Nonefest, der den Export verhindert. Wenn der ExportMode Eigenschaftswert auf NonSensitiveDatafestgelegt ist, wird jede Eigenschaft, die einen IsSensitive Parameter mit einem
PersonalizableAttribut enthält, nicht exportiert, wenn ein Benutzer eine Beschreibungsdatei exportiert. Dadurch können Steuerungsentwickler in bestimmten Situationen verhindern, dass vertrauliche Daten, z. B. Verbindungszeichenfolgen, exportiert werden.
Ein Benutzer kann ein Steuerelement exportieren, das für den Export aktiviert wurde, indem er auf das Exportverb klicken, das im Verbenmenü des Steuerelements angezeigt wird, und die Anweisungen zum Speichern von befolgen. WebPart-Beschreibungsdatei für das Steuerelement. Andere Benutzer können diese Datei dann importieren, um ihre eigenen Instanzen des Steuerelements zu konfigurieren.
Die ImportCatalogPart -Klasse enthält mehrere Eigenschaften. Die BrowseHelpText -Eigenschaft enthält Text mit Anweisungen für Benutzer, wenn sie nach der Beschreibungsdatei suchen. Die ImportedPartLabelText -Eigenschaft enthält Text, der als Bezeichnung für das importierte Steuerelement dient, wie es im ImportCatalogPart Steuerelement angezeigt wird. Enthält PartImportErrorLabelText Text, der angezeigt wird, wenn beim Importieren einer Steuerelementbeschreibung ein Fehler auftritt. Die Title -Eigenschaft überschreibt die Basiseigenschaft, um einem Steuerelement einen Standardtitel ImportCatalogPart zuzuweisen, wenn der Entwickler keinen Titel zuweist. Die UploadButtonText -Eigenschaft enthält den Text für die Schaltfläche, auf die der Benutzer klickt, um die Beschreibungsdatei hochzuladen, und die UploadHelpText -Eigenschaft enthält die Anweisungen für den Uploadprozess.
Die ImportCatalogPart -Klasse enthält auch mehrere eindeutige Methoden. Die GetAvailableWebPartDescriptions -Methode ruft ein WebPartDescription -Objekt für jedes WebPart Steuerelement im Katalog ab, wodurch ein ImportCatalogPart Steuerelement Informationen zu jedem Serversteuerelement anzeigen kann, ohne eine instance davon erstellen zu müssen. Die GetWebPart -Methode ruft basierend auf der an die -Methode übergebenen Beschreibung einen instance eines bestimmten WebPart Steuerelements ab.
Es gibt einige inhärente Risiken, die mit der Verwendung des Steuerelements ImportCatalogPart verbunden sind. Ein Beispiel ist die Möglichkeit, böswillige Daten über die für den Import verwendeten Beschreibungsdateien in Ihre Webanwendung zu importieren. Wenn jemand schädlichen Skriptcode als Wert einer Zeichenfolgeneigenschaft in der Beschreibungsdatei platziert hat, kann dieses Skript möglicherweise ausgeführt werden, wenn ein Benutzer die Beschreibungsdatei importiert und das Serversteuerelement, auf das verwiesen wird, einer Webseite hinzufügt. Um das Risiko des Importierens von Beschreibungsdateien mit schädlichen Daten zu minimieren, sollten Serversteuerelemente, die Zeichenfolgeneigenschaften aufweisen, die Eigenschaftendaten immer codieren. Ein weiteres Risiko besteht im Importieren von Typen über Beschreibungsdateien (siehe Webparts-Steuerelementbeschreibungsdateien). Ein böswilliger Benutzer kann Anforderungen zum Laden vieler Assemblys in die AppDomainübermitteln, was zu einer übermäßigen Arbeitsspeicherauslastung führt.
Um die mit dem Import verbundenen Risiken zu vermeiden, können Sie das Feature vollständig deaktivieren, indem Sie das Importfeature oder das ImportCatalogPart Steuerelement nicht verwenden. Oder Sie können einschränken, welche Benutzer Zugriff auf das Steuerelement haben. Sie könnten dies programmgesteuert mithilfe der Rollenverwaltung tun (siehe Verwalten der Autorisierung mithilfe von Rollen). Bei instance können Sie beim Laden der Seite testen, ob sich ein Benutzer in einer bestimmten Rolle befindet, z. B. die Administratorrolle. Wenn sich der Benutzer in der Rolle befindet, können Sie das ImportCatalogPart Steuerelement programmgesteuert der Seite für diesen Benutzer hinzufügen. Sie können auch einen deklarativen Ansatz verwenden, um die Gruppe von Benutzern einzuschränken, die das ImportCatalogPart Steuerelement verwenden können. Auf Ihrer Webseite, die einen Katalog enthält, können Sie zwei CatalogZone Steuerelemente platzieren: eines für Benutzer, die importieren können, und eines für diejenigen, die dies nicht können. Die Zone für Benutzer, die importieren können, würde das ImportCatalogPart Steuerelement enthalten. Die Zone selbst könnte in einem LoginView Steuerelement platziert werden, wodurch Sie die Verwendung des Steuerelements in der Zone auf die von Ihnen angegebenen authentifizierten Benutzer oder Rollen beschränken können.
Konstruktoren
| ImportCatalogPart() |
Initialisiert eine neue Instanz der ImportCatalogPart-Klasse. |
Eigenschaften
| AccessKey |
Ruft die Zugriffstaste ab, mit der Sie schnell zum Webserversteuerelement navigieren können, oder legt diese fest. (Geerbt von WebControl) |
| Adapter |
Ruft den browserspezifischen Adapter für das Steuerelement ab. (Geerbt von Control) |
| 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) |
| Attributes |
Ruft die Auflistung von beliebigen Attributen (nur für die Darstellung) ab, die keinen Eigenschaften des Steuerelements entsprechen. (Geerbt von WebControl) |
| BackColor |
Ruft die Hintergrundfarbe des Webserversteuerelements ab oder legt diese fest. (Geerbt von WebControl) |
| BackImageUrl |
Ruft die URL des Hintergrundbildes für das Auswahlbereich-Steuerelement ab oder legt diese fest. (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 |
Ruft die Rahmenart des Webserversteuerelements ab oder legt diese fest. (Geerbt von WebControl) |
| BorderWidth |
Ruft die Rahmenbreite des Webserversteuerelements ab oder legt diese fest. (Geerbt von WebControl) |
| BrowseHelpText |
Ruft eine Textmeldung ab, die Benutzer auffordert, in das Verzeichnis einer Beschreibungsdatei zu wechseln, oder legt diese Textmeldung fest. |
| 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 ein Teilsteuerelement sich im minimierten oder normalen Zustand befindet. (Geerbt von Part) |
| ChromeType |
Ruft den Typ des Rahmens ab, der ein Webparts-Steuerelement umgibt, oder legt diesen fest. (Geerbt von Part) |
| 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) |
| 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 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 hauptsächlich von Steuerelemententwicklern verwendet. (Geerbt von WebControl) |
| CssClass |
Ruft die vom Webserversteuerelement auf dem Client gerenderte CSS-Klasse (Cascading Style Sheet) ab oder legt diese fest. (Geerbt von WebControl) |
| 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) |
| DefaultButton |
Ruft ab oder legt fest, welche Schaltfläche in der Benutzeroberfläche als Standardschaltfläche behandelt wird, die den Fokus erhält, wenn ein Formular gerendert wird, das die Schaltfläche enthält. Diese Eigenschaft ist nicht für den Aufruf aus Seitenentwicklercode vorgesehen. |
| Description |
Ruft einen kurzen Ausdruck ab, der die Funktion des Teilsteuerelements zusammenfasst und in QuickInfos und Katalogen von Teilsteuerelementen verwendet wird, oder legt diesen fest. (Geerbt von Part) |
| DesignMode |
Ruft einen Wert ab, der angibt, ob ein Steuerelement auf einer Entwurfsoberfläche verwendet wird. (Geerbt von Control) |
| Direction |
Ruft die Richtung ab, in der Steuerelemente mit Text in einem Panel-Steuerelement angezeigt werden sollen, oder legt diese fest. (Geerbt von Panel) |
| DisplayTitle |
Ruft eine Zeichenfolge ab, die den aktuellen Titel eines CatalogPart-Steuerelements enthält. (Geerbt von CatalogPart) |
| Enabled |
Ruft einen Wert ab, der angibt, ob das Webserversteuerelement aktiviert ist, oder legt diesen fest. (Geerbt von WebControl) |
| EnableTheming |
Ruft einen Wert ab, der angibt, ob für dieses Steuerelement Designs gelten, oder legt diesen fest. (Geerbt von WebControl) |
| 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) |
| Font |
Ruft die Schriftarteigenschaften ab, die dem Webserversteuerelement zugeordnet sind. (Geerbt von WebControl) |
| ForeColor |
Ruft die Vordergrundfarbe (i. A. die Textfarbe) für das Webserversteuerelement ab oder legt diese fest. (Geerbt von WebControl) |
| GroupingText |
Ruft die Beschriftung für die Gruppe von Steuerelementen im Bereichssteuerelement ab oder legt diese fest. (Geerbt von Panel) |
| HasAttributes |
Ruft einen Wert ab, der angibt, ob für das Steuerelement Attribute festgelegt wurden. (Geerbt von WebControl) |
| 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) |
| Height |
Ruft die Höhe des Webserversteuerelements ab oder legt diese fest. (Geerbt von WebControl) |
| HorizontalAlign |
Ruft die horizontale Ausrichtung des Inhalts im Bereich ab oder legt diese 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 als Trennzeichen für Steuerelementbezeichner verwendete Zeichen ab. (Geerbt von Control) |
| ImportedPartLabelText |
Ruft Text ab oder legt Text fest, der nach dem Import einer Beschreibungsdatei angezeigt wird und der das importierte Steuerelement im Katalog der importierten Steuerelemente darstellt oder beschreibt. |
| IsChildControlStateCleared |
Ruft einen Wert ab, der angibt, ob in diesem Steuerelements enthaltene Steuerelemente über einen Steuerelementzustand verfügen. (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 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) |
| 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) |
| PartImportErrorLabelText |
Ruft eine Fehlermeldung ab, die angezeigt wird, wenn während des Importvorgangs ein Fehler auftritt, oder legt diese fest. |
| RenderingCompatibility |
Ruft einen Wert ab, der die ASP.NET-Version angibt, mit der gerenderte HTML-Objekte kompatibel sind. (Geerbt von Control) |
| ScrollBars |
Ruft Sichtbarkeit und Position der Bildlaufleisten in einem Panel-Steuerelement ab oder legt diese fest. (Geerbt von Panel) |
| 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 WebControl) |
| Style |
Ruft eine Auflistung der Textattribute ab, die im äußeren Tag des Webserversteuerelements als Formatvorlagenattribut gerendert werden. (Geerbt von WebControl) |
| SupportsDisabledAttribute |
Ruft einen Wert ab, der angibt, ob vom Steuerelement das |
| TabIndex |
Ruft den Index der Aktivierreihenfolge des Webserversteuerelements ab oder legt diesen fest. (Geerbt von WebControl) |
| TagKey |
Ruft den HtmlTextWriterTag-Wert ab, der 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 |
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) |
| Title |
Ruft den Titel ab, der in der Titelleiste eines ImportCatalogPart-Steuerelements angezeigt wird, oder legt diesen fest. |
| ToolTip |
Ruft den Text ab, der angezeigt wird, wenn mit dem Mauszeiger auf das Webserversteuerelement gezeigt wird, oder legt diesen fest. (Geerbt von WebControl) |
| UniqueID |
Ruft den eindeutigen, hierarchisierten Bezeichner für das Serversteuerelement ab. (Geerbt von Control) |
| UploadButtonText |
Ruft den Text für das Button-Steuerelement ab, das das Hochladen einer Beschreibungsdatei startet, oder legt diesen fest. |
| UploadHelpText |
Ruft den Text der Meldung ab, mit der dem Benutzer das Hochladen einer Beschreibungsdatei erklärt wird, oder legt diesen Text fest. |
| 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) |
| WebPartManager |
Ruft einen Verweis auf die aktuelle Instanz der WebPartManager-Klasse ab. (Geerbt von CatalogPart) |
| Width |
Ruft die Breite des Webserver-Steuerelements ab oder legt sie fest. (Geerbt von WebControl) |
| Wrap |
Ruft einen Wert ab, der angibt, ob der Inhalt des Auswahlbereichs umbrochen wird, oder legt diesen fest. (Geerbt von Panel) |
| Zone |
Ruft einen Verweis auf die CatalogZoneBase-Zone ab, die ein CatalogPart-Steuerelement enthält. (Geerbt von CatalogPart) |
Methoden
| AddAttributesToRender(HtmlTextWriter) |
Fügt der Liste der darzustellenden Attribute Informationen über das Hintergrundbild, die Ausrichtung, den Umbruch und die Richtung hinzu. (Geerbt von Panel) |
| 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) |
| ApplyStyle(Style) |
Kopiert alle nicht leeren Elemente der angegebenen Formatvorlage in das Websteuerelement und überschreibt hierbei alle vorhandenen Formatvorlagenelemente des Steuerelements. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet. (Geerbt von WebControl) |
| 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 |
| 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) |
| CopyBaseAttributes(WebControl) |
Kopiert die nicht vom Style-Objekt gekapselten Eigenschaften aus dem angegebenen Webserversteuerelement in das Webserversteuerelement, von dem aus diese Methode aufgerufen wird. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet. (Geerbt von WebControl) |
| 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) |
| CreateControlStyle() |
Erstellt ein Formatvorlagenobjekt, das vom Panel-Steuerelement intern zum Implementieren aller auf Formatvorlagen bezogenen Eigenschaften verwendet wird. (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 der Option, das DataBinding-Ereignis auszulösen. (Geerbt von Control) |
| DataBindChildren() |
Bindet eine Datenquelle an die untergeordneten Steuerelemente des Serversteuerelements. (Geerbt von Control) |
| 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) |
| FindControl(String) |
Durchsucht den aktuellen Benennungscontainer nach dem angegebenen Serversteuerelement mit dem angegebenen |
| FindControl(String, Int32) |
Durchsucht den aktuellen Benennungscontainer nach einem Serversteuerelement mit der angegebenen |
| Focus() |
Legt den Eingabefokus auf ein Steuerelement fest. (Geerbt von Control) |
| GetAvailableWebPartDescriptions() |
Gibt eine Auflistung der Beschreibungen der verfügbaren WebPart-Steuerelemente in einem Katalog zurück. |
| GetDesignModeState() |
Ruft den aktuellen Zustand einer übergeordneten Zone des CatalogPart-Steuerelements ab. (Geerbt von CatalogPart) |
| GetHashCode() |
Fungiert 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 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) |
| GetWebPart(WebPartDescription) |
Gibt auf der Grundlage der an die Methode übergebenen Werte in der Beschreibung einen Verweis auf ein WebPart-Steuerelement zurück. |
| 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) |
| IsLiteralContent() |
Ermittelt, ob das Serversteuerelement nur literalen Inhalt enthält. (Geerbt von Control) |
| LoadControlState(Object) |
Stellt die Informationen zum Steuerelementzustand aus einer früheren Seitenanforderung wieder her, die durch die SaveControlState()-Methode gespeichert wurden. (Geerbt von Control) |
| LoadViewState(Object) |
Stellt Ansichtszustandsinformationen von einer vorherigen Anforderung wieder her, die mit der SaveViewState()-Methode gespeichert wurde. (Geerbt von WebControl) |
| 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) |
| 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 in der UI-Serversteuerelementhierarchie der Seite nach oben ü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 CatalogPart) |
| OnUnload(EventArgs) |
Löst das Unload-Ereignis aus. (Geerbt von Control) |
| OpenFile(String) |
Ruft einen Stream zum Lesen einer Datei ab. (Geerbt von Control) |
| RaiseBubbleEvent(Object, EventArgs) |
Weist dem übergeordneten Element des Steuerelements alle Ereignisquellen und zugehörige Informationen 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 im angegebenen HTML-Writer. (Geerbt von WebControl) |
| RenderBeginTag(HtmlTextWriter) |
Gibt das öffnende HTML-Tag des Panel-Steuerelements im angegebenen Writer wieder. (Geerbt von Panel) |
| 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) |
| RenderContents(HtmlTextWriter) |
Rendert den Inhalt des Steuerelements im angegebenen Writer. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet. (Geerbt von WebControl) |
| 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) |
| RenderEndTag(HtmlTextWriter) |
Gibt das schließende HTML-Tag des Panel-Steuerelements im angegebenen Writer wieder. (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) |
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 jeden Zustand, der nach dem Aufrufen der TrackViewState()-Methode geändert wurde. (Geerbt von WebControl) |
| SetDesignModeState(IDictionary) |
Legt die Entwurfszeitdaten für ein Steuerelement fest. (Geerbt von CatalogPart) |
| SetRenderMethodDelegate(RenderMethod) |
Beauftragt einen Ereignishandlerdelegaten, das Serversteuerelement und seinen Inhalt im übergeordneten Steuerelement zu rendern. (Geerbt von Control) |
| 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) |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |
| TrackViewState() |
Bewirkt, dass das Steuerelement Änderungen an seinem Ansichtszustand in der ViewState-Eigenschaft des Objekts nachverfolgt. (Geerbt von WebControl) |
Ereignisse
| 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) |
| 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) |
Ruft ein Attribut des Websteuerelements mit dem angegebenen Namen ab. (Geerbt von WebControl) |
| IAttributeAccessor.SetAttribute(String, String) |
Legt zum angegebenen Namen und Wert ein Attribut des Websteuerelements fest. (Geerbt von WebControl) |
| ICompositeControlDesignerAccessor.RecreateChildControls() |
Ermöglicht es dem Entwickler eines Designers für ein zusammengesetztes Teilsteuerelement, die untergeordneten Steuerelemente des Steuerelements auf der Entwurfsoberfläche erneut zu erstellen. (Geerbt von Part) |
| 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) |
| IParserAccessor.AddParsedSubObject(Object) |
Eine Beschreibung dieses Elements finden Sie unter AddParsedSubObject(Object). (Geerbt von Control) |
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
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für