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 den Inhalt an, der für das Feld in datengebundenen Vorlagensteuerelementen mit ASP.NET dynamischen Datenfeatures definiert ist.
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
Im folgenden Beispiel wird veranschaulicht, wie das DynamicControl Steuerelement in einem ListView Steuerelement verwendet wird, um Werte aus einer Datenbanktabelle anzuzeigen, einzufügen, einzufügen, zu löschen und zu bearbeiten. Es ist wichtig zu beachten, dass die Eigenschaft der rowguid Einfüge- und ModifiedDate Spalten-Eigenschaft festgelegt isttrue, IsDbGenerated damit der 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 vorlagenbasierten datengebundenen Steuerelementen verwendet, z FormView . B. oder ListView, um ein Datenfeld anzuzeigen, das ASP.NET dynamische Datenfeatures auf einer benutzerdefinierten Seite verwendet. Sie können auch ein DynamicControl Steuerelement in einem TemplateField Feld eines GridView oder eines DetailsView Steuerelements verwenden.
Das DynamicControl Steuerelement stellt Funktionen bereit, die dem des DynamicField Felds ähneln. Da das DynamicControl Steuerelement jedoch nur innerhalb von Vorlagen verwendet wird, bietet es Ihnen mehr Flexibilität, die Anzeige der Daten zu steuern, da Sie weitere HTML-Elemente um das Feld hinzufügen können. Wenn Sie ein DynamicControl Steuerelement verwenden, können Sie die folgenden Dynamischen Datenfeatures nutzen:
Automatisches Rendern des richtigen Steuerelements für ein Feld mithilfe von Feldvorlagen basierend auf dem Datentyp. Die Feldvorlagen können für die gesamte Anwendung global geändert werden.
Bereitstellen einer integrierten Datenüberprüfung basierend auf dem Datenbankschema. Sie können auch Überprüfungstypen hinzufügen, indem Sie das Datenmodell anpassen.
Anpassen des Datenrenderings für einzelne Felder mithilfe von Attributen im Datenmodell oder mithilfe der UIHint Eigenschaft.
Wenn Sie das feld angeben möchten, 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 dann auf Feldwerte angewendet, wenn sich das datengebundene Steuerelement im schreibgeschützten Modus befindet. Wenn Sie die Formatierungszeichenfolge auf Werte anwenden möchten, die angezeigt werden, während sich das datengebundene Steuerelement im Bearbeitungsmodus befindet, legen Sie die ApplyFormatInEditMode Eigenschaft auf true. Wenn ein Feldwert lautet null, können Sie eine benutzerdefinierte Beschriftung anzeigen, indem Sie die NullDisplayText Eigenschaft festlegen. Das DynamicControl Steuerelement kann auch leere Zeichenfolgenwerte ("") automatisch in NULL-Werte konvertieren, indem die ConvertEmptyStringToNull Eigenschaft auf true. festgelegt 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. In der folgenden Tabelle sind die verschiedenen Modi aufgeführt.
ReadOnly für den Anzeigemodus. Dadurch wird verhindert, dass der Benutzer die Werte eines Datensatzes oder eines Datenfelds ändert. Sie kann in einer der Vorlagen verwendet werden.
Edit für den Bearbeitungsmodus. Auf diese Weise können Benutzer die Werte eines vorhandenen Datensatzes aktualisieren. Sie wird in der Bearbeitungsvorlage verwendet (in der Regel benannt EditItemTemplate).
Insert für den Einfügemodus. Auf diese Weise können Benutzer Werte für einen neuen Datensatz eingeben. Sie wird in der Einfügevorlage verwendet (normalerweise benannt InsertItemTemplate).
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
| Name | Beschreibung |
|---|---|
| DynamicControl() |
Initialisiert eine neue Instanz der DynamicControl-Klasse. |
| DynamicControl(DataBoundControlMode) |
Initialisiert eine neue Instanz der DynamicControl Klasse mit dem angegebenen Modus. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| Adapter |
Ruft den browserspezifischen Adapter für das Steuerelement ab. (Geerbt von Control) |
| ApplyFormatInEditMode |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die durch die DataFormatString Eigenschaft angegebene Formatierungszeichenfolge auf Feldwerte angewendet wird, wenn sich das Feld im Bearbeitungsmodus befindet. |
| AppRelativeTemplateSourceDirectory |
Dient zum Abrufen oder Festlegen des anwendungsrelativen virtuellen Verzeichnisses des Page Objekts UserControl , das dieses Steuerelement enthält. (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 |
Dient zum Abrufen oder Festlegen des Algorithmus, der zum Generieren des Werts der ClientID Eigenschaft verwendet wird. (Geerbt von Control) |
| ClientIDSeparator |
Ruft einen Zeichenwert ab, der das Trennzeichen darstellt, das in der ClientID Eigenschaft verwendet wird. (Geerbt von Control) |
| Column |
Dient zum Abrufen oder Festlegen des Spaltenobjekts, das dem Steuerelement zugeordnet ist. |
| Context |
Ruft das Objekt ab, das HttpContext dem Serversteuerelement für die aktuelle Webanforderung zugeordnet ist. (Geerbt von Control) |
| Controls |
Ruft ein ControlCollection Objekt ab, das die untergeordneten Steuerelemente für ein angegebenes Serversteuerelement in der Ui-Hierarchie darstellt. (Geerbt von Control) |
| ConvertEmptyStringToNull |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob leere Zeichenfolgenwerte ("") automatisch in NULL-Werte konvertiert werden, wenn das Datenfeld in der Datenquelle aktualisiert wird. |
| CssClass |
Dient zum Abrufen oder Festlegen der Cascading StyleSheet (CSS)-Klasse, die die Anzeigestile für den DynamicControl Steuerelementinhalt angibt. |
| DataField |
Dient zum Abrufen oder Festlegen des Namens des Datenfelds, an das das DynamicControl Steuerelement gebunden ist. |
| DataFormatString |
Dient zum Abrufen oder Festlegen einer Zeichenfolge, die das Anzeigeformat für den Wert des Felds angibt. |
| DataItemContainer |
Ruft einen Verweis auf den Benennungscontainer ab, wenn der Benennungscontainer IDataItemContainerimplementiert wird. (Geerbt von Control) |
| DataKeysContainer |
Ruft einen Verweis auf den Benennungscontainer ab, wenn der Benennungscontainer IDataKeysControlimplementiert wird. (Geerbt von Control) |
| DesignMode |
Ruft einen Wert ab, der angibt, ob ein Steuerelement auf einer Entwurfsoberfläche verwendet wird. (Geerbt von Control) |
| EnableTheming |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob Designs für dieses Steuerelement gelten. (Geerbt von Control) |
| EnableViewState |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Serversteuerelement den Ansichtszustand und den Ansichtszustand aller enthaltenen untergeordneten Steuerelemente für den anfordernden Client behält. (Geerbt von Control) |
| Events |
Ruft eine Liste von Ereignishandlerdelegatten für das Steuerelement ab. Diese Eigenschaft ist schreibgeschützt. (Geerbt von Control) |
| FieldTemplate |
Ruft die Feldvorlage ab, die für das DynamicControl Steuerelement erstellt wird. |
| HasChildViewState |
Ruft einen Wert ab, der angibt, ob die untergeordneten Steuerelemente des aktuellen Serversteuerelements über gespeicherte Ansichtszustandseinstellungen verfügen. (Geerbt von Control) |
| HtmlEncode |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Daten für das Steuerelement VOR dem Rendern HTML-codiert sind. |
| ID |
Ruft den programmgesteuerten Bezeichner ab, der dem Serversteuerelement zugewiesen ist, oder legt diesen fest. (Geerbt von Control) |
| IdSeparator |
Ruft das Zeichen ab, das zum Trennen von Steuerelementbezeichnern verwendet wird. (Geerbt von Control) |
| IsChildControlStateCleared |
Ruft einen Wert ab, der angibt, ob In diesem Steuerelement enthaltene Steuerelemente den Steuerelementstatus aufweisen. (Geerbt von Control) |
| IsTrackingViewState |
Ruft einen Wert ab, der angibt, ob das Serversteuerelement Änderungen am Ansichtszustand speichert. (Geerbt von Control) |
| IsViewStateEnabled |
Ruft einen Wert ab, der angibt, ob der Ansichtszustand für dieses Steuerelement aktiviert ist. (Geerbt von Control) |
| LoadViewStateByID |
Ruft einen Wert ab, der angibt, ob das Steuerelement am Laden des Ansichtszustands anstelle ID von Index teilnimmt. (Geerbt von Control) |
| Mode |
Ruft den Renderingmodus ab oder legt den Renderingmodus fest. |
| NamingContainer |
Ruft einen Verweis auf den Benennungscontainer des Serversteuerelements ab, der einen eindeutigen Namespace für die Unterscheidung zwischen Serversteuerelementen mit demselben ID Eigenschaftswert erstellt. (Geerbt von Control) |
| NullDisplayText |
Dient zum Abrufen oder Festlegen der Beschriftung, die für ein Datenfeld angezeigt wird, wenn der Feldwert ist |
| Page |
Ruft einen Verweis auf die Page Instanz ab, die das Serversteuerelement enthält. (Geerbt von Control) |
| Parent |
Ruft einen Verweis auf das übergeordnete Steuerelement des Serversteuerelements in der Seitensteuerelementhierarchie ab. (Geerbt von Control) |
| RenderingCompatibility |
Ruft einen Wert ab, der die ASP.NET Version angibt, mit der html gerendert wird, kompatibel ist. (Geerbt von Control) |
| Site |
Ruft Informationen zum Container ab, der das aktuelle Steuerelement hostt, wenn es auf einer Entwurfsoberfläche gerendert wird. (Geerbt von Control) |
| SkinID |
Ruft die Haut ab, die auf das Steuerelement angewendet werden soll, oder legt sie fest. (Geerbt von Control) |
| Table |
Ruft das Tabellenobjekt ab, das dem Steuerelement zugeordnet ist. |
| TemplateControl |
Dient zum Abrufen oder Festlegen eines Verweises auf die Vorlage, die dieses Steuerelement enthält. (Geerbt von Control) |
| TemplateSourceDirectory |
Ruft das virtuelle Verzeichnis des Page oder UserControl das aktuelle Serversteuerelement ab. (Geerbt von Control) |
| UIHint |
Dient zum Abrufen oder Festlegen des Namens der Feldvorlage, die zum Rendern des Datenfelds verwendet wird. |
| UniqueID |
Ruft den eindeutigen hierarchisch qualifizierten Bezeichner für das Serversteuerelement ab. (Geerbt von Control) |
| ValidateRequestMode |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Steuerelement Clienteingaben aus dem Browser auf potenziell gefährliche Werte überprüft. (Geerbt von Control) |
| ValidationGroup |
Ruft den Namen der Überprüfungsgruppe für das Steuerelement ab oder legt den Namen fest. |
| ViewState |
Ruft ein Wörterbuch mit Statusinformationen ab, mit dem Sie den Ansichtszustand eines Serversteuerelements für mehrere Anforderungen für dieselbe Seite speichern und wiederherstellen können. (Geerbt von Control) |
| ViewStateIgnoresCase |
Ruft einen Wert ab, der angibt, ob die Groß-/Kleinschreibung des StateBag Objekts nicht beachtet wird. (Geerbt von Control) |
| ViewStateMode |
Ruft den Ansichtszustandsmodus dieses Steuerelements ab oder legt diesen fest. (Geerbt von Control) |
| Visible |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob ein Serversteuerelement als Benutzeroberfläche auf der Seite gerendert wird. (Geerbt von Control) |
Methoden
| Name | Beschreibung |
|---|---|
| AddedControl(Control, Int32) |
Wird aufgerufen, nachdem der Auflistung des Objekts ein untergeordnetes Control Steuerelement hinzugefügt Controls wurde. (Geerbt von Control) |
| AddParsedSubObject(Object) |
Benachrichtigt das Serversteuerelement, dass ein Element, entweder XML oder HTML, analysiert wurde, und fügt das Element dem Objekt des Serversteuerelements ControlCollection hinzu. (Geerbt von Control) |
| ApplyStyleSheetSkin(Page) |
Wendet die im Seitenstylesheet definierten Formatvorlageneigenschaften auf das Steuerelement an. (Geerbt von Control) |
| BeginRenderTracing(TextWriter, Object) |
Beginnt mit der Entwurfszeitablaufverfolgung von Renderingdaten. (Geerbt von Control) |
| BuildProfileTree(String, Boolean) |
Sammelt Informationen über das Serversteuerelement und liefert sie an die Eigenschaft, die Trace angezeigt werden soll, wenn die Ablaufverfolgung für die Seite aktiviert ist. (Geerbt von Control) |
| ClearCachedClientID() |
Legt den zwischengespeicherten ClientID Wert auf |
| ClearChildControlState() |
Löscht die Steuerelementstatusinformationen für die untergeordneten Steuerelemente des Serversteuerelements. (Geerbt von Control) |
| ClearChildState() |
Löscht die Ansichts- und Steuerelementstatusinformationen für alle untergeordneten Steuerelemente des Serversteuerelements. (Geerbt von Control) |
| ClearChildViewState() |
Löscht die Ansichtsstatusinformationen für alle untergeordneten Steuerelemente des Serversteuerelements. (Geerbt von Control) |
| ClearEffectiveClientIDMode() |
Legt die ClientIDMode Eigenschaft der aktuellen Steuerelementinstanz und aller untergeordneten Steuerelemente auf Inherit. (Geerbt von Control) |
| CreateChildControls() |
Wird vom ASP.NET Seitenframework aufgerufen, um Serversteuerelemente zu benachrichtigen, die kompositionsbasierte Implementierung verwenden, um alle untergeordneten Steuerelemente zu erstellen, die sie in Vorbereitung auf das Veröffentlichen von Zurück- oder Rendering enthalten. (Geerbt von Control) |
| CreateControlCollection() |
Erstellt ein neues ControlCollection Objekt, das die untergeordneten Steuerelemente (literal und server) des Serversteuerelements enthält. (Geerbt von Control) |
| 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 einer Option zum Auslösen des DataBinding Ereignisses. (Geerbt von Control) |
| DataBindChildren() |
Bindet eine Datenquelle an die untergeordneten Steuerelemente des Serversteuerelements. (Geerbt von Control) |
| Dispose() |
Ermöglicht es einem Serversteuerelement, die endgültige Bereinigung durchzuführen, bevor es aus dem Arbeitsspeicher freigegeben wird. (Geerbt von Control) |
| EndRenderTracing(TextWriter, Object) |
Beendet die Entwurfszeitablaufverfolgung von Renderingdaten. (Geerbt von Control) |
| EnsureChildControls() |
Bestimmt, ob das Serversteuerelement untergeordnete Steuerelemente enthält. Wenn dies nicht der Fall ist, werden untergeordnete Steuerelemente erstellt. (Geerbt von Control) |
| EnsureID() |
Erstellt einen Bezeichner für Steuerelemente, denen kein Bezeichner zugewiesen ist. (Geerbt von Control) |
| Equals(Object) |
Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object) |
| FindControl(String, Int32) |
Durchsucht den aktuellen Benennungscontainer für ein Serversteuerelement mit der angegebenen |
| FindControl(String) |
Durchsucht den aktuellen Benennungscontainer für ein Serversteuerelement mit dem angegebenen |
| Focus() |
Legt den Eingabefokus auf ein Steuerelement fest. (Geerbt von Control) |
| GetAttribute(String) |
Ruft den Attributwert mithilfe des angegebenen Schlüssels ab. |
| GetDesignModeState() |
Ruft Entwurfszeitdaten für ein Steuerelement ab. (Geerbt von Control) |
| GetHashCode() |
Dient als Standardhashfunktion. (Geerbt von Object) |
| GetRouteUrl(Object) |
Ruft die URL ab, die einem Satz von Routenparametern entspricht. (Geerbt von Control) |
| GetRouteUrl(RouteValueDictionary) |
Ruft die URL ab, die einem Satz von Routenparametern entspricht. (Geerbt von Control) |
| GetRouteUrl(String, Object) |
Ruft die URL ab, die einem Satz von Routenparametern und einem Routennamen entspricht. (Geerbt von Control) |
| GetRouteUrl(String, RouteValueDictionary) |
Ruft die URL ab, die einem Satz von Routenparametern und einem Routennamen entspricht. (Geerbt von Control) |
| GetType() |
Ruft die Type der aktuellen Instanz ab. (Geerbt von Object) |
| GetUniqueIDRelativeTo(Control) |
Gibt den präfixierten Teil der UniqueID Eigenschaft des angegebenen Steuerelements zurück. (Geerbt von Control) |
| HasControls() |
Bestimmt, ob das Serversteuerelement untergeordnete Steuerelemente enthält. (Geerbt von Control) |
| HasEvents() |
Gibt einen Wert zurück, der angibt, ob Ereignisse für das Steuerelement oder untergeordnete Steuerelemente registriert sind. (Geerbt von Control) |
| IsLiteralContent() |
Bestimmt, ob das Serversteuerelement nur Literalinhalte enthält. (Geerbt von Control) |
| LoadControlState(Object) |
Stellt Steuerstatusinformationen aus einer vorherigen Seitenanforderung wieder her, die von der SaveControlState() Methode gespeichert wurde. (Geerbt von Control) |
| LoadViewState(Object) |
Stellt Ansichtsstatusinformationen aus einer vorherigen Seitenanforderung wieder her, die von der SaveViewState() Methode gespeichert wurde. (Geerbt von Control) |
| MapPathSecure(String) |
Ruft den physischen Pfad ab, dem ein virtueller Pfad, entweder absolut oder relativ, zugeordnet ist. (Geerbt von Control) |
| MemberwiseClone() |
Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object) |
| OnBubbleEvent(Object, EventArgs) |
Bestimmt, ob das Ereignis für das Serversteuerelement an die Ui-Serversteuerelementhierarchie der Seite übergeben wird. (Geerbt von Control) |
| OnDataBinding(EventArgs) |
Löst das DataBinding-Ereignis aus. (Geerbt von Control) |
| OnInit(EventArgs) |
Löst das Init-Ereignis aus. |
| 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 Verwendeten zum Lesen einer Datei ab. (Geerbt von Control) |
| RaiseBubbleEvent(Object, EventArgs) |
Weist alle Quellen des Ereignisses und dessen Informationen dem übergeordneten Element des Steuerelements zu. (Geerbt von Control) |
| RemovedControl(Control) |
Wird aufgerufen, nachdem ein untergeordnetes Steuerelement aus der Controls Auflistung des Control Objekts entfernt wurde. (Geerbt von Control) |
| Render(HtmlTextWriter) |
Rendert den DynamicControl Steuerelementinhalt mithilfe des angegebenen HtmlTextWriter Objekts im Browser des Clients. |
| RenderChildren(HtmlTextWriter) |
Gibt den Inhalt der untergeordneten Elemente eines Serversteuerelements in ein bereitgestelltes HtmlTextWriter Objekt aus, das den inhalt schreibt, der auf dem Client gerendert werden soll. (Geerbt von Control) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Gibt den Inhalt des Serversteuerelements mithilfe eines bereitgestellten Objekts an ein bereitgestelltes HtmlTextWriterControlAdapter Objekt aus. (Geerbt von Control) |
| RenderControl(HtmlTextWriter) |
Gibt Den Inhalt des Serversteuerelements an ein bereitgestelltes HtmlTextWriter Objekt aus und speichert Ablaufverfolgungsinformationen zum Steuerelement, wenn die Ablaufverfolgung aktiviert ist. (Geerbt von Control) |
| ResolveAdapter() |
Ruft den Steuerelementadapter ab, der für das Rendern des angegebenen Steuerelements verantwortlich ist. (Geerbt von Control) |
| ResolveClientUrl(String) |
Ruft eine URL ab, die vom Browser verwendet werden kann. (Geerbt von Control) |
| ResolveUrl(String) |
Wandelt eine URL in eine URL um, die auf dem anfordernden Client verwendet werden kann. (Geerbt von Control) |
| SaveControlState() |
Speichert alle Änderungen des Serversteuerelementstatus, die seit dem Zeitpunkt der Zurückpostung der Seite auf dem Server aufgetreten sind. (Geerbt von Control) |
| SaveViewState() |
Speichert alle Änderungen des Ansichtszustands des Serversteuerelements, die seit dem Zeitpunkt, zu dem die Seite zurück auf den Server gepostet wurde, aufgetreten sind. (Geerbt von Control) |
| SetAttribute(String, String) |
Legt das angegebene Attribut auf den angegebenen Wert fest. |
| SetDesignModeState(IDictionary) |
Legt Entwurfszeitdaten für ein Steuerelement fest. (Geerbt von Control) |
| SetRenderMethodDelegate(RenderMethod) |
Weist einen Ereignishandlerdelegat zu, um das Serversteuerelement und dessen Inhalt in seinem übergeordneten Steuerelement zu rendern. (Geerbt von Control) |
| SetTraceData(Object, Object, Object) |
Legt Ablaufverfolgungsdaten für die Entwurfszeitablaufverfolgung von Renderingdaten mithilfe des ablaufverfolgungsobjekts, des Ablaufverfolgungsdatenschlüssels und des Ablaufverfolgungsdatenwerts fest. (Geerbt von Control) |
| SetTraceData(Object, Object) |
Legt Ablaufverfolgungsdaten für die Entwurfszeitablaufverfolgung von Renderingdaten mithilfe des Ablaufverfolgungsdatenschlüssels und des Ablaufverfolgungsdatenwerts fest. (Geerbt von Control) |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |
| TrackViewState() |
Bewirkt die Nachverfolgung von Ansichtszustandsänderungen am Serversteuerelement, sodass sie im Objekt des Serversteuerelements StateBag gespeichert werden können. Auf dieses Objekt kann über die ViewState Eigenschaft zugegriffen werden. (Geerbt von Control) |
Ereignisse
| Name | Beschreibung |
|---|---|
| DataBinding |
Tritt auf, wenn das Serversteuerelement eine Bindung an eine Datenquelle ausführt. (Geerbt von Control) |
| Disposed |
Tritt auf, wenn ein Serversteuerelement aus dem Arbeitsspeicher freigegeben wird. Dies ist die letzte Phase des Lebenszyklus des Serversteuerelements, wenn eine ASP.NET Seite angefordert wird. (Geerbt von Control) |
| Init |
Tritt auf, wenn das Serversteuerelement initialisiert wird, was der erste Schritt im Lebenszyklus ist. (Geerbt von Control) |
| Load |
Tritt auf, wenn das Serversteuerelement in das Page Objekt geladen wird. (Geerbt von Control) |
| PreRender |
Tritt ein, nachdem das Control Objekt geladen wurde, aber vor dem Rendern. (Geerbt von Control) |
| Unload |
Tritt auf, wenn das Serversteuerelement aus dem Arbeitsspeicher entladen wird. (Geerbt von Control) |
Explizite Schnittstellenimplementierungen
| Name | Beschreibung |
|---|---|
| IControlBuilderAccessor.ControlBuilder |
Eine Beschreibung dieses Mitglieds finden Sie unter ControlBuilder. (Geerbt von Control) |
| IControlDesignerAccessor.GetDesignModeState() |
Eine Beschreibung dieses Mitglieds finden Sie unter GetDesignModeState(). (Geerbt von Control) |
| IControlDesignerAccessor.SetDesignModeState(IDictionary) |
Eine Beschreibung dieses Mitglieds finden Sie unter SetDesignModeState(IDictionary). (Geerbt von Control) |
| IControlDesignerAccessor.SetOwnerControl(Control) |
Eine Beschreibung dieses Mitglieds finden Sie unter SetOwnerControl(Control). (Geerbt von Control) |
| IControlDesignerAccessor.UserData |
Eine Beschreibung dieses Mitglieds finden Sie unter UserData. (Geerbt von Control) |
| IDataBindingsAccessor.DataBindings |
Eine Beschreibung dieses Mitglieds finden Sie unter DataBindings. (Geerbt von Control) |
| IDataBindingsAccessor.HasDataBindings |
Eine Beschreibung dieses Mitglieds finden Sie unter HasDataBindings. (Geerbt von Control) |
| IExpressionsAccessor.Expressions |
Eine Beschreibung dieses Mitglieds finden Sie unter Expressions. (Geerbt von Control) |
| IExpressionsAccessor.HasExpressions |
Eine Beschreibung dieses Mitglieds finden Sie unter HasExpressions. (Geerbt von Control) |
| IFieldTemplateHost.FormattingOptions |
Eine Beschreibung dieses Mitglieds finden Sie unter FormattingOptions. |
| IParserAccessor.AddParsedSubObject(Object) |
Eine Beschreibung dieses Mitglieds finden Sie unter AddParsedSubObject(Object). (Geerbt von Control) |
Erweiterungsmethoden
| Name | Beschreibung |
|---|---|
| ConvertEditedValue(IFieldFormattingOptions, String) |
Gibt den von einem Benutzer bereitgestellten Wert für ein Steuerelement zurück, 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 metatable -Objekt für das enthaltende Datensteuerelement zurück. |
| FormatEditValue(IFieldFormattingOptions, Object) |
Formatiert den angegebenen Feldwert mithilfe der angegebenen Formatierungsoptionen. |
| FormatValue(IFieldFormattingOptions, Object) |
Formatiert den angegebenen Feldwert mithilfe der angegebenen Formatierungsoptionen. |
