DynamicControl 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.
Zeigt mithilfe von ASP.NET Dynamic Data-Features den für das Feld definierten Inhalt in auf Vorlagen basierenden datengebundenen Steuerelementen an.
public ref class DynamicControl : System::Web::UI::Control, System::Web::DynamicData::IFieldFormattingOptions, System::Web::DynamicData::IFieldTemplateHost, System::Web::UI::IAttributeAccessor[System.Drawing.ToolboxBitmap(typeof(System.Web.DynamicData.DynamicControl), "DynamicControl.ico")]
public class DynamicControl : System.Web.UI.Control, System.Web.DynamicData.IFieldFormattingOptions, System.Web.DynamicData.IFieldTemplateHost, System.Web.UI.IAttributeAccessor[System.Drawing.ToolboxBitmap(typeof(System.Web.DynamicData.DynamicControl), "DynamicControl.bmp")]
public class DynamicControl : System.Web.UI.Control, System.Web.DynamicData.IFieldFormattingOptions, System.Web.DynamicData.IFieldTemplateHost, System.Web.UI.IAttributeAccessor[<System.Drawing.ToolboxBitmap(typeof(System.Web.DynamicData.DynamicControl), "DynamicControl.ico")>]
type DynamicControl = class
inherit Control
interface IAttributeAccessor
interface IFieldTemplateHost
interface IFieldFormattingOptions[<System.Drawing.ToolboxBitmap(typeof(System.Web.DynamicData.DynamicControl), "DynamicControl.bmp")>]
type DynamicControl = class
inherit Control
interface IAttributeAccessor
interface IFieldTemplateHost
interface IFieldFormattingOptionsPublic Class DynamicControl
Inherits Control
Implements IAttributeAccessor, IFieldFormattingOptions, IFieldTemplateHost- Vererbung
- Attribute
- Implementiert
Beispiele
Sehen Sie sich ein Beispiel für den Laufzeitcode dieses Features an: Ausführen.
Im folgenden Beispiel wird veranschaulicht, wie Sie das DynamicControl -Steuerelement in einem ListView -Steuerelement verwenden, um Werte aus einer Datenbanktabelle anzuzeigen, einzufügen, zu löschen und zu bearbeiten. Beachten Sie, dass die -Eigenschaft der Spalten und ModifiedDate auf festgelegt trueist, damit der IsDbGeneratedrowguid Einfügevorgang funktioniert.
<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
protected void Page_Init(object sender, EventArgs e)
{
DynamicDataManager1.RegisterControl(ListView1);
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
<title>DynamicControl Sample</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<asp:DynamicDataManager ID="DynamicDataManager1" runat="server"
AutoLoadForeignKeys="true" />
<asp:ValidationSummary ID="InsertValidationSummary" runat="server" EnableClientScript="true"
HeaderText="List of validation errors" ValidationGroup="Insert" />
<asp:DynamicValidator runat="server" ID="InsertValidator"
ControlToValidate="ListView1" ValidationGroup="Insert" Display="None" />
<asp:ValidationSummary ID="EditValidationSummary" runat="server" EnableClientScript="true"
HeaderText="List of validation errors" ValidationGroup="Edit" />
<asp:DynamicValidator runat="server" ID="EditValidator"
ControlToValidate="ListView1" ValidationGroup="Edit" Display="None" />
<asp:ListView ID="ListView1" runat="server" DataSourceID="LinqDataSource1"
InsertItemPosition="LastItem">
<LayoutTemplate>
<table cellpadding="2" border="1" runat="server" id="tblCustomers">
<tr runat="server">
<th runat="server"> </th>
<th runat="server">Name</th>
<th runat="server">Number</th>
<th runat="server">Standard Cost</th>
<th runat="server">List Price</th>
<th runat="server">Sell Start Date</th>
</tr>
<tr runat="server" id="itemPlaceholder" />
</table>
<asp:DataPager runat="server" ID="CustomersPager" PageSize="20">
<Fields>
<asp:NumericPagerField ButtonCount="10" />
</Fields>
</asp:DataPager>
</LayoutTemplate>
<ItemTemplate>
<tr runat="server">
<td>
<asp:LinkButton ID="EditButton" runat="server" CommandName="Edit"
Text="Edit" CausesValidation="false" />
<asp:LinkButton ID="DeleteButton" runat="server" CommandName="Delete"
Text="Delete" CausesValidation="false"
OnClientClick='return confirm("Are you sure you want to delete this item?");' />
</td>
<td>
<asp:DynamicControl runat="server" DataField="Name" />
</td>
<td>
<asp:DynamicControl runat="server" DataField="ProductNumber" />
</td>
<td align="right">
<asp:DynamicControl runat="server" DataField="StandardCost" DataFormatString="{0:C}" />
</td>
<td align="right">
<asp:DynamicControl runat="server" DataField="ListPrice" DataFormatString="{0:C}" />
</td>
<td align="center">
<asp:DynamicControl runat="server" DataField="SellStartDate"
DataFormatString="{0:MM/dd/yyyy}" NullDisplayText=" " />
</td>
</tr>
</ItemTemplate>
<EditItemTemplate>
<tr>
<td>
<asp:LinkButton ID="UpdateButton" runat="server" CommandName="Update"
Text="Update" ValidationGroup="Edit" />
<asp:LinkButton ID="CancelButton" runat="server" CommandName="Cancel"
Text="Cancel" CausesValidation="false" />
</td>
<td>
<asp:DynamicControl runat="server" DataField="Name" Mode="Edit" ValidationGroup="Edit" />
</td>
<td>
<asp:DynamicControl runat="server" DataField="ProductNumber" Mode="Edit" ValidationGroup="Edit" />
</td>
<td>
<asp:DynamicControl runat="server" DataField="StandardCost" Mode="Edit" ValidationGroup="Edit" />
</td>
<td>
<asp:DynamicControl runat="server" DataField="ListPrice" Mode="Edit" ValidationGroup="Edit" />
</td>
<td>
<asp:DynamicControl runat="server" DataField="SellStartDate" Mode="Edit"
ValidationGroup="Edit" DataFormatString="{0:MM/dd/yyyy}" ApplyFormatInEditMode="true" />
</td>
</tr>
</EditItemTemplate>
<InsertItemTemplate>
<tr>
<td>
<asp:LinkButton ID="InsertButton" runat="server" CommandName="Insert"
Text="Insert" ValidationGroup="Insert" />
<asp:LinkButton ID="CancelButton" runat="server" CommandName="Cancel"
Text="Cancel" CausesValidation="false" />
</td>
<td>
<asp:DynamicControl runat="server" DataField="Name" Mode="Insert" ValidationGroup="Insert" />
</td>
<td>
<asp:DynamicControl runat="server" DataField="ProductNumber" Mode="Insert" ValidationGroup="Insert" />
</td>
<td>
<asp:DynamicControl runat="server" DataField="StandardCost" Mode="Insert" ValidationGroup="Insert" />
</td>
<td>
<asp:DynamicControl runat="server" DataField="ListPrice" Mode="Insert" ValidationGroup="Insert" />
</td>
<td>
<asp:DynamicControl runat="server" DataField="SellStartDate" Mode="Insert" ValidationGroup="Insert" />
</td>
</tr>
</InsertItemTemplate>
</asp:ListView>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the AdventureWorksLT sample database. -->
<asp:LinqDataSource ID="LinqDataSource1" runat="server"
TableName="Products"
ContextTypeName="AdventureWorksLTDataContext"
EnableUpdate="true"
EnableDelete="true"
EnableInsert="true" >
</asp:LinqDataSource>
</div>
</form>
</body>
</html>
<%@ Page Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Protected Sub Page_Init(ByVal sender As Object, ByVal e As System.EventArgs)
DynamicDataManager1.RegisterControl(ListView1)
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
<title>DynamicControl Sample</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<asp:DynamicDataManager ID="DynamicDataManager1" runat="server"
AutoLoadForeignKeys="true" />
<asp:ValidationSummary ID="InsertValidationSummary" runat="server" EnableClientScript="true"
HeaderText="List of validation errors" ValidationGroup="Insert" />
<asp:DynamicValidator runat="server" ID="InsertValidator"
ControlToValidate="ListView1" ValidationGroup="Insert" Display="None" />
<asp:ValidationSummary ID="EditValidationSummary" runat="server" EnableClientScript="true"
HeaderText="List of validation errors" ValidationGroup="Edit" />
<asp:DynamicValidator runat="server" ID="EditValidator"
ControlToValidate="ListView1" ValidationGroup="Edit" Display="None" />
<asp:ListView ID="ListView1" runat="server" DataSourceID="LinqDataSource1"
InsertItemPosition="LastItem">
<LayoutTemplate>
<table cellpadding="2" border="1" runat="server" id="tblCustomers">
<tr runat="server">
<th runat="server"> </th>
<th runat="server">Name</th>
<th runat="server">Number</th>
<th runat="server">Standard Cost</th>
<th runat="server">List Price</th>
<th runat="server">Sell Start Date</th>
</tr>
<tr runat="server" id="itemPlaceholder" />
</table>
<asp:DataPager runat="server" ID="CustomersPager" PageSize="20">
<Fields>
<asp:NumericPagerField ButtonCount="10" />
</Fields>
</asp:DataPager>
</LayoutTemplate>
<ItemTemplate>
<tr runat="server">
<td>
<asp:LinkButton ID="EditButton" runat="server" CommandName="Edit"
Text="Edit" CausesValidation="false" />
<asp:LinkButton ID="DeleteButton" runat="server" CommandName="Delete"
Text="Delete" CausesValidation="false"
OnClientClick='return confirm("Are you sure you want to delete this item?");' />
</td>
<td>
<asp:DynamicControl runat="server" DataField="Name" />
</td>
<td>
<asp:DynamicControl runat="server" DataField="ProductNumber" />
</td>
<td align="right">
<asp:DynamicControl runat="server" DataField="StandardCost" DataFormatString="{0:C}" />
</td>
<td align="right">
<asp:DynamicControl runat="server" DataField="ListPrice" DataFormatString="{0:C}" />
</td>
<td align="center">
<asp:DynamicControl runat="server" DataField="SellStartDate"
DataFormatString="{0:MM/dd/yyyy}" NullDisplayText=" " />
</td>
</tr>
</ItemTemplate>
<EditItemTemplate>
<tr>
<td>
<asp:LinkButton ID="UpdateButton" runat="server" CommandName="Update"
Text="Update" ValidationGroup="Edit" />
<asp:LinkButton ID="CancelButton" runat="server" CommandName="Cancel"
Text="Cancel" CausesValidation="false" />
</td>
<td>
<asp:DynamicControl runat="server" DataField="Name" Mode="Edit" ValidationGroup="Edit" />
</td>
<td>
<asp:DynamicControl runat="server" DataField="ProductNumber" Mode="Edit" ValidationGroup="Edit" />
</td>
<td>
<asp:DynamicControl runat="server" DataField="StandardCost" Mode="Edit" ValidationGroup="Edit" />
</td>
<td>
<asp:DynamicControl runat="server" DataField="ListPrice" Mode="Edit" ValidationGroup="Edit" />
</td>
<td>
<asp:DynamicControl runat="server" DataField="SellStartDate" Mode="Edit"
ValidationGroup="Edit" DataFormatString="{0:MM/dd/yyyy}" ApplyFormatInEditMode="true" />
</td>
</tr>
</EditItemTemplate>
<InsertItemTemplate>
<tr>
<td>
<asp:LinkButton ID="InsertButton" runat="server" CommandName="Insert"
Text="Insert" ValidationGroup="Insert" />
<asp:LinkButton ID="CancelButton" runat="server" CommandName="Cancel"
Text="Cancel" CausesValidation="false" />
</td>
<td>
<asp:DynamicControl runat="server" DataField="Name" Mode="Insert" ValidationGroup="Insert" />
</td>
<td>
<asp:DynamicControl runat="server" DataField="ProductNumber" Mode="Insert" ValidationGroup="Insert" />
</td>
<td>
<asp:DynamicControl runat="server" DataField="StandardCost" Mode="Insert" ValidationGroup="Insert" />
</td>
<td>
<asp:DynamicControl runat="server" DataField="ListPrice" Mode="Insert" ValidationGroup="Insert" />
</td>
<td>
<asp:DynamicControl runat="server" DataField="SellStartDate" Mode="Insert" ValidationGroup="Insert" />
</td>
</tr>
</InsertItemTemplate>
</asp:ListView>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the AdventureWorksLT sample database. -->
<asp:LinqDataSource ID="LinqDataSource1" runat="server"
TableName="Products"
ContextTypeName="AdventureWorksLTDataContext"
EnableUpdate="true"
EnableDelete="true"
EnableInsert="true" >
</asp:LinqDataSource>
</div>
</form>
</body>
</html>
Hinweise
In diesem Thema:
Einführung
Das DynamicControl Steuerelement wird von datengebundenen Steuerelementen in Vorlagen verwendet, z FormView . B. oder ListView, um ein Datenfeld anzuzeigen, das ASP.NET Dynamic Data-Features auf einer benutzerdefinierten Seite verwendet. Sie können ein DynamicControl Steuerelement auch in einem TemplateField Feld eines GridView - oder eines -Steuerelements DetailsView verwenden.
Das DynamicControl -Steuerelement stellt Funktionen bereit, die der des Felds DynamicField ähneln. Da das DynamicControl Steuerelement jedoch nur in Vorlagen verwendet wird, bietet es Ihnen mehr Flexibilität bei der Steuerung der Anzeige der Daten, da Sie andere HTML-Elemente um das Feld hinzufügen können. Wenn Sie ein DynamicControl Steuerelement verwenden, können Sie die folgenden Dynamic Data-Features nutzen:
Automatisches Rendern des richtigen Steuerelements für ein Feld mithilfe von Feldvorlagen basierend auf dem Datentyp. Die Feldvorlagen können global für die gesamte Anwendung geändert werden.
Bereitstellen einer integrierten Datenvalidierung basierend auf dem Datenbankschema. Sie können auch Validierungstypen hinzufügen, indem Sie das Datenmodell anpassen.
Anpassen des Datenrenderings für einzelne Felder mithilfe von Attributen im Datenmodell oder mithilfe der UIHint -Eigenschaft.
Um das Feld anzugeben, das in einem DynamicControl Steuerelement angezeigt werden soll, legen Sie die DataField -Eigenschaft auf den Feldnamen fest. Sie können eine benutzerdefinierte Formatierungszeichenfolge auf den Feldwert anwenden, indem Sie die DataFormatString -Eigenschaft festlegen. Standardmäßig wird die Formatierungszeichenfolge nur auf Feldwerte angewendet, wenn sich das datengebundene Steuerelement im schreibgeschützten Modus befindet. Um die Formatierungszeichenfolge auf Werte anzuwenden, die angezeigt werden, während sich das datengebundene Steuerelement im Bearbeitungsmodus befindet, legen Sie die ApplyFormatInEditMode -Eigenschaft auf fest true. Wenn ein Feldwert istnull, können Sie einen benutzerdefinierten Untertitel anzeigen, indem Sie die NullDisplayText -Eigenschaft festlegen. Das DynamicControl Steuerelement kann auch leere Zeichenfolgenfeldwerte ("") automatisch in NULL-Werte konvertieren, indem die ConvertEmptyStringToNull -Eigenschaft auf truefestgelegt wird.
Das DynamicControl Steuerelement unterstützt verschiedene Anzeigemodi. Um den Modus anzugeben, in dem das DynamicControl Steuerelement angezeigt werden soll, legen Sie die Mode -Eigenschaft fest. Die folgende Tabelle zeigt die verschiedenen Modi.
ReadOnly für den Anzeigemodus. Dadurch wird verhindert, dass der Benutzer die Werte eines Datensatzes oder eines Datenfelds ändert. Sie kann in jeder der Vorlagen verwendet werden.
Edit für den Bearbeitungsmodus. Dadurch können Benutzer die Werte eines vorhandenen Datensatzes aktualisieren. Sie wird in der Bearbeitungsvorlage (in der Regel mit dem Namen ) EditItemTemplateverwendet.
Insert für den Einfügemodus. Dadurch können Benutzer Werte für einen neuen Datensatz eingeben. Sie wird in der Einfügevorlage (in der Regel mit dem Namen ) InsertItemTemplateverwendet.
Sie können ein DynamicControl Steuerelement in einem datengebundenen Steuerelement ausblenden, indem Sie die Visible -Eigenschaft auf falsefestlegen.
Deklarative Syntax
<asp:DynamicControl
ApplyFormatInEditMode="True|False"
ConvertEmptyStringToNull="True|False"
CssClass="string"
DataField="string"
DataFormatString="string"
EnableViewState="True|False"
HtmlEncode="True|False"
ID="string"
Mode="Edit|Insert|ReadOnly"
NullDisplayText="string"
OnDataBinding="DataBinding event handler"
OnDisposed="Disposed event handler"
OnInit="Init event handler"
OnLoad="Load event handler"
OnPreRender="PreRender event handler"
OnUnload="Unload event handler"
runat="server"
UIHint="string"
ValidationGroup="string"
Visible="True|False"
>
</asp:DynamicControl>
Konstruktoren
| DynamicControl() |
Initialisiert eine neue Instanz der DynamicControl-Klasse. |
| DynamicControl(DataBoundControlMode) |
Initialisiert eine neue Instanz der DynamicControl-Klasse mit dem angegebenen Modus. |
Eigenschaften
| Adapter |
Ruft den browserspezifischen Adapter für das Steuerelement ab. (Geerbt von Control) |
| ApplyFormatInEditMode |
Ruft einen Wert ab, der angibt, ob die von der DataFormatString-Eigenschaft angegebene Formatierungszeichenfolge auf Feldwerte angewendet wird, wenn sich das Datenfeld im Bearbeitungsmodus befindet, oder legt diesen Wert fest. |
| 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) |
| BindingContainer |
Ruft das Steuerelement ab, das die Datenbindung dieses Steuerelements enthält. (Geerbt von Control) |
| ChildControlsCreated |
Ruft einen Wert ab, der angibt, ob die untergeordneten Steuerelemente des Serversteuerelements erstellt wurden. (Geerbt von Control) |
| ClientID |
Ruft die Steuerelement-ID für HTML-Markup ab, das von ASP.NET generiert wird. (Geerbt von Control) |
| ClientIDMode |
Ruft den Algorithmus ab, mit dem der Wert der ClientID-Eigenschaft generiert wird, oder legt diesen fest. (Geerbt von Control) |
| ClientIDSeparator |
Ruft einen Zeichenwert ab, der das in der ClientID-Eigenschaft verwendete Trennzeichen darstellt. (Geerbt von Control) |
| Column |
Ruft das dem Steuerelement zugeordnete Spaltenobjekt ab oder legt es fest. |
| Context |
Ruft das dem Serversteuerelement für die aktuelle Webanforderung zugeordnete HttpContext-Objekt ab. (Geerbt von Control) |
| Controls |
Ruft ein ControlCollection-Objekt ab, das die untergeordneten Steuerelemente für ein angegebenes Serversteuerelement in der Hierarchie der Benutzeroberfläche darstellt. (Geerbt von Control) |
| ConvertEmptyStringToNull |
Ruft einen Wert ab, der angibt, ob bei der Aktualisierung des Datenfelds in der Datenquelle Werte, die leere Zeichenfolgen ("") darstellen, in NULL-Werte konvertiert werden, oder legt diesen fest. |
| CssClass |
Ruft die CSS (Cascading Style Sheet)-Klasse ab, die die Anzeigestile für den Inhalt des DynamicControl-Steuerelements angibt, oder legt diese fest. |
| DataField |
Ruft den Namen des Datenfelds ab, an das das DynamicControl-Steuerelement gebunden wird, oder legt diesen fest. |
| DataFormatString |
Ruft eine Zeichenfolge ab, die das Anzeigeformat für den Wert des Felds angibt, oder legt diese fest. |
| DataItemContainer |
Ruft einen Verweis auf den Namenscontainer ab, wenn vom Namenscontainer IDataItemContainer implementiert wird. (Geerbt von Control) |
| DataKeysContainer |
Ruft einen Verweis auf den Namenscontainer ab, wenn vom Namenscontainer IDataKeysControl implementiert wird. (Geerbt von Control) |
| DesignMode |
Ruft einen Wert ab, der angibt, ob ein Steuerelement auf einer Entwurfsoberfläche verwendet wird. (Geerbt von Control) |
| EnableTheming |
Ruft einen Wert ab, der angibt, ob für dieses Steuerelement Designs gelten, oder legt diesen fest. (Geerbt von Control) |
| 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) |
| FieldTemplate |
Ruft die Feldvorlage ab, die für das DynamicControl-Steuerelement erstellt wird. |
| 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) |
| HtmlEncode |
Ruft einen Wert ab, der angibt, ob die Daten für das Steuerelement vor dem Rendern HTML-codiert werden, oder legt diesen fest. |
| ID |
Ruft den programmgesteuerten Bezeichner ab, der dem Serversteuerelement zugewiesen ist, oder legt diesen fest. (Geerbt von Control) |
| IdSeparator |
Ruft das als Trennzeichen für Steuerelementbezeichner verwendete Zeichen ab. (Geerbt von Control) |
| IsChildControlStateCleared |
Ruft einen Wert ab, der angibt, ob in diesem Steuerelements enthaltene Steuerelemente über einen Steuerelementzustand verfügen. (Geerbt von Control) |
| 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) |
| Mode |
Ruft den Renderingmodus ab oder legt diesen fest. |
| NamingContainer |
Ruft einen Verweis auf den Benennungscontainer des Serversteuerelements ab, der einen eindeutigen Namespace erstellt, damit zwischen Serversteuerelementen mit demselben ID-Eigenschaftswert unterschieden werden kann. (Geerbt von Control) |
| NullDisplayText |
Ruft die Beschriftung ab, die für ein Datenfeld angezeigt wird, wenn der Wert des Felds |
| Page |
Ruft einen Verweis auf die Page-Instanz ab, die das Serversteuerelement enthält. (Geerbt von Control) |
| Parent |
Ruft einen Verweis auf das übergeordnete Steuerelement des Serversteuerelements in der Steuerelementhierarchie der Seite ab. (Geerbt von Control) |
| RenderingCompatibility |
Ruft einen Wert ab, der die ASP.NET-Version angibt, mit der gerenderte HTML-Objekte kompatibel sind. (Geerbt von Control) |
| Site |
Ruft Informationen zum Container ab, der das aktuelle Steuerelement hostet, wenn es auf einer Entwurfsoberfläche gerendert wird. (Geerbt von Control) |
| SkinID |
Ruft das Design ab, das auf das Steuerelement angewendet werden soll. (Geerbt von Control) |
| Table |
Ruft das Tabellenobjekt ab, das dem Steuerelement zugeordnet ist. |
| 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) |
| UIHint |
Ruft den Namen der Feldvorlage ab, die zum Rendern des Datenfelds verwendet wird, oder legt diesen fest. |
| UniqueID |
Ruft den eindeutigen, hierarchisierten Bezeichner für das Serversteuerelement ab. (Geerbt von Control) |
| ValidateRequestMode |
Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob das Steuerelement Clienteingaben des Browser auf gefährliche Werte überprüft. (Geerbt von Control) |
| ValidationGroup |
Ruft den Namen der Validierungsgruppe für das Steuerelement ab oder legt diesen fest. |
| ViewState |
Ruft ein Wörterbuch mit Zustandsinformationen ab, mit dem Sie den Ansichtszustand eines Serversteuerelements über mehrere Anforderungen für dieselbe Seite hinweg speichern und wiederherstellen können. (Geerbt von Control) |
| ViewStateIgnoresCase |
Ruft einen Wert ab, der angibt, ob bei dem StateBag-Objekt die Groß- und Kleinschreibung nicht berücksichtigt wird. (Geerbt von Control) |
| ViewStateMode |
Ruft den Ansichtszustandsmodus des Steuerelements ab oder legt ihn fest. (Geerbt von Control) |
| Visible |
Ruft einen Wert ab, der angibt, ob ein Serversteuerelement auf der Seite als Benutzeroberfläche gerendert wird. (Geerbt von Control) |
Methoden
| AddedControl(Control, Int32) |
Wird aufgerufen, nachdem ein untergeordnetes Steuerelement zur Controls-Auflistung des Control-Objekts hinzugefügt wurde. (Geerbt von Control) |
| AddParsedSubObject(Object) |
Benachrichtigt das Serversteuerelement, dass entweder ein XML-Element oder HTML-Element analysiert wurde, und fügt das Element dem ControlCollection-Objekt des Serversteuerelements hinzu. (Geerbt von Control) |
| ApplyStyleSheetSkin(Page) |
Übernimmt die im Stylesheet der Seite definierten Stileigenschaften für das Steuerelement. (Geerbt von Control) |
| BeginRenderTracing(TextWriter, Object) |
Startet die Entwurfszeitablaufverfolgung des Renderns von Daten. (Geerbt von Control) |
| BuildProfileTree(String, Boolean) |
Sammelt Informationen zum Serversteuerelement und übermittelt sie an die Trace-Eigenschaft, sodass diese angezeigt werden, wenn die Ablaufverfolgung für die Seite aktiviert ist. (Geerbt von Control) |
| ClearCachedClientID() |
Legt den zwischengespeicherten ClientID-Wert auf |
| 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) |
| 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) |
| DataBind() |
Bindet eine Datenquelle an das aufgerufene Serversteuerelement und alle untergeordneten Steuerelemente. (Geerbt von Control) |
| DataBind(Boolean) |
Bindet eine Datenquelle an das aufgerufene Serversteuerelement und alle untergeordneten Steuerelemente mit der Option, das DataBinding-Ereignis auszulösen. (Geerbt von Control) |
| DataBindChildren() |
Bindet eine Datenquelle an die untergeordneten Steuerelemente des Serversteuerelements. (Geerbt von Control) |
| 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) |
| GetAttribute(String) |
Ruft den Attributwert mithilfe des angegebenen Schlüssels ab. |
| GetDesignModeState() |
Ruft die Entwurfszeitdaten für ein Steuerelement ab. (Geerbt von Control) |
| 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) |
| 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 die Informationen über den Ansichtszustand aus einer früheren Seitenanforderung wieder her, die mit der SaveViewState()-Methode gespeichert wurden. (Geerbt von Control) |
| 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) |
| 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. |
| OnLoad(EventArgs) |
Löst das Load-Ereignis aus. (Geerbt von Control) |
| OnPreRender(EventArgs) |
Löst das PreRender-Ereignis aus. (Geerbt von Control) |
| OnUnload(EventArgs) |
Löst das Unload-Ereignis aus. (Geerbt von Control) |
| OpenFile(String) |
Ruft einen Stream zum Lesen einer Datei ab. (Geerbt von Control) |
| 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 den Inhalt des DynamicControl-Steuerelements mithilfe des angegebenen HtmlTextWriter-Objekts im Browser des Clients. |
| RenderChildren(HtmlTextWriter) |
Gibt den Inhalt der untergeordneten Elemente eines Serversteuerelements an ein bereitgestelltes HtmlTextWriter-Objekt aus, das den auf dem Client zu rendernden Inhalt schreibt. (Geerbt von Control) |
| RenderControl(HtmlTextWriter) |
Gibt Inhalte von Serversteuerelementen an ein bereitgestelltes HtmlTextWriter-Objekt aus und speichert Ablaufverfolgungsinformationen zum Steuerelement, sofern die Ablaufverfolgung aktiviert ist. (Geerbt von Control) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Gibt Inhalte von Serversteuerelementen mithilfe eines bereitgestellten HtmlTextWriter-Objekts an ein bereitgestelltes ControlAdapter-Objekt aus. (Geerbt von Control) |
| ResolveAdapter() |
Ruft den Steuerelementadapter ab, der für das Rendern des angegebenen Steuerelements verantwortlich ist. (Geerbt von Control) |
| ResolveClientUrl(String) |
Ruft eine URL ab, die vom Browser verwendet werden kann. (Geerbt von Control) |
| ResolveUrl(String) |
Konvertiert eine URL in eine vom anfordernden Client verwendbare URL. (Geerbt von Control) |
| SaveControlState() |
Speichert alle Zustandsänderungen des Serversteuerelements, die seit dem Zeitpunkt aufgetreten sind, zu dem die Seite an den Server zurückgesendet wurde. (Geerbt von Control) |
| SaveViewState() |
Speichert alle Ansichtszustandsänderungen des Serversteuerelements, die seit dem Zeitpunkt aufgetreten sind, zu dem die Seite an den Server zurückgesendet wurde. (Geerbt von Control) |
| SetAttribute(String, String) |
Legt das angegebene Attribut auf den angegebenen Wert fest. |
| SetDesignModeState(IDictionary) |
Legt die Entwurfszeitdaten für ein Steuerelement fest. (Geerbt von Control) |
| SetRenderMethodDelegate(RenderMethod) |
Beauftragt einen Ereignishandlerdelegaten, das Serversteuerelement und seinen Inhalt im übergeordneten Steuerelement zu rendern. (Geerbt von Control) |
| 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() |
Veranlasst die Überwachung von Änderungen am Ansichtszustand des Serversteuerelements, sodass die Änderungen im StateBag-Objekt des Serversteuerelements gespeichert werden können. Auf dieses Objekt kann über die ViewState-Eigenschaft zugegriffen werden. (Geerbt von Control) |
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
| 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) |
| IFieldTemplateHost.FormattingOptions |
Eine Beschreibung dieses Elements finden Sie unter FormattingOptions. |
| IParserAccessor.AddParsedSubObject(Object) |
Eine Beschreibung dieses Elements finden Sie unter AddParsedSubObject(Object). (Geerbt von Control) |
Erweiterungsmethoden
| ConvertEditedValue(IFieldFormattingOptions, String) |
Gibt den Wert zurück, der durch einen Benutzer für ein Steuerelement bereitgestellt wird, das überprüft wird. |
| 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. |
| FormatEditValue(IFieldFormattingOptions, Object) |
Formatiert den angegebenen Feldwert mit den angegebenen Formatierungsoptionen. |
| FormatValue(IFieldFormattingOptions, Object) |
Formatiert den angegebenen Feldwert mit den angegebenen Formatierungsoptionen. |
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