DataSourceDesigner Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt Entwurfszeitunterstützung in einem Entwurfshost für die DataSourceControl-Klasse bereit.
public ref class DataSourceDesigner : System::Web::UI::Design::ControlDesigner, System::Web::UI::Design::IDataSourceDesignerpublic class DataSourceDesigner : System.Web.UI.Design.ControlDesigner, System.Web.UI.Design.IDataSourceDesignertype DataSourceDesigner = class
inherit ControlDesigner
interface IDataSourceDesignerPublic Class DataSourceDesigner
Inherits ControlDesigner
Implements IDataSourceDesigner- Vererbung
- Abgeleitet
- Implementiert
Beispiele
Das folgende Codebeispiel zeigt, wie Sie ein benutzerdefiniertes Datenquellensteuerelement mit mehreren anderen kleinen benutzerdefinierten Klassen verwenden, wie in der folgenden Tabelle aufgeführt.
| Benutzerdefinierte Klasse | Abgeleitet von |
|---|---|
CustomDataSource |
ObjectDataSource |
CustomDataSourceDesigner |
DataSourceDesigner |
CustomDataSourceView |
ObjectDataSourceView |
CustomDesignDataSourceView |
DesignerDataSourceView |
BookListViewSchema |
IDataSourceViewSchema |
CustomIDFieldSchema |
IDataSourceFieldSchema |
CustomTitleFieldSchema |
IDataSourceFieldSchema |
BookItem (Eine Datenstruktur mit zwei Feldern.) |
Öffnen Sie nach dem Kompilieren des Codebeispiels die seite .aspx in der Entwurfsansicht, und legen Sie die DataSourceID Eigenschaft dann auf die ID des benutzerdefinierten Datenquellensteuerelements fest.
using System;
using System.Data;
using System.Security.Permissions;
using System.Collections;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.Design;
using System.Web.UI.Design.WebControls;
using System.ComponentModel;
using System.ComponentModel.Design;
namespace ASPNet.Design.Samples_CS
{
[Designer(typeof(CustomDataSourceDesigner)),
ToolboxData("<{0}:CustomDataSource runat=\"server\"></{0}:CustomDataSource>")]
public class CustomDataSource : ObjectDataSource
{
private ObjectDataSourceView _view = null;
private string _defaultViewName = "BookList";
public CustomDataSource() : base() { }
// Gets a view by name
protected override DataSourceView GetView(string viewName)
{
// This data source only allows one view
if (viewName != _defaultViewName)
{
return null;
}
else if (_view == null)
{
_view = new CustomDataSourceView(this,
_defaultViewName, HttpContext.Current);
}
return _view;
}
// Gets a list of view names for this class
protected override ICollection GetViewNames()
{
ArrayList ar = new ArrayList(1);
ar.Add(_defaultViewName);
return ar as ICollection;
}
}
// The runtime data source view
public class CustomDataSourceView : ObjectDataSourceView
{
private ArrayList _data = null;
public CustomDataSourceView(CustomDataSource owner,
string viewName, HttpContext context)
: base(owner, viewName, context)
{
owner.SelectCountMethod = "GetCount";
}
// This method would typically get a set of live data
// rather than create some dummy data
protected override IEnumerable ExecuteSelect(
DataSourceSelectArguments arguments)
{
if (_data == null)
{
// Create a set of runtime fake data
_data = new ArrayList();
_data.Add(new BookItem("ID_1", "Runtime Title 01"));
_data.Add(new BookItem("ID_2", "Runtime Title 02"));
_data.Add(new BookItem("ID_3", "Runtime Title 03"));
}
return _data as IEnumerable;
}
// Allow getting the record count
public override bool CanRetrieveTotalRowCount
{
get { return true; }
}
// Returns the number of records in the current set of data
public int GetCount()
{
if (_data == null)
return 0;
else
return _data.Count;
}
// Do not allow deletions
public override bool CanDelete
{
get { return false; }
}
// Do not allow insertions
public override bool CanInsert
{
get { return false; }
}
// Do not allow paging
public override bool CanPage
{
get { return false; }
}
// Do not allow sorting
public override bool CanSort
{
get { return false; }
}
// Do not allow updating
public override bool CanUpdate
{
get { return false; }
}
}
// A class to define each record of the data
public class BookItem
{
private string _id;
private string _title;
public BookItem(string id, string title)
{
_id = id;
_title = title;
}
public string ID
{
get { return _id; }
}
public string Title
{
get { return _title; }
set { _title = value; }
}
}
// Custom designer for the CustomDataSource control.
public class CustomDataSourceDesigner : DataSourceDesigner
{
private CustomDataSource _control;
private string _defaultViewName = "BookList";
private CustomDesignDataSourceView _view = null;
// Initialize the designer
public override void Initialize(IComponent component)
{
base.Initialize(component);
_control = (CustomDataSource)Component;
}
// Get a view
public override DesignerDataSourceView GetView(string viewName)
{
if (!viewName.Equals(_defaultViewName))
return null;
_view ??= new CustomDesignDataSourceView(this,
_defaultViewName);
return _view;
}
// Get a list of view names
public override string[] GetViewNames()
{
return new string[] { "BookList" };
}
// Do not allow refreshing the schema
public override bool CanRefreshSchema
{
get { return false; }
}
// Do not allow resizing
public override bool AllowResize
{
get { return false; }
}
}
// A design-time data source view
public class CustomDesignDataSourceView : DesignerDataSourceView
{
private ArrayList _data = null;
public CustomDesignDataSourceView(
CustomDataSourceDesigner owner, string viewName)
: base(owner, viewName)
{}
// Get data for design-time display
public override IEnumerable GetDesignTimeData(
int minimumRows, out bool isSampleData)
{
if (_data == null)
{
// Create a set of design-time fake data
_data = new ArrayList();
for (int i = 1; i <= minimumRows; i++)
{
_data.Add(new BookItem("ID_" + i.ToString(),
"Design-Time Title 0" + i.ToString()));
}
}
isSampleData = true;
return _data as IEnumerable;
}
public override IDataSourceViewSchema Schema
{
get { return new BookListViewSchema(); }
}
// Allow getting the record count
public override bool CanRetrieveTotalRowCount
{
get { return true; }
}
// Do not allow deletions
public override bool CanDelete
{
get { return false; }
}
// Do not allow insertions
public override bool CanInsert
{
get { return false; }
}
// Do not allow updates
public override bool CanUpdate
{
get { return false; }
}
// Do not allow paging
public override bool CanPage
{
get { return false; }
}
// Do not allow sorting
public override bool CanSort
{
get { return false; }
}
}
// A custom View Schema class
public class BookListViewSchema : IDataSourceViewSchema
{
public BookListViewSchema()
{ }
// The name of this View Schema
public string Name
{
get { return "BookList"; }
}
// Build a Field Schema array
public IDataSourceFieldSchema[] GetFields()
{
IDataSourceFieldSchema[] fields = new IDataSourceFieldSchema[2];
fields[0] = new CustomIDFieldSchema();
fields[1] = new CustomTitleFieldSchema();
return fields;
}
// There are no child views, so return null
public IDataSourceViewSchema[] GetChildren()
{
return null;
}
}
// A custom Field Schema class for ID
public class CustomIDFieldSchema : IDataSourceFieldSchema
{
public CustomIDFieldSchema()
{ }
// Name is ID
public string Name
{
get { return "ID"; }
}
// Data type is string
public Type DataType
{
get { return typeof(string); }
}
// This is not an Identity field
public bool Identity
{
get { return false; }
}
// This field is read only
public bool IsReadOnly
{
get { return true; }
}
// This field is unique
public bool IsUnique
{
get { return true; }
}
// This field can't be longer than 20
public int Length
{
get { return 20; }
}
// This field can't be null
public bool Nullable
{
get { return false; }
}
// This is a Primary Key
public bool PrimaryKey
{
get { return true; }
}
// These properties do not apply
public int Precision
{
get { return -1; }
}
public int Scale
{
get { return -1; }
}
}
// A custom Field Schema class for Title
public class CustomTitleFieldSchema : IDataSourceFieldSchema
{
public CustomTitleFieldSchema()
{ }
// Name is Title
public string Name
{
get { return "Title"; }
}
// Type is string
public Type DataType
{
get { return typeof(string); }
}
// This is not an Identity field
public bool Identity
{
get { return false; }
}
// This field is not read only
public bool IsReadOnly
{
get { return false; }
}
// This field is not unique
public bool IsUnique
{
get { return false; }
}
// This field can't be longer than 100
public int Length
{
get { return 100; }
}
// This field can't be null
public bool Nullable
{
get { return false; }
}
// This is not the Primary Key
public bool PrimaryKey
{
get { return false; }
}
// These properties do not apply
public int Precision
{
get { return -1; }
}
public int Scale
{
get { return -1; }
}
}
}
Imports System.Data
Imports System.Security.Permissions
Imports System.Collections
Imports System.Web
Imports System.Web.UI
Imports System.Web.UI.WebControls
Imports System.Web.UI.Design
Imports System.Web.UI.Design.WebControls
Imports System.ComponentModel
Imports System.ComponentModel.Design
Namespace ASPNet.Design.Samples_VB
<Designer(GetType(CustomDataSourceDesigner)), _
ToolboxData("<{0}:CustomDataSource runat=""server""></{0}:CustomDataSource>")> _
Public Class CustomDataSource
Inherits ObjectDataSource
Dim _defaultViewName As String = "BookList"
Dim _view As ObjectDataSourceView = Nothing
Public Sub New()
MyBase.New()
End Sub
' Gets a view by name
Protected Overrides Function GetView(ByVal viewName As String) As DataSourceView
' This data source only allows one view
If Not (viewName.Equals(_defaultViewName)) Then
Return Nothing
ElseIf IsNothing(_view) Then
_view = New CustomDataSourceView(Me, _
_defaultViewName, HttpContext.Current)
End If
Return _view
End Function
' Gets a list of view names for this class
Protected Overrides Function GetViewNames() As ICollection
Dim ar As New ArrayList()
ar.Add(_defaultViewName)
Return CType(ar, ICollection)
End Function
End Class
' The runtime data source view
Public Class CustomDataSourceView
Inherits ObjectDataSourceView
Dim _data As ArrayList = Nothing
Public Sub New(ByVal owner As CustomDataSource, ByVal viewName As String, ByVal context As HttpContext)
MyBase.New(owner, viewName, context)
owner.SelectCountMethod = "GetCount"
End Sub
' This method would typically get a set of live data
' rather than create some dummy data
Protected Overrides Function ExecuteSelect(ByVal arguments As DataSourceSelectArguments) As System.Collections.IEnumerable
If (IsNothing(_data)) Then
_data = New ArrayList()
_data.Add(New BookItem("ID_1", "Runtime Title 01"))
_data.Add(New BookItem("ID_2", "Runtime Title 02"))
_data.Add(New BookItem("ID_3", "Runtime Title 03"))
End If
Return CType(_data, IEnumerable)
End Function
' Allow getting the record count
Public Overrides ReadOnly Property CanRetrieveTotalRowCount() As Boolean
Get
Return True
End Get
End Property
' Returns the number of records in the current set of data
Public ReadOnly Property GetCount() As Integer
Get
If IsNothing(_data) Then
Return 0
Else
Return _data.Count
End If
End Get
End Property
' Do not allow deletions
Public Overrides ReadOnly Property CanDelete() As Boolean
Get
Return False
End Get
End Property
' Do not allow insertions
Public Overrides ReadOnly Property CanInsert() As Boolean
Get
Return False
End Get
End Property
' Do not allow paging
Public Overrides ReadOnly Property CanPage() As Boolean
Get
Return False
End Get
End Property
' Do not allow sorting
Public Overrides ReadOnly Property CanSort() As Boolean
Get
Return False
End Get
End Property
' Do not allow updating
Public Overrides ReadOnly Property CanUpdate() As Boolean
Get
Return False
End Get
End Property
End Class
' A class to define a record of the data
Public Class BookItem
Private _id As String
Private _title As String
Public Sub New(ByVal id As String, ByVal title As String)
_id = id
_title = title
End Sub
Public ReadOnly Property ID() As String
Get
Return _id
End Get
End Property
Public Property Title() As String
Get
Return _title
End Get
Set(ByVal value As String)
_title = value
End Set
End Property
End Class
' Custom designer for the CustomDataSource control.
Public Class CustomDataSourceDesigner
Inherits DataSourceDesigner
Private _control As CustomDataSource = Nothing
Private _defaultViewName As String = "BookList"
Private _view As CustomDesignDataSourceView = Nothing
Public Overrides Sub Initialize(ByVal cmponent As IComponent)
MyBase.Initialize(cmponent)
_control = CType(cmponent, CustomDataSource)
End Sub
' Get a view
Public Overrides Function GetView(ByVal viewName As String) As DesignerDataSourceView
If Not (viewName.Equals(_defaultViewName)) Then
Return Nothing
ElseIf IsNothing(_view) Then
_view = New CustomDesignDataSourceView(Me, _
_defaultViewName)
End If
Return _view
End Function
' Get a list of view names
Public Overrides Function GetViewNames() As String()
Return New String() {"BookList"}
End Function
' Don't allow refreshing the schema
Public Overrides ReadOnly Property CanRefreshSchema() As Boolean
Get
Return False
End Get
End Property
' Do not allow resizing
Public Overrides ReadOnly Property AllowResize() As Boolean
Get
Return False
End Get
End Property
End Class
' A design-time data source view
Public Class CustomDesignDataSourceView
Inherits DesignerDataSourceView
Private _data As ArrayList = Nothing
Public Sub New(ByVal owner As CustomDataSourceDesigner, ByVal viewName As String)
MyBase.New(owner, viewName)
End Sub
' Get data for design-time display
Public Overrides Function GetDesignTimeData( _
ByVal minimumRows As Integer, _
ByRef isSampleData As Boolean) As IEnumerable
If IsNothing(_data) Then
' Create a set of design-time fake data
_data = New ArrayList()
Dim i As Integer
For i = 1 To minimumRows
_data.Add(New BookItem("ID_" & i.ToString(), _
"Design-Time Title 0" & i.ToString()))
Next
End If
isSampleData = True
Return CType(_data, IEnumerable)
End Function
Public Overrides ReadOnly Property Schema() As IDataSourceViewSchema
Get
Return New BookListViewSchema()
End Get
End Property
' Allow getting the record count
Public Overrides ReadOnly Property CanRetrieveTotalRowCount() As Boolean
Get
Return True
End Get
End Property
' Do not allow deletions
Public Overrides ReadOnly Property CanDelete() As Boolean
Get
Return False
End Get
End Property
' Do not allow insertions
Public Overrides ReadOnly Property CanInsert() As Boolean
Get
Return False
End Get
End Property
' Do not allow updates
Public Overrides ReadOnly Property CanUpdate() As Boolean
Get
Return False
End Get
End Property
' Do not allow paging
Public Overrides ReadOnly Property CanPage() As Boolean
Get
Return False
End Get
End Property
' Do not allow sorting
Public Overrides ReadOnly Property CanSort() As Boolean
Get
Return False
End Get
End Property
End Class
' A custom View Schema class
Public Class BookListViewSchema
Implements IDataSourceViewSchema
Public Sub New()
End Sub
' The name of this View Schema
Public ReadOnly Property Name() As String Implements IDataSourceViewSchema.Name
Get
Return "BookList"
End Get
End Property
' Build a Field Schema array
Public Function GetFields() As IDataSourceFieldSchema() Implements IDataSourceViewSchema.GetFields
Dim fields(1) As IDataSourceFieldSchema
fields(0) = New CustomIDFieldSchema()
fields(1) = New CustomTitleFieldSchema()
Return fields
End Function
' There are no child views, so return Nothing
Public Function GetChildren() As IDataSourceViewSchema() Implements IDataSourceViewSchema.GetChildren
Return Nothing
End Function
End Class
' A custom Field Schema class for ID
Public Class CustomIDFieldSchema
Implements IDataSourceFieldSchema
Public Sub New()
End Sub
' Name is ID
Public ReadOnly Property Name() As String Implements IDataSourceFieldSchema.Name
Get
Return "ID"
End Get
End Property
' Data type is string
Public ReadOnly Property DataType() As Type Implements IDataSourceFieldSchema.DataType
Get
Return GetType(String)
End Get
End Property
' This is not an Identity field
Public ReadOnly Property Identity() As Boolean Implements IDataSourceFieldSchema.Identity
Get
Return False
End Get
End Property
' This field is read only
Public ReadOnly Property IsReadOnly() As Boolean Implements IDataSourceFieldSchema.IsReadOnly
Get
Return True
End Get
End Property
' This field is unique
Public ReadOnly Property IsUnique() As Boolean Implements IDataSourceFieldSchema.IsUnique
Get
Return True
End Get
End Property
' This field can't be longer than 20
Public ReadOnly Property Length() As Integer Implements IDataSourceFieldSchema.Length
Get
Return 20
End Get
End Property
' This field can't be null
Public ReadOnly Property Nullable() As Boolean Implements IDataSourceFieldSchema.Nullable
Get
Return False
End Get
End Property
' This is a Primary Key
Public ReadOnly Property PrimaryKey() As Boolean Implements IDataSourceFieldSchema.PrimaryKey
Get
Return True
End Get
End Property
' These properties do not apply
Public ReadOnly Property Precision() As Integer Implements IDataSourceFieldSchema.Precision
Get
Return -1
End Get
End Property
Public ReadOnly Property Scale() As Integer Implements IDataSourceFieldSchema.Scale
Get
Return -1
End Get
End Property
End Class
' A custom Field Schema class for Title
Public Class CustomTitleFieldSchema
Implements IDataSourceFieldSchema
Public Sub New()
End Sub
' Name is Title
Public ReadOnly Property Name() As String Implements IDataSourceFieldSchema.Name
Get
Return "Title"
End Get
End Property
' Type is string
Public ReadOnly Property DataType() As Type Implements IDataSourceFieldSchema.DataType
Get
Return GetType(String)
End Get
End Property
' This is not an Identity field
Public ReadOnly Property Identity() As Boolean Implements IDataSourceFieldSchema.Identity
Get
Return False
End Get
End Property
' This field is not read only
Public ReadOnly Property IsReadOnly() As Boolean Implements IDataSourceFieldSchema.IsReadOnly
Get
Return False
End Get
End Property
' This field is not unique
Public ReadOnly Property IsUnique() As Boolean Implements IDataSourceFieldSchema.IsUnique
Get
Return False
End Get
End Property
' This field can't be longer than 100
Public ReadOnly Property Length() As Integer Implements IDataSourceFieldSchema.Length
Get
Return 100
End Get
End Property
' This field can't be null
Public ReadOnly Property Nullable() As Boolean Implements IDataSourceFieldSchema.Nullable
Get
Return False
End Get
End Property
' This is not the Primary Key
Public ReadOnly Property PrimaryKey() As Boolean Implements IDataSourceFieldSchema.PrimaryKey
Get
Return False
End Get
End Property
' These properties do not apply
Public ReadOnly Property Precision() As Integer Implements IDataSourceFieldSchema.Precision
Get
Return -1
End Get
End Property
Public ReadOnly Property Scale() As Integer Implements IDataSourceFieldSchema.Scale
Get
Return -1
End Get
End Property
End Class
End Namespace
<%@ Page Language="C#" %>
<%@ Register TagPrefix="aspSample" Namespace="ASPNet.Design.Samples_CS" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>Untitled Page</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<aspSample:CustomDataSource ID="CustomDS1"
runat="server"></aspSample:CustomDataSource>
<asp:GridView ID="GridView1" runat="server"></asp:GridView>
</div>
</form>
</body>
</html>
<%@ Page Language="VB" %>
<%@ Register TagPrefix="aspSample"
Namespace="ASPNet.Design.Samples_VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>Untitled Page</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<aspSample:CustomDataSource runat="server"
ID="CustomDS1"></aspSample:CustomDataSource>
<asp:GridView ID="GridView1" runat="server"></asp:GridView>
</div>
</form>
</body>
</html>
Hinweise
Die DataSourceDesigner -Klasse ist die Basisklasse für Datenquellen-Designer, z. B. die SqlDataSourceDesignerKlassen , AccessDataSourceDesignerund ObjectDataSourceDesigner . Wenn Sie ein neues Datenquellensteuerelement erstellen, können Sie auch einen benutzerdefinierten Steuerelement-Designer für Ihr Steuerelement erstellen und von der DataSourceDesigner -Klasse ableiten.
Die DataSourceDesigner -Klasse verfügt über zwei Ereignismethoden: die -Methode und OnSchemaRefreshed die OnDataSourceChanged -Methode. Beide Ereignisse können mit der SuppressDataSourceEvents -Methode vorübergehend deaktiviert werden, wodurch die SuppressingDataSourceEvents -Eigenschaft festgelegt wird. Die Ereignismethoden können mit der ResumeDataSourceEvents -Methode erneut aktiviert werden.
Es gibt zwei statische Methoden, mit denen Sie die Äquivalenz von Schemas oder Sichten bewerten können, ohne eine Instanz der -Klasse zu erstellen:
Die SchemasEquivalent Methode vergleicht zwei Schemas.
Die ViewSchemasEquivalent Methode vergleicht die Schemas von zwei Ansichten.
Hinweise für Vererber
Um Befehle für das Aktionslistenmenü zur Entwurfszeit in einer abgeleiteten Klasse bereitzustellen, müssen Sie die ActionLists -Eigenschaft überschreiben, um ein benutzerdefiniertes DesignerActionListCollection Objekt mit benutzerdefinierten Elementen zurückzugeben, die DesignerActionList vom Objekt abgeleitet werden.
Konstruktoren
| DataSourceDesigner() |
Initialisiert eine neue Instanz der DataSourceDesigner-Klasse. |
Eigenschaften
| ActionLists |
Ruft eine Liste von Elementen ab, mit denen zur Entwurfszeit ein Aktionslistenmenü erstellt wird. |
| AllowResize |
Ruft einen Wert ab, der angibt, ob die Größe des Steuerelements in der Entwurfszeitumgebung geändert werden kann. (Geerbt von ControlDesigner) |
| AssociatedComponents |
Ruft die Auflistung der Komponenten ab, die der durch den Designer verwalteten Komponente zugeordnet ist. (Geerbt von ComponentDesigner) |
| AutoFormats |
Ruft die Auflistung der vordefinierten automatischen Formatierungsschemas ab, die zur Entwurfszeit für das zugeordnete Steuerelement im Dialogfeld Automat. Formatierung angezeigt werden sollen. (Geerbt von ControlDesigner) |
| Behavior |
Veraltet.
Ruft das DHTML-Verhalten ab, das dem Designer zugeordnet, oder legt dieses fest. (Geerbt von HtmlControlDesigner) |
| CanConfigure |
Ruft einen Wert ab, der angibt, ob die Configure()-Methode aufgerufen werden kann. |
| CanRefreshSchema |
Ruft einen Wert ab, der angibt, ob die RefreshSchema(Boolean)-Methode aufgerufen werden kann. |
| Component |
Ruft die Komponente ab, die von diesem Designer entworfen wird. (Geerbt von ComponentDesigner) |
| DataBindings |
Ruft die Datenbindungsauflistung für das aktuelle Steuerelement ab. (Geerbt von HtmlControlDesigner) |
| DataBindingsEnabled |
Ruft einen Wert ab, der angibt, ob Datenbindung vom enthaltenden Bereich für das zugeordnete Steuerelement unterstützt wird. (Geerbt von ControlDesigner) |
| DesignerState |
Ruft ein Objekt ab, mit dem Daten für das zugeordnete Steuerelement zur Entwurfszeit beibehalten werden. (Geerbt von ControlDesigner) |
| DesignTimeElement |
Veraltet.
Ruft das Entwurfszeitobjekt ab, das auf der Entwurfsoberfläche das dem HtmlControlDesigner-Objekt zugeordnete Steuerelement darstellt. (Geerbt von HtmlControlDesigner) |
| DesignTimeElementView |
Veraltet.
Ruft das Ansichtssteuerelement-Objekt für den Steuerelementdesigner ab. (Geerbt von ControlDesigner) |
| DesignTimeHtmlRequiresLoadComplete |
Veraltet.
Ruft einen Wert ab, der angibt, ob der Entwurfshost vor dem Aufruf der GetDesignTimeHtml-Methode vollständig geladen sein muss. (Geerbt von ControlDesigner) |
| Expressions |
Ruft die Ausdrucksbindungen für das aktuelle Steuerelement zur Entwurfszeit ab. (Geerbt von HtmlControlDesigner) |
| HidePropertiesInTemplateMode |
Ruft einen Wert ab, der angibt, ob die Eigenschaften des zugeordneten Steuerelements ausgeblendet werden, wenn sich das Steuerelement im Vorlagenmodus befindet. (Geerbt von ControlDesigner) |
| ID |
Ruft die ID-Zeichenfolge des Steuerelements ab oder legt diese fest. (Geerbt von ControlDesigner) |
| InheritanceAttribute |
Ruft ein Attribut ab, das den Vererbungstyp der zugeordneten Komponente angibt. (Geerbt von ComponentDesigner) |
| Inherited |
Ruft einen Wert ab, der angibt, ob diese Komponente geerbt wurde. (Geerbt von ComponentDesigner) |
| InTemplateMode |
Ruft einen Wert ab, der angibt, ob sich das Steuerelement im Entwurfshost im Anzeigemodus bzw. im Vorlagenbearbeitungsmodus befindet. Die InTemplateMode-Eigenschaft ist schreibgeschützt. (Geerbt von ControlDesigner) |
| IsDirty |
Veraltet.
Ruft einen Wert ab, der angibt, ob das Webserversteuerelement als geändert markiert ist, oder legt diesen fest. (Geerbt von ControlDesigner) |
| ParentComponent |
Ruft die übergeordnete Komponente für diesen Designer ab. (Geerbt von ComponentDesigner) |
| ReadOnly |
Veraltet.
Ruft einen Wert ab, der angibt, ob die Eigenschaften des Steuerelements zur Entwurfszeit schreibgeschützt sind, oder legt diesen fest. (Geerbt von ControlDesigner) |
| RootDesigner |
Ruft den Steuerelement-Designer für die Web Forms-Seite ab, die das zugeordnete Steuerelement enthält. (Geerbt von ControlDesigner) |
| SetTextualDefaultProperty |
Stellt Entwurfszeitunterstützung in einem Entwurfshost für die DataSourceControl-Klasse bereit. (Geerbt von ComponentDesigner) |
| ShadowProperties |
Ruft eine Auflistung von Eigenschaftswerten ab, die Benutzereinstellungen überschreiben. (Geerbt von ComponentDesigner) |
| ShouldCodeSerialize |
Veraltet.
Ruft einen Wert ab, der angibt, ob für das Steuerelement in der CodeBehind-Datei für das aktuelle Entwurfsdokument während der Serialisierung eine Felddeklaration erstellt werden soll. (Geerbt von HtmlControlDesigner) |
| SuppressingDataSourceEvents |
Ruft einen Wert ab, der angibt, ob das DataSourceChanged-Ereignis oder die RefreshSchema(Boolean)-Methode auftritt. |
| Tag |
Ruft ein Objekt ab, das das HTML-Markupelement für das zugeordnete Steuerelement darstellt. (Geerbt von ControlDesigner) |
| TemplateGroups |
Ruft eine Auflistung vom Vorlagengruppen ab, die jeweils eine oder mehrere Definitionen enthalten. (Geerbt von ControlDesigner) |
| UsePreviewControl |
Ruft einen Wert ab, der angibt, ob der Steuerelement-Designer ein temporäres Vorschausteuerelement verwendet, um das HTML-Markup zur Entwurfszeit zu generieren. (Geerbt von ControlDesigner) |
| Verbs |
Ruft die Entwurfszeitverben ab, die von der dem Designer zugeordneten Komponente unterstützt werden. (Geerbt von ComponentDesigner) |
| ViewControl |
Ruft ein Webserversteuerelement ab, das für eine Vorschau des Entwurfszeit-HTML-Markups verwendet werden kann, oder legt dieses fest. (Geerbt von ControlDesigner) |
| ViewControlCreated |
Ruft einen Wert ab, der angibt, ob ein |
| Visible |
Ruft einen Wert ab, der angibt, ob das Steuerelement zur Entwurfszeit sichtbar ist. (Geerbt von ControlDesigner) |
Methoden
| Configure() |
Startet im Entwurfshost das Dienstprogramm zur Datenquellenkonfiguration. |
| CreateErrorDesignTimeHtml(String) |
Erstellt HTML-Markup, um zur Entwurfszeit eine angegebene Fehlermeldung anzuzeigen. (Geerbt von ControlDesigner) |
| CreateErrorDesignTimeHtml(String, Exception) |
Erstellt HTML-Markup, um zur Entwurfszeit eine angegebene Fehlermeldung für eine Ausnahme anzuzeigen. (Geerbt von ControlDesigner) |
| CreatePlaceHolderDesignTimeHtml() |
Stellt eine einfache rechteckige Platzhalterdarstellung bereit, die den Typ und die ID des Steuerelements anzeigt. (Geerbt von ControlDesigner) |
| CreatePlaceHolderDesignTimeHtml(String) |
Stellt eine einfache rechteckige Platzhalterdarstellung bereit, die den Typ und die ID des Steuerelements sowie zusätzliche Anweisungen oder Informationen anzeigt. (Geerbt von ControlDesigner) |
| CreateViewControl() |
Gibt eine Kopie des zugeordneten Steuerelements für die Anzeige oder das Rendern auf der Entwurfsoberfläche zurück. (Geerbt von ControlDesigner) |
| Dispose() |
Gibt alle vom ComponentDesigner verwendeten Ressourcen frei. (Geerbt von ComponentDesigner) |
| Dispose(Boolean) |
Gibt die vom HtmlControlDesigner-Objekt verwendeten nicht verwalteten Ressourcen und optional auch die verwalteten Ressourcen frei. (Geerbt von HtmlControlDesigner) |
| DoDefaultAction() |
Erstellt eine Methodensignatur in der Quellcodedatei für das Standardereignis der Komponente und verschiebt den Cursor des Benutzers an diese Position. (Geerbt von ComponentDesigner) |
| Equals(Object) |
Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object) |
| GetBounds() |
Ruft die Koordinaten des Rechtecks ab, das die Begrenzungen des auf der Entwurfsoberfläche angezeigten Steuerelements darstellt. (Geerbt von ControlDesigner) |
| GetDesignTimeHtml() |
Ruft das HTML-Markup zum Anzeigen des zugeordneten Datenquellen-Steuerelements zur Entwurfszeit ab. |
| GetDesignTimeHtml(DesignerRegionCollection) |
Ruft das HTML-Markup zum Anzeigen des Steuerelements ab und füllt die Auflistung mit den aktuellen Steuerelement-Designer-Bereichen auf. (Geerbt von ControlDesigner) |
| GetEditableDesignerRegionContent(EditableDesignerRegion) |
Gibt den Inhalt für einen bearbeitbaren Bereich der Entwurfszeitansicht des zugeordneten Steuerelements zurück. (Geerbt von ControlDesigner) |
| GetEmptyDesignTimeHtml() |
Ruft das HTML-Markup zum Darstellen eines Webserver-Steuerelements zur Entwurfszeit ab, das zur Laufzeit keine visuelle Darstellung hat. (Geerbt von ControlDesigner) |
| GetErrorDesignTimeHtml(Exception) |
Ruft das HTML-Markup ab, das Informationen über die angegebene Ausnahme bereitstellt. (Geerbt von ControlDesigner) |
| GetHashCode() |
Fungiert als Standardhashfunktion. (Geerbt von Object) |
| GetPersistenceContent() |
Ruft das dauerhafte innere HTML-Markup des Steuerelements zur Entwurfszeit ab. (Geerbt von ControlDesigner) |
| GetPersistInnerHtml() |
Veraltet.
Ruft das dauerhafte innere HTML-Markup des Steuerelements ab. (Geerbt von ControlDesigner) |
| GetService(Type) |
Versucht, den angegebenen Diensttyp von der Entwurfsmodussite der Komponente des Designers abzurufen. (Geerbt von ComponentDesigner) |
| GetType() |
Ruft den Type der aktuellen Instanz ab. (Geerbt von Object) |
| GetView(String) |
Ruft ein DesignerDataSourceView-Objekt ab, das durch den Ansichtsnamen angegeben wird. |
| GetViewNames() |
Gibt ein Array der Ansichtsnamen zurück, die in dieser Datenquelle verfügbar sind. |
| GetViewRendering() |
Ruft ein Objekt ab, das das Entwurfszeitmarkup für den Inhalt und die Bereiche des zugeordneten Steuerelements enthält. (Geerbt von ControlDesigner) |
| Initialize(IComponent) |
Initialisiert den Steuerelement-Designer und lädt die angegebene Komponente. (Geerbt von ControlDesigner) |
| InitializeExistingComponent(IDictionary) |
Initialisiert eine vorhandene Komponente erneut. (Geerbt von ComponentDesigner) |
| InitializeNewComponent(IDictionary) |
Initialisiert eine neu erstellte Komponente. (Geerbt von ComponentDesigner) |
| InitializeNonDefault() |
Veraltet.
Veraltet.
Initialisiert die Einstellungen für eine importierte Komponente, die bereits mit Einstellungen initialisiert wurde, die nicht der Standardeinstellung entsprechen. (Geerbt von ComponentDesigner) |
| Invalidate() |
Macht den gesamten Bereich des auf der Entwurfsoberfläche angezeigten Steuerelements ungültig und weist den visuellen Designer an, das Steuerelement neu zu zeichnen. (Geerbt von ControlDesigner) |
| Invalidate(Rectangle) |
Macht den angegebenen Bereich des auf der Entwurfsoberfläche angezeigten Steuerelements ungültig und weist den visuellen Designer an, das Steuerelement neu zu zeichnen. (Geerbt von ControlDesigner) |
| InvokeGetInheritanceAttribute(ComponentDesigner) |
Ruft das InheritanceAttribute des angegebenen ComponentDesigner ab. (Geerbt von ComponentDesigner) |
| IsPropertyBound(String) |
Veraltet.
Ruft einen Wert ab, der angibt, ob die angegebene Eigenschaft des zugeordneten Steuerelements datengebunden ist. (Geerbt von ControlDesigner) |
| Localize(IDesignTimeResourceWriter) |
Verwendet den bereitgestellten Ressourcenwriter, um die lokalisierbaren Eigenschaften des zugehörigen Steuerelements in einer Ressource im Entwurfshost beizubehalten. (Geerbt von ControlDesigner) |
| MemberwiseClone() |
Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object) |
| OnAutoFormatApplied(DesignerAutoFormat) |
Wird aufgerufen, wenn ein vordefiniertes Schema für die automatische Formatierung auf das zugeordnete Steuerelement angewendet wurde. (Geerbt von ControlDesigner) |
| OnBehaviorAttached() |
Wird aufgerufen, wenn der Steuerelement-Designer an ein Behavior-Objekt angefügt wird. (Geerbt von ControlDesigner) |
| OnBehaviorDetaching() |
Veraltet.
Wird aufgerufen, wenn die Zuordnung eines Verhaltens zum Element aufgehoben wird. (Geerbt von HtmlControlDesigner) |
| OnBindingsCollectionChanged(String) |
Veraltet.
Wird aufgerufen, wenn die Datenbindungsauflistung geändert wird. (Geerbt von ControlDesigner) |
| OnClick(DesignerRegionMouseEventArgs) |
Wird vom Entwurfshost aufgerufen, wenn der Benutzer zur Entwurfszeit auf das zugeordnete Steuerelement klickt. (Geerbt von ControlDesigner) |
| OnComponentChanged(Object, ComponentChangedEventArgs) |
Wird aufgerufen, wenn das zugehörige Steuerelement geändert wird. (Geerbt von ControlDesigner) |
| OnComponentChanging(Object, ComponentChangingEventArgs) |
Stellt die Methode dar, die das ComponentChanging-Ereignis des zugeordneten Steuerelements behandelt. (Geerbt von ControlDesigner) |
| OnControlResize() |
Veraltet.
Wird aufgerufen, wenn die Größe des zugeordneten Webserversteuerelements zur Entwurfszeit im Entwurfshost geändert worden ist. (Geerbt von ControlDesigner) |
| OnDataSourceChanged(EventArgs) |
Löst das DataSourceChanged-Ereignis aus, wenn die Eigenschaften der Datenquelle geändert wurden und der SuppressingDataSourceEvents-Wert |
| OnPaint(PaintEventArgs) |
Wird aufgerufen, wenn der Steuerelement-Designer das zugeordnete Steuerelement auf der Entwurfsoberfläche zeichnet, wenn der CustomPaint-Wert |
| OnSchemaRefreshed(EventArgs) |
Löst das SchemaRefreshed-Ereignis aus, wenn das Schema der Datenquelle geändert wurde und der SuppressingDataSourceEvents-Wert |
| OnSetComponentDefaults() |
Veraltet.
Veraltet.
Legt die Standardeigenschaften für die Komponente fest. (Geerbt von ComponentDesigner) |
| OnSetParent() |
Ermöglicht die Ausführung zusätzlicher Verarbeitungsschritte, wenn das zugeordnete Steuerelement an ein übergeordnetes Steuerelement angefügt wird. (Geerbt von HtmlControlDesigner) |
| PostFilterAttributes(IDictionary) |
Ermöglicht einem Designer das Ändern oder Entfernen von Elementen aus dem Satz von Attributen, der über einen TypeDescriptor verfügbar gemacht wird. (Geerbt von ComponentDesigner) |
| PostFilterEvents(IDictionary) |
Ermöglicht einem Designer das Ändern oder Entfernen von Elementen aus dem Satz von Ereignissen, der über einen TypeDescriptor verfügbar gemacht wird. (Geerbt von ComponentDesigner) |
| PostFilterProperties(IDictionary) |
Ermöglicht einem Designer das Ändern oder Entfernen von Elementen aus dem Satz von Eigenschaften, der über einen TypeDescriptor verfügbar gemacht wird. (Geerbt von ComponentDesigner) |
| PreFilterAttributes(IDictionary) |
Ermöglicht einem Designer das Hinzufügen zu dem Satz von Attributen, der über einen TypeDescriptor verfügbar gemacht wird. (Geerbt von ComponentDesigner) |
| PreFilterEvents(IDictionary) |
Legt die Liste von Ereignissen fest, die zur Entwurfszeit für das TypeDescriptor-Objekt der Komponente verfügbar gemacht werden. (Geerbt von HtmlControlDesigner) |
| PreFilterProperties(IDictionary) |
Fügt dem Eigenschaftenraster zur Entwurfszeit Eigenschaften hinzu oder entfernt diese, oder stellt neue Entwurfszeiteigenschaften bereit, die u. U. Eigenschaften des zugehörigen Steuerelements entsprechen. (Geerbt von ControlDesigner) |
| RaiseComponentChanged(MemberDescriptor, Object, Object) |
Benachrichtigt IComponentChangeService darüber, dass diese Komponente geändert wurde. (Geerbt von ComponentDesigner) |
| RaiseComponentChanging(MemberDescriptor) |
Benachrichtigt IComponentChangeService darüber, dass diese Komponente gerade geändert wird. (Geerbt von ComponentDesigner) |
| RaiseResizeEvent() |
Veraltet.
Löst das OnControlResize()-Ereignis aus. (Geerbt von ControlDesigner) |
| RefreshSchema(Boolean) |
Aktualisiert das Schema aus der Datenquelle und unterdrückt optional Ereignisse. |
| RegisterClone(Object, Object) |
Registriert interne Daten in einem geklonten Steuerelement. (Geerbt von ControlDesigner) |
| ResumeDataSourceEvents() |
Stellt Datenquellenereignisse wieder her, nachdem diese unterdrückt wurden. |
| SchemasEquivalent(IDataSourceSchema, IDataSourceSchema) |
Stellt einen Wert bereit, der angibt, ob zwei Schemas gleich sind. |
| SetEditableDesignerRegionContent(EditableDesignerRegion, String) |
Gibt den Inhalt eines editierbaren Bereichs des Steuerelements zur Entwurfszeit an. (Geerbt von ControlDesigner) |
| SetRegionContent(EditableDesignerRegion, String) |
Gibt den Inhalt für einen editierbaren Bereich der Entwurfszeitansicht des Steuerelements an. (Geerbt von ControlDesigner) |
| SetViewFlags(ViewFlags, Boolean) |
Weist dem angegebenen Flagwert die angegebene bitweise ViewFlags-Enumeration zu. (Geerbt von ControlDesigner) |
| SuppressDataSourceEvents() |
Verschiebt alle Datenquellenereignisse bis die ResumeDataSourceEvents()-Methode aufgerufen wurde. |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |
| UpdateDesignTimeHtml() |
Aktualisiert das Entwurfszeit-HTML-Markup für das zugeordnete Webserversteuerelement durch Aufruf der GetDesignTimeHtml-Methode. (Geerbt von ControlDesigner) |
| ViewSchemasEquivalent(IDataSourceViewSchema, IDataSourceViewSchema) |
Stellt einen Wert bereit, der bestimmt, ob zwei Schemaansichten gleich sind. |
Ereignisse
| DataSourceChanged |
Tritt ein, wenn sich eine beliebige Eigenschaft der zugeordneten Datenquellen ändert. |
| SchemaRefreshed |
Tritt nach dem Aktualisieren des Schemas auf. |
