DataSourceDesigner Kelas
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Menyediakan dukungan waktu desain di host desain untuk DataSourceControl kelas .
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- Warisan
- Turunan
- Penerapan
Contoh
Contoh kode berikut menunjukkan cara menggunakan kontrol sumber data kustom dengan beberapa kelas kustom kecil lainnya, seperti yang tercantum dalam tabel berikut.
| Kelas kustom | Berasal dari |
|---|---|
CustomDataSource |
ObjectDataSource |
CustomDataSourceDesigner |
DataSourceDesigner |
CustomDataSourceView |
ObjectDataSourceView |
CustomDesignDataSourceView |
DesignerDataSourceView |
BookListViewSchema |
IDataSourceViewSchema |
CustomIDFieldSchema |
IDataSourceFieldSchema |
CustomTitleFieldSchema |
IDataSourceFieldSchema |
BookItem (Struktur data dua bidang.) |
Setelah mengkompilasi contoh kode, buka halaman .aspx dalam tampilan Desain lalu atur DataSourceID properti ke ID kontrol sumber data kustom.
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>
Keterangan
Kelas DataSourceDesigner adalah kelas dasar untuk perancang sumber data, seperti SqlDataSourceDesignerkelas , , AccessDataSourceDesignerdan ObjectDataSourceDesigner . Jika Anda membuat kontrol sumber data baru, Anda mungkin juga ingin membuat perancang kontrol kustom untuk kontrol Anda dan mendapatkannya dari DataSourceDesigner kelas .
Kelas DataSourceDesigner ini memiliki dua metode peristiwa: OnDataSourceChanged metode dan OnSchemaRefreshed . Kedua peristiwa ini dapat dinonaktifkan sementara dengan SuppressDataSourceEvents metode , yang mengatur SuppressingDataSourceEvents properti . Metode peristiwa dapat diaktifkan lagi dengan ResumeDataSourceEvents metode .
Ada dua metode statis yang dapat Anda gunakan untuk mengevaluasi kesetaraan skema atau tampilan tanpa membuat instans kelas :
Metode ini SchemasEquivalent membandingkan dua skema.
Metode membandingkan ViewSchemasEquivalent skema dua tampilan.
Catatan Bagi Inheritor
Untuk menyediakan perintah untuk menu daftar tindakan pada waktu desain di kelas turunan, Anda harus mengambil ActionLists alih properti untuk mengembalikan objek kustom DesignerActionListCollection dengan item kustom yang berasal dari DesignerActionList objek.
Konstruktor
| DataSourceDesigner() |
Menginisialisasi instans baru kelas DataSourceDesigner. |
Properti
| ActionLists |
Mendapatkan daftar item yang digunakan untuk membuat menu daftar tindakan pada waktu desain. |
| AllowResize |
Mendapatkan nilai yang menunjukkan apakah kontrol dapat diubah ukurannya di lingkungan waktu desain. (Diperoleh dari ControlDesigner) |
| AssociatedComponents |
Mendapatkan kumpulan komponen yang terkait dengan komponen yang dikelola oleh perancang. (Diperoleh dari ComponentDesigner) |
| AutoFormats |
Mendapatkan kumpulan skema pemformatan otomatis yang telah ditentukan sebelumnya untuk ditampilkan dalam kotak dialog Format Otomatis untuk kontrol terkait pada waktu desain. (Diperoleh dari ControlDesigner) |
| Behavior |
Kedaluwarsa.
Mendapatkan atau mengatur perilaku DHTML yang terkait dengan perancang. (Diperoleh dari HtmlControlDesigner) |
| CanConfigure |
Mendapatkan nilai yang menunjukkan apakah Configure() metode dapat dipanggil. |
| CanRefreshSchema |
Mendapatkan nilai yang menunjukkan apakah RefreshSchema(Boolean) metode dapat dipanggil. |
| Component |
Mendapatkan komponen yang didesain desainer ini. (Diperoleh dari ComponentDesigner) |
| DataBindings |
Mendapatkan pengumpulan pengikatan data untuk kontrol saat ini. (Diperoleh dari HtmlControlDesigner) |
| DataBindingsEnabled |
Mendapatkan nilai yang menunjukkan apakah pengikatan data didukung oleh wilayah yang berisi untuk kontrol terkait. (Diperoleh dari ControlDesigner) |
| DesignerState |
Mendapatkan objek yang digunakan untuk mempertahankan data untuk kontrol terkait pada waktu desain. (Diperoleh dari ControlDesigner) |
| DesignTimeElement |
Kedaluwarsa.
Mendapatkan objek waktu desain yang mewakili kontrol yang terkait dengan HtmlControlDesigner objek pada permukaan desain. (Diperoleh dari HtmlControlDesigner) |
| DesignTimeElementView |
Kedaluwarsa.
Mendapatkan objek kontrol tampilan untuk perancang kontrol. (Diperoleh dari ControlDesigner) |
| DesignTimeHtmlRequiresLoadComplete |
Kedaluwarsa.
Mendapatkan nilai yang menunjukkan apakah host desain harus menyelesaikan pemuatan sebelum GetDesignTimeHtml metode dapat dipanggil. (Diperoleh dari ControlDesigner) |
| Expressions |
Mendapatkan pengikatan ekspresi untuk kontrol saat ini pada waktu desain. (Diperoleh dari HtmlControlDesigner) |
| HidePropertiesInTemplateMode |
Mendapatkan nilai yang menunjukkan apakah properti kontrol terkait disembunyikan saat kontrol dalam mode templat. (Diperoleh dari ControlDesigner) |
| ID |
Mendapatkan atau mengatur string ID untuk kontrol. (Diperoleh dari ControlDesigner) |
| InheritanceAttribute |
Mendapatkan atribut yang menunjukkan jenis pewarisan komponen terkait. (Diperoleh dari ComponentDesigner) |
| Inherited |
Mendapatkan nilai yang menunjukkan apakah komponen ini diwariskan. (Diperoleh dari ComponentDesigner) |
| InTemplateMode |
Mendapatkan nilai yang menunjukkan apakah kontrol berada dalam mode tampilan templat atau pengeditan di host desain. Properti InTemplateMode bersifat baca-saja. (Diperoleh dari ControlDesigner) |
| IsDirty |
Kedaluwarsa.
Mendapatkan atau menetapkan nilai yang menunjukkan apakah kontrol server Web telah ditandai sebagai diubah. (Diperoleh dari ControlDesigner) |
| ParentComponent |
Mendapatkan komponen induk untuk perancang ini. (Diperoleh dari ComponentDesigner) |
| ReadOnly |
Kedaluwarsa.
Mendapatkan atau menetapkan nilai yang menunjukkan apakah properti kontrol bersifat baca-saja pada waktu desain. (Diperoleh dari ControlDesigner) |
| RootDesigner |
Mendapatkan perancang kontrol untuk halaman Formulir Web yang berisi kontrol terkait. (Diperoleh dari ControlDesigner) |
| SetTextualDefaultProperty |
Menyediakan dukungan waktu desain di host desain untuk DataSourceControl kelas . (Diperoleh dari ComponentDesigner) |
| ShadowProperties |
Mendapatkan kumpulan nilai properti yang mengambil alih pengaturan pengguna. (Diperoleh dari ComponentDesigner) |
| ShouldCodeSerialize |
Kedaluwarsa.
Mendapatkan atau menetapkan nilai yang menunjukkan apakah akan membuat deklarasi bidang untuk kontrol dalam file code-behind untuk dokumen desain saat ini selama serialisasi. (Diperoleh dari HtmlControlDesigner) |
| SuppressingDataSourceEvents |
Mendapatkan nilai yang menunjukkan apakah DataSourceChanged peristiwa atau RefreshSchema(Boolean) metode terjadi. |
| Tag |
Mendapatkan objek yang mewakili elemen markup HTML untuk kontrol terkait. (Diperoleh dari ControlDesigner) |
| TemplateGroups |
Mendapatkan kumpulan grup templat, masing-masing berisi satu atau beberapa definisi templat. (Diperoleh dari ControlDesigner) |
| UsePreviewControl |
Mendapatkan nilai yang menunjukkan apakah perancang kontrol menggunakan kontrol pratinjau sementara untuk menghasilkan markup HTML waktu desain. (Diperoleh dari ControlDesigner) |
| Verbs |
Mendapatkan kata kerja waktu desain yang didukung oleh komponen yang terkait dengan perancang. (Diperoleh dari ComponentDesigner) |
| ViewControl |
Mendapatkan atau mengatur kontrol server Web yang dapat digunakan untuk mempratinjau markup HTML waktu desain. (Diperoleh dari ControlDesigner) |
| ViewControlCreated |
Mendapatkan atau menetapkan nilai yang menunjukkan apakah |
| Visible |
Mendapatkan nilai yang menunjukkan apakah kontrol terlihat pada waktu desain. (Diperoleh dari ControlDesigner) |
Metode
| Configure() |
Meluncurkan utilitas konfigurasi sumber data di host desain. |
| CreateErrorDesignTimeHtml(String) |
Membuat markup HTML untuk menampilkan pesan kesalahan tertentu pada waktu desain. (Diperoleh dari ControlDesigner) |
| CreateErrorDesignTimeHtml(String, Exception) |
Membuat markup HTML untuk menampilkan pesan kesalahan pengecualian tertentu pada waktu desain. (Diperoleh dari ControlDesigner) |
| CreatePlaceHolderDesignTimeHtml() |
Menyediakan representasi tempat penampung persegi panjang sederhana yang menampilkan jenis dan ID kontrol. (Diperoleh dari ControlDesigner) |
| CreatePlaceHolderDesignTimeHtml(String) |
Menyediakan representasi tempat penampung persegi panjang sederhana yang menampilkan jenis dan ID kontrol, dan juga instruksi atau informasi tambahan yang ditentukan. (Diperoleh dari ControlDesigner) |
| CreateViewControl() |
Mengembalikan salinan kontrol terkait untuk menampilkan atau merender pada permukaan desain. (Diperoleh dari ControlDesigner) |
| Dispose() |
Merilis semua sumber daya yang ComponentDesignerdigunakan oleh . (Diperoleh dari ComponentDesigner) |
| Dispose(Boolean) |
Merilis sumber daya tidak terkelola yang digunakan oleh HtmlControlDesigner objek dan secara opsional merilis sumber daya terkelola. (Diperoleh dari HtmlControlDesigner) |
| DoDefaultAction() |
Membuat tanda tangan metode dalam file kode sumber untuk peristiwa default pada komponen dan menavigasi kursor pengguna ke lokasi tersebut. (Diperoleh dari ComponentDesigner) |
| Equals(Object) |
Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object) |
| GetBounds() |
Mengambil koordinat persegi panjang yang mewakili batas untuk kontrol seperti yang ditampilkan pada permukaan desain. (Diperoleh dari ControlDesigner) |
| GetDesignTimeHtml() |
Mengambil markup HTML untuk menampilkan kontrol sumber data terkait pada waktu desain. |
| GetDesignTimeHtml(DesignerRegionCollection) |
Mengambil markup HTML untuk menampilkan kontrol dan mengisi koleksi dengan wilayah perancang kontrol saat ini. (Diperoleh dari ControlDesigner) |
| GetEditableDesignerRegionContent(EditableDesignerRegion) |
Mengembalikan konten untuk wilayah yang dapat diedit dari tampilan waktu desain kontrol terkait. (Diperoleh dari ControlDesigner) |
| GetEmptyDesignTimeHtml() |
Mengambil markup HTML untuk mewakili kontrol server Web pada waktu desain yang tidak akan memiliki representasi visual pada durasi. (Diperoleh dari ControlDesigner) |
| GetErrorDesignTimeHtml(Exception) |
Mengambil markup HTML yang menyediakan informasi tentang pengecualian yang ditentukan. (Diperoleh dari ControlDesigner) |
| GetHashCode() |
Berfungsi sebagai fungsi hash default. (Diperoleh dari Object) |
| GetPersistenceContent() |
Mengambil markup HTML dalam kontrol yang dapat dipertahankan pada waktu desain. (Diperoleh dari ControlDesigner) |
| GetPersistInnerHtml() |
Kedaluwarsa.
Mengambil markup HTML dalam kontrol yang dapat dipertahankan. (Diperoleh dari ControlDesigner) |
| GetService(Type) |
Mencoba mengambil jenis layanan yang ditentukan dari situs mode desain komponen perancang. (Diperoleh dari ComponentDesigner) |
| GetType() |
Mendapatkan instans Type saat ini. (Diperoleh dari Object) |
| GetView(String) |
DesignerDataSourceView Mengambil objek yang diidentifikasi dengan nama tampilan. |
| GetViewNames() |
Mengembalikan array nama tampilan yang tersedia di sumber data ini. |
| GetViewRendering() |
Mengambil objek yang berisi markup waktu desain untuk konten dan wilayah kontrol terkait. (Diperoleh dari ControlDesigner) |
| Initialize(IComponent) |
Menginisialisasi perancang kontrol dan memuat komponen yang ditentukan. (Diperoleh dari ControlDesigner) |
| InitializeExistingComponent(IDictionary) |
Menginisialisasi ulang komponen yang ada. (Diperoleh dari ComponentDesigner) |
| InitializeNewComponent(IDictionary) |
Menginisialisasi komponen yang baru dibuat. (Diperoleh dari ComponentDesigner) |
| InitializeNonDefault() |
Kedaluwarsa.
Kedaluwarsa.
Menginisialisasi pengaturan untuk komponen yang diimpor yang sudah diinisialisasi ke pengaturan selain default. (Diperoleh dari ComponentDesigner) |
| Invalidate() |
Membatalkan seluruh area kontrol yang ditampilkan pada permukaan desain dan memberi sinyal kepada perancang kontrol untuk menggambar ulang kontrol. (Diperoleh dari ControlDesigner) |
| Invalidate(Rectangle) |
Membatalkan area kontrol yang ditentukan yang ditampilkan pada permukaan desain dan memberi sinyal kepada perancang kontrol untuk menggambar ulang kontrol. (Diperoleh dari ControlDesigner) |
| InvokeGetInheritanceAttribute(ComponentDesigner) |
InheritanceAttribute Mendapatkan dari yang ditentukanComponentDesigner. (Diperoleh dari ComponentDesigner) |
| IsPropertyBound(String) |
Kedaluwarsa.
Mengambil nilai yang menunjukkan apakah properti yang ditentukan pada kontrol terkait terikat data. (Diperoleh dari ControlDesigner) |
| Localize(IDesignTimeResourceWriter) |
Menggunakan penulis sumber daya yang disediakan untuk mempertahankan properti kontrol terkait yang dapat dilokalkan ke sumber daya di host desain. (Diperoleh dari ControlDesigner) |
| MemberwiseClone() |
Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object) |
| OnAutoFormatApplied(DesignerAutoFormat) |
Dipanggil ketika skema pemformatan otomatis yang telah ditentukan sebelumnya telah diterapkan ke kontrol terkait. (Diperoleh dari ControlDesigner) |
| OnBehaviorAttached() |
Dipanggil saat perancang kontrol dilampirkan ke objek Perilaku. (Diperoleh dari ControlDesigner) |
| OnBehaviorDetaching() |
Kedaluwarsa.
Dipanggil ketika perilaku memisahkan diri dari elemen . (Diperoleh dari HtmlControlDesigner) |
| OnBindingsCollectionChanged(String) |
Kedaluwarsa.
Dipanggil saat pengumpulan pengikatan data berubah. (Diperoleh dari ControlDesigner) |
| OnClick(DesignerRegionMouseEventArgs) |
Dipanggil oleh host desain saat pengguna mengklik kontrol terkait pada waktu desain. (Diperoleh dari ControlDesigner) |
| OnComponentChanged(Object, ComponentChangedEventArgs) |
Dipanggil saat kontrol terkait berubah. (Diperoleh dari ControlDesigner) |
| OnComponentChanging(Object, ComponentChangingEventArgs) |
Mewakili metode yang akan menangani ComponentChanging peristiwa untuk kontrol terkait. (Diperoleh dari ControlDesigner) |
| OnControlResize() |
Kedaluwarsa.
Dipanggil ketika kontrol server Web terkait telah diubah ukurannya di host desain pada waktu desain. (Diperoleh dari ControlDesigner) |
| OnDataSourceChanged(EventArgs) |
Memunculkan DataSourceChanged peristiwa ketika properti sumber data telah berubah dan nilainya SuppressingDataSourceEvents adalah |
| OnPaint(PaintEventArgs) |
Dipanggil ketika perancang kontrol menggambar kontrol terkait pada permukaan desain, jika CustomPaint nilainya adalah |
| OnSchemaRefreshed(EventArgs) |
Menaikkan SchemaRefreshed peristiwa ketika skema sumber data telah berubah dan nilainya SuppressingDataSourceEvents adalah |
| OnSetComponentDefaults() |
Kedaluwarsa.
Kedaluwarsa.
Mengatur properti default untuk komponen. (Diperoleh dari ComponentDesigner) |
| OnSetParent() |
Menyediakan cara untuk melakukan pemrosesan tambahan ketika kontrol terkait dilampirkan ke kontrol induk. (Diperoleh dari HtmlControlDesigner) |
| PostFilterAttributes(IDictionary) |
Memungkinkan perancang untuk mengubah atau menghapus item dari sekumpulan atribut yang diekspos melalui TypeDescriptor. (Diperoleh dari ComponentDesigner) |
| PostFilterEvents(IDictionary) |
Memungkinkan perancang untuk mengubah atau menghapus item dari serangkaian peristiwa yang diekspos melalui TypeDescriptor. (Diperoleh dari ComponentDesigner) |
| PostFilterProperties(IDictionary) |
Memungkinkan perancang untuk mengubah atau menghapus item dari sekumpulan properti yang diekspos melalui TypeDescriptor. (Diperoleh dari ComponentDesigner) |
| PreFilterAttributes(IDictionary) |
Memungkinkan perancang untuk menambahkan ke set atribut yang diekspos melalui TypeDescriptor. (Diperoleh dari ComponentDesigner) |
| PreFilterEvents(IDictionary) |
Mengatur daftar peristiwa yang diekspos pada waktu desain untuk TypeDescriptor objek untuk komponen. (Diperoleh dari HtmlControlDesigner) |
| PreFilterProperties(IDictionary) |
Menambahkan properti ke atau menghapus properti dari kisi Properti di host desain pada waktu desain atau menyediakan properti waktu desain baru yang mungkin sesuai dengan properti pada kontrol terkait. (Diperoleh dari ControlDesigner) |
| RaiseComponentChanged(MemberDescriptor, Object, Object) |
Memberi tahu IComponentChangeService bahwa komponen ini telah diubah. (Diperoleh dari ComponentDesigner) |
| RaiseComponentChanging(MemberDescriptor) |
Memberi tahu IComponentChangeService bahwa komponen ini akan diubah. (Diperoleh dari ComponentDesigner) |
| RaiseResizeEvent() |
Kedaluwarsa.
Memunculkan kejadian OnControlResize(). (Diperoleh dari ControlDesigner) |
| RefreshSchema(Boolean) |
Merefresh skema dari sumber data, sambil secara opsional menekan peristiwa. |
| RegisterClone(Object, Object) |
Mendaftarkan data internal dalam kontrol kloning. (Diperoleh dari ControlDesigner) |
| ResumeDataSourceEvents() |
Memulihkan peristiwa sumber data setelah peristiwa sumber data ditekan. |
| SchemasEquivalent(IDataSourceSchema, IDataSourceSchema) |
Menyediakan nilai yang menunjukkan apakah dua skema sama. |
| SetEditableDesignerRegionContent(EditableDesignerRegion, String) |
Menentukan konten untuk wilayah kontrol yang dapat diedit pada waktu desain. (Diperoleh dari ControlDesigner) |
| SetRegionContent(EditableDesignerRegion, String) |
Menentukan konten untuk wilayah yang dapat diedit dalam tampilan waktu desain kontrol. (Diperoleh dari ControlDesigner) |
| SetViewFlags(ViewFlags, Boolean) |
Menetapkan enumerasi bitwise ViewFlags yang ditentukan ke nilai bendera yang ditentukan. (Diperoleh dari ControlDesigner) |
| SuppressDataSourceEvents() |
Menunda semua peristiwa sumber data hingga setelah metode dipanggil ResumeDataSourceEvents() . |
| ToString() |
Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object) |
| UpdateDesignTimeHtml() |
Menyegarkan markup HTML waktu desain untuk kontrol server Web terkait dengan memanggil GetDesignTimeHtml metode . (Diperoleh dari ControlDesigner) |
| ViewSchemasEquivalent(IDataSourceViewSchema, IDataSourceViewSchema) |
Menyediakan nilai yang menentukan apakah dua tampilan skema sama. |
Acara
| DataSourceChanged |
Terjadi ketika properti apa pun dari sumber data terkait berubah. |
| SchemaRefreshed |
Terjadi setelah skema disegarkan. |
Implementasi Antarmuka Eksplisit
Berlaku untuk
Lihat juga
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk