DataSourceDesigner Klass
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Ger designtidsstöd i en designvärd för DataSourceControl klassen.
public ref class DataSourceDesigner : System::Web::UI::Design::ControlDesigner, System::Web::UI::Design::IDataSourceDesigner
public class DataSourceDesigner : System.Web.UI.Design.ControlDesigner, System.Web.UI.Design.IDataSourceDesigner
type DataSourceDesigner = class
inherit ControlDesigner
interface IDataSourceDesigner
Public Class DataSourceDesigner
Inherits ControlDesigner
Implements IDataSourceDesigner
- Arv
- Härledda
- Implementeringar
Exempel
I följande kodexempel visas hur du använder en anpassad datakällakontroll med flera andra små anpassade klasser, enligt listan i följande tabell.
| Anpassad klass | Härledd från |
|---|---|
CustomDataSource |
ObjectDataSource |
CustomDataSourceDesigner |
DataSourceDesigner |
CustomDataSourceView |
ObjectDataSourceView |
CustomDesignDataSourceView |
DesignerDataSourceView |
BookListViewSchema |
IDataSourceViewSchema |
CustomIDFieldSchema |
IDataSourceFieldSchema |
CustomTitleFieldSchema |
IDataSourceFieldSchema |
BookItem (En datastruktur med två fält.) |
När du har kompilerat kodexemplet öppnar du sidan .aspx i designvyn och anger DataSourceID sedan egenskapen till ID för den anpassade datakällans kontroll.
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>
Kommentarer
Klassen DataSourceDesigner är basklassen för datakällans designers, till exempel klasserna SqlDataSourceDesigner, AccessDataSourceDesigneroch ObjectDataSourceDesigner . Om du skapar en ny datakällakontroll kanske du också vill skapa en anpassad kontrolldesigner för din kontroll och härleda den DataSourceDesigner från klassen.
Klassen DataSourceDesigner har två händelsemetoder: OnDataSourceChanged metoderna och OnSchemaRefreshed . Båda dessa händelser kan tillfälligt inaktiveras med SuppressDataSourceEvents metoden, som anger SuppressingDataSourceEvents egenskapen. Händelsemetoderna kan aktiveras igen med ResumeDataSourceEvents metoden .
Det finns två statiska metoder som du kan använda för att utvärdera schemats eller vyernas likvärdighet utan att skapa en instans av klassen:
Metoden SchemasEquivalent jämför två scheman.
Metoden ViewSchemasEquivalent jämför scheman för två vyer.
Anteckningar till arvingar
Om du vill ange kommandon för åtgärdslistmenyn vid designtillfället i en härledd klass måste du åsidosätta ActionLists egenskapen för att returnera ett anpassat DesignerActionListCollection objekt med anpassade objekt som härleds från DesignerActionList objektet.
Konstruktorer
| Name | Description |
|---|---|
| DataSourceDesigner() |
Initierar en ny instans av DataSourceDesigner klassen. |
Egenskaper
| Name | Description |
|---|---|
| ActionLists |
Hämtar en lista över objekt som används för att skapa en åtgärdslistmeny vid designtillfället. |
| AllowResize |
Hämtar ett värde som anger om kontrollen kan ändras i designmiljön. (Ärvd från ControlDesigner) |
| AssociatedComponents |
Hämtar den samling komponenter som är associerade med komponenten som hanteras av designern. (Ärvd från ComponentDesigner) |
| AutoFormats |
Hämtar samlingen med fördefinierade automatiska formateringsscheman som ska visas i dialogrutan Automatiskt format för den associerade kontrollen vid designtillfället. (Ärvd från ControlDesigner) |
| Behavior |
Föråldrad.
Hämtar eller anger det DHTML-beteende som är associerat med designern. (Ärvd från HtmlControlDesigner) |
| CanConfigure |
Hämtar ett värde som anger om Configure() metoden kan anropas. |
| CanRefreshSchema |
Hämtar ett värde som anger om RefreshSchema(Boolean) metoden kan anropas. |
| Component |
Hämtar komponenten som designern designar. (Ärvd från ComponentDesigner) |
| DataBindings |
Hämtar databindningssamlingen för den aktuella kontrollen. (Ärvd från HtmlControlDesigner) |
| DataBindingsEnabled |
Hämtar ett värde som anger om databindning stöds av den innehållande regionen för den associerade kontrollen. (Ärvd från ControlDesigner) |
| DesignerState |
Hämtar ett objekt som används för att bevara data för den associerade kontrollen vid designtillfället. (Ärvd från ControlDesigner) |
| DesignTimeElement |
Föråldrad.
Hämtar designtidsobjektet som representerar kontrollen som är associerad med HtmlControlDesigner objektet på designytan. (Ärvd från HtmlControlDesigner) |
| DesignTimeElementView |
Föråldrad.
Hämtar visningskontrollobjektet för kontrolldesignern. (Ärvd från ControlDesigner) |
| DesignTimeHtmlRequiresLoadComplete |
Föråldrad.
Hämtar ett värde som anger om designvärden måste slutföra inläsningen GetDesignTimeHtml innan metoden kan anropas. (Ärvd från ControlDesigner) |
| Expressions |
Hämtar uttrycksbindningarna för den aktuella kontrollen vid designtillfället. (Ärvd från HtmlControlDesigner) |
| HidePropertiesInTemplateMode |
Hämtar ett värde som anger om egenskaperna för den associerade kontrollen är dolda när kontrollen är i mallläge. (Ärvd från ControlDesigner) |
| ID |
Hämtar eller anger ID-strängen för kontrollen. (Ärvd från ControlDesigner) |
| InheritanceAttribute |
Hämtar ett attribut som anger typen av arv för den associerade komponenten. (Ärvd från ComponentDesigner) |
| Inherited |
Hämtar ett värde som anger om den här komponenten ärvs. (Ärvd från ComponentDesigner) |
| InTemplateMode |
Hämtar ett värde som anger om kontrollen är i antingen mallvisnings- eller redigeringsläge i designvärden. Egenskapen InTemplateMode är skrivskyddad. (Ärvd från ControlDesigner) |
| IsDirty |
Föråldrad.
Hämtar eller anger ett värde som anger om webbserverkontrollen har markerats som ändrad. (Ärvd från ControlDesigner) |
| ParentComponent |
Hämtar den överordnade komponenten för den här designern. (Ärvd från ComponentDesigner) |
| ReadOnly |
Föråldrad.
Hämtar eller anger ett värde som anger om egenskaperna för kontrollen är skrivskyddade vid designtillfället. (Ärvd från ControlDesigner) |
| RootDesigner |
Hämtar kontrolldesignern för sidan Webbformulär som innehåller den associerade kontrollen. (Ärvd från ControlDesigner) |
| ShadowProperties |
Hämtar en samling egenskapsvärden som åsidosätter användarinställningar. (Ärvd från ComponentDesigner) |
| ShouldCodeSerialize |
Föråldrad.
Hämtar eller anger ett värde som anger om du vill skapa en fältdeklaration för kontrollen i filen bakom koden för det aktuella designdokumentet under serialiseringen. (Ärvd från HtmlControlDesigner) |
| SuppressingDataSourceEvents |
Hämtar ett värde som anger om händelsen DataSourceChanged eller RefreshSchema(Boolean) metoden inträffar. |
| Tag |
Hämtar ett objekt som representerar HTML-markeringselementet för den associerade kontrollen. (Ärvd från ControlDesigner) |
| TemplateGroups |
Hämtar en samling mallgrupper som var och en innehåller en eller flera malldefinitioner. (Ärvd från ControlDesigner) |
| UsePreviewControl |
Hämtar ett värde som anger om kontrolldesignern använder en tillfällig förhandsgranskningskontroll för att generera HTML-kod för designtid. (Ärvd från ControlDesigner) |
| Verbs |
Hämtar designtidsverb som stöds av komponenten som är associerad med designern. (Ärvd från ComponentDesigner) |
| ViewControl |
Hämtar eller anger en webbserverkontroll som kan användas för att förhandsgranska HTML-markeringen för designtid. (Ärvd från ControlDesigner) |
| ViewControlCreated |
Hämtar eller anger ett värde som anger om en |
| Visible |
Hämtar ett värde som anger om kontrollen är synlig vid designtillfället. (Ärvd från ControlDesigner) |
Metoder
| Name | Description |
|---|---|
| Configure() |
Startar konfigurationsverktyget för datakällan i designvärden. |
| CreateErrorDesignTimeHtml(String, Exception) |
Skapar HTML-koden för att visa ett angivet undantagsfel vid designtillfället. (Ärvd från ControlDesigner) |
| CreateErrorDesignTimeHtml(String) |
Skapar HTML-kod för att visa ett angivet felmeddelande vid designtillfället. (Ärvd från ControlDesigner) |
| CreatePlaceHolderDesignTimeHtml() |
Ger en enkel rektangulär platshållarrepresentation som visar kontrollens typ och ID. (Ärvd från ControlDesigner) |
| CreatePlaceHolderDesignTimeHtml(String) |
Tillhandahåller en enkel rektangulär platshållarrepresentation som visar kontrollens typ och ID, samt ytterligare angivna instruktioner eller information. (Ärvd från ControlDesigner) |
| CreateViewControl() |
Returnerar en kopia av den associerade kontrollen för visning eller återgivning på designytan. (Ärvd från ControlDesigner) |
| Dispose() |
Släpper alla resurser som används av ComponentDesigner. (Ärvd från ComponentDesigner) |
| Dispose(Boolean) |
Släpper de ohanterade resurser som används av HtmlControlDesigner objektet och släpper eventuellt de hanterade resurserna. (Ärvd från HtmlControlDesigner) |
| DoDefaultAction() |
Skapar en metodsignatur i källkodsfilen för standardhändelsen på komponenten och navigerar användarens markören till den platsen. (Ärvd från ComponentDesigner) |
| Equals(Object) |
Avgör om det angivna objektet är lika med det aktuella objektet. (Ärvd från Object) |
| GetBounds() |
Hämtar koordinaterna för rektangeln som representerar gränserna för kontrollen enligt designytan. (Ärvd från ControlDesigner) |
| GetDesignTimeHtml() |
Hämtar HTML-koden för att visa den associerade datakällkontrollen vid designtillfället. |
| GetDesignTimeHtml(DesignerRegionCollection) |
Hämtar HTML-markering för att visa kontrollen och fyller samlingen med de aktuella kontrolldesignerregionerna. (Ärvd från ControlDesigner) |
| GetEditableDesignerRegionContent(EditableDesignerRegion) |
Returnerar innehållet för en redigerbar region i designtidsvyn för den associerade kontrollen. (Ärvd från ControlDesigner) |
| GetEmptyDesignTimeHtml() |
Hämtar HTML-markering för att representera en webbserverkontroll vid designtillfället som inte har någon visuell representation vid körning. (Ärvd från ControlDesigner) |
| GetErrorDesignTimeHtml(Exception) |
Hämtar HTML-koden som innehåller information om det angivna undantaget. (Ärvd från ControlDesigner) |
| GetHashCode() |
Fungerar som standard-hash-funktion. (Ärvd från Object) |
| GetPersistenceContent() |
Hämtar den bestående inre HTML-koden för kontrollen vid designtillfället. (Ärvd från ControlDesigner) |
| GetPersistInnerHtml() |
Föråldrad.
Hämtar kontrollens bestående inre HTML-kod. (Ärvd från ControlDesigner) |
| GetService(Type) |
Försöker hämta den angivna typen av tjänst från designlägesplatsen för designerns komponent. (Ärvd från ComponentDesigner) |
| GetType() |
Hämtar den aktuella instansen Type . (Ärvd från Object) |
| GetView(String) |
Hämtar ett DesignerDataSourceView objekt som identifieras med visningsnamnet. |
| GetViewNames() |
Returnerar en matris med de vynamn som är tillgängliga i den här datakällan. |
| GetViewRendering() |
Hämtar ett objekt som innehåller designtidsmarkeringen för innehållet och regionerna i den associerade kontrollen. (Ärvd från ControlDesigner) |
| Initialize(IComponent) |
Initierar kontrolldesignern och läser in den angivna komponenten. (Ärvd från ControlDesigner) |
| InitializeExistingComponent(IDictionary) |
Initierar om en befintlig komponent. (Ärvd från ComponentDesigner) |
| InitializeNewComponent(IDictionary) |
Initierar en nyskapade komponent. (Ärvd från ComponentDesigner) |
| InitializeNonDefault() |
Föråldrad.
Föråldrad.
Initierar inställningarna för en importerad komponent som redan har initierats till andra inställningar än standardinställningarna. (Ärvd från ComponentDesigner) |
| Invalidate() |
Ogiltigförklarar hela området av kontrollen som visas på designytan och signalerar kontrolldesignern att rita om kontrollen. (Ärvd från ControlDesigner) |
| Invalidate(Rectangle) |
Ogiltigförklarar det angivna området för kontrollen som visas på designytan och signalerar kontrolldesignern att rita om kontrollen. (Ärvd från ControlDesigner) |
| InvokeGetInheritanceAttribute(ComponentDesigner) |
Hämtar den InheritanceAttribute angivna ComponentDesigner. (Ärvd från ComponentDesigner) |
| IsPropertyBound(String) |
Föråldrad.
Hämtar ett värde som anger om den angivna egenskapen för den associerade kontrollen är databunden. (Ärvd från ControlDesigner) |
| Localize(IDesignTimeResourceWriter) |
Använder den angivna resursskrivaren för att bevara de localizable egenskaperna för den associerade kontrollen till en resurs i designvärden. (Ärvd från ControlDesigner) |
| MemberwiseClone() |
Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object) |
| OnAutoFormatApplied(DesignerAutoFormat) |
Anropas när ett fördefinierat, automatiskt formateringsschema har tillämpats på den associerade kontrollen. (Ärvd från ControlDesigner) |
| OnBehaviorDetaching() |
Föråldrad.
Anropas när ett beteende avassocierar från elementet. (Ärvd från HtmlControlDesigner) |
| OnBindingsCollectionChanged(String) |
Föråldrad.
Anropas när databindningssamlingen ändras. (Ärvd från ControlDesigner) |
| OnClick(DesignerRegionMouseEventArgs) |
Anropas av designvärden när användaren klickar på den associerade kontrollen vid designtillfället. (Ärvd från ControlDesigner) |
| OnComponentChanged(Object, ComponentChangedEventArgs) |
Anropas när den associerade kontrollen ändras. (Ärvd från ControlDesigner) |
| OnComponentChanging(Object, ComponentChangingEventArgs) |
Representerar den metod som ska hantera ComponentChanging händelsen för den associerade kontrollen. (Ärvd från ControlDesigner) |
| OnControlResize() |
Föråldrad.
Anropas när den associerade webbserverkontrollen har ändrats i designvärden vid designtillfället. (Ärvd från ControlDesigner) |
| OnDataSourceChanged(EventArgs) |
Genererar händelsen när egenskaperna för datakällan har ändrats DataSourceChanged och SuppressingDataSourceEvents värdet är |
| OnPaint(PaintEventArgs) |
Anropas när kontrolldesignern ritar den associerade kontrollen på designytan, om CustomPaint värdet är |
| OnSchemaRefreshed(EventArgs) |
Genererar händelsen när schemat för datakällan har ändrats SchemaRefreshed och SuppressingDataSourceEvents värdet är |
| OnSetComponentDefaults() |
Föråldrad.
Föråldrad.
Anger standardegenskaperna för komponenten. (Ärvd från ComponentDesigner) |
| OnSetParent() |
Ger ett sätt att utföra ytterligare bearbetning när den associerade kontrollen är kopplad till en överordnad kontroll. (Ärvd från HtmlControlDesigner) |
| PostFilterAttributes(IDictionary) |
Gör att en designer kan ändra eller ta bort objekt från den uppsättning attribut som den exponerar via en TypeDescriptor. (Ärvd från ComponentDesigner) |
| PostFilterEvents(IDictionary) |
Gör att en designer kan ändra eller ta bort objekt från den uppsättning händelser som den exponerar via en TypeDescriptor. (Ärvd från ComponentDesigner) |
| PostFilterProperties(IDictionary) |
Gör att en designer kan ändra eller ta bort objekt från den uppsättning egenskaper som den exponerar via en TypeDescriptor. (Ärvd från ComponentDesigner) |
| PreFilterAttributes(IDictionary) |
Gör att en designer kan lägga till i den uppsättning attribut som den exponerar via en TypeDescriptor. (Ärvd från ComponentDesigner) |
| PreFilterEvents(IDictionary) |
Anger listan över händelser som exponeras vid designtid för TypeDescriptor objektet för komponenten. (Ärvd från HtmlControlDesigner) |
| PreFilterProperties(IDictionary) |
Lägger till egenskaper i eller tar bort egenskaper från rutnätet Egenskaper i en designvärd vid designtillfället eller ger nya designtidsegenskaper som kan motsvara egenskaper för den associerade kontrollen. (Ärvd från ControlDesigner) |
| RaiseComponentChanged(MemberDescriptor, Object, Object) |
Meddelar IComponentChangeService att den här komponenten har ändrats. (Ärvd från ComponentDesigner) |
| RaiseComponentChanging(MemberDescriptor) |
IComponentChangeService Meddelar att den här komponenten håller på att ändras. (Ärvd från ComponentDesigner) |
| RaiseResizeEvent() |
Föråldrad.
Genererar händelsen OnControlResize() . (Ärvd från ControlDesigner) |
| RefreshSchema(Boolean) |
Uppdaterar schemat från datakällan, samtidigt som händelser kan ignoreras. |
| RegisterClone(Object, Object) |
Registrerar interna data i en klonad kontroll. (Ärvd från ControlDesigner) |
| ResumeDataSourceEvents() |
Återställer datakällans händelser efter att datakällans händelser har ignorerats. |
| SchemasEquivalent(IDataSourceSchema, IDataSourceSchema) |
Ger ett värde som anger om två scheman är lika med. |
| SetEditableDesignerRegionContent(EditableDesignerRegion, String) |
Anger innehållet för en redigerbar region för kontrollen vid designtillfället. (Ärvd från ControlDesigner) |
| SetRegionContent(EditableDesignerRegion, String) |
Anger innehållet för en redigerbar region i kontrollens designtidsvy. (Ärvd från ControlDesigner) |
| SetViewFlags(ViewFlags, Boolean) |
Tilldelar den angivna bitvis ViewFlags uppräkning till det angivna flaggvärdet. (Ärvd från ControlDesigner) |
| SuppressDataSourceEvents() |
Skjuter upp alla datakällans händelser tills ResumeDataSourceEvents() metoden har anropats. |
| ToString() |
Returnerar en sträng som representerar det aktuella objektet. (Ärvd från Object) |
| UpdateDesignTimeHtml() |
Uppdaterar HTML-koden för designtid för den associerade webbserverkontrollen genom att anropa GetDesignTimeHtml metoden. (Ärvd från ControlDesigner) |
| ViewSchemasEquivalent(IDataSourceViewSchema, IDataSourceViewSchema) |
Ger ett värde som avgör om två schemavyer är lika med. |
Händelser
| Name | Description |
|---|---|
| DataSourceChanged |
Inträffar när någon egenskap för den associerade datakällan ändras. |
| SchemaRefreshed |
Inträffar när schemat har uppdaterats. |