DataSourceDesigner Klasa
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Zapewnia obsługę czasu projektowania na hoście projektu dla DataSourceControl klasy.
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- Dziedziczenie
- Pochodne
- Implementuje
Przykłady
Poniższy przykład kodu pokazuje, jak używać niestandardowej kontroli źródła danych z kilkoma innymi małymi klasami niestandardowymi, jak pokazano w poniższej tabeli.
| Klasa niestandardowa | Pochodzące z |
|---|---|
CustomDataSource |
ObjectDataSource |
CustomDataSourceDesigner |
DataSourceDesigner |
CustomDataSourceView |
ObjectDataSourceView |
CustomDesignDataSourceView |
DesignerDataSourceView |
BookListViewSchema |
IDataSourceViewSchema |
CustomIDFieldSchema |
IDataSourceFieldSchema |
CustomTitleFieldSchema |
IDataSourceFieldSchema |
BookItem (Struktura danych z dwoma polami). |
Po skompilowaniu przykładu kodu otwórz stronę aspx w widoku projektu, a następnie ustaw DataSourceID właściwość na identyfikator niestandardowej kontroli źródła danych.
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>
Uwagi
Klasa DataSourceDesigner jest klasą bazową dla projektantów źródeł danych, takich jak SqlDataSourceDesignerklasy , AccessDataSourceDesigneri ObjectDataSourceDesigner . Jeśli tworzysz nową kontrolkę źródła danych, możesz również utworzyć niestandardowego projektanta kontrolek dla kontrolki DataSourceDesigner i uzyskać ją z klasy.
Klasa DataSourceDesigner ma dwie metody zdarzeń: OnDataSourceChanged metody i OnSchemaRefreshed . Oba te zdarzenia można tymczasowo wyłączyć za pomocą SuppressDataSourceEvents metody , która ustawia SuppressingDataSourceEvents właściwość. Metody zdarzeń można włączyć ponownie za pomocą ResumeDataSourceEvents metody .
Istnieją dwie metody statyczne, których można użyć do oceny równoważności schematów lub widoków bez tworzenia wystąpienia klasy:
Metoda SchemasEquivalent porównuje dwa schematy.
Metoda ViewSchemasEquivalent porównuje schematy dwóch widoków.
Uwagi dotyczące dziedziczenia
Aby udostępnić polecenia menu listy akcji w czasie projektowania w klasie pochodnej, należy zastąpić ActionLists właściwość, aby zwrócić obiekt niestandardowy DesignerActionListCollection z elementami niestandardowymi pochodzącymi z DesignerActionList obiektu.
Konstruktory
| DataSourceDesigner() |
Inicjuje nowe wystąpienie klasy DataSourceDesigner. |
Właściwości
| ActionLists |
Pobiera listę elementów używanych do tworzenia menu listy akcji w czasie projektowania. |
| AllowResize |
Pobiera wartość wskazującą, czy można zmienić rozmiar kontrolki w środowisku czasu projektowania. (Odziedziczone po ControlDesigner) |
| AssociatedComponents |
Pobiera kolekcję składników skojarzonych ze składnikiem zarządzanym przez projektanta. (Odziedziczone po ComponentDesigner) |
| AutoFormats |
Pobiera kolekcję wstępnie zdefiniowanych schematów automatycznego formatowania do wyświetlania w oknie dialogowym Automatyczne formatowanie skojarzonej kontrolki w czasie projektowania. (Odziedziczone po ControlDesigner) |
| Behavior |
Przestarzałe.
Pobiera lub ustawia zachowanie DHTML skojarzone z projektantem. (Odziedziczone po HtmlControlDesigner) |
| CanConfigure |
Pobiera wartość wskazującą, czy można wywołać metodę Configure() . |
| CanRefreshSchema |
Pobiera wartość wskazującą, czy można wywołać metodę RefreshSchema(Boolean) . |
| Component |
Pobiera składnik, który projektuje ten projektant. (Odziedziczone po ComponentDesigner) |
| DataBindings |
Pobiera kolekcję powiązań danych dla bieżącej kontrolki. (Odziedziczone po HtmlControlDesigner) |
| DataBindingsEnabled |
Pobiera wartość wskazującą, czy powiązanie danych jest obsługiwane przez region zawierający skojarzona kontrolka. (Odziedziczone po ControlDesigner) |
| DesignerState |
Pobiera obiekt używany do utrwalania danych skojarzonej kontrolki w czasie projektowania. (Odziedziczone po ControlDesigner) |
| DesignTimeElement |
Przestarzałe.
Pobiera obiekt czasu projektowania reprezentujący kontrolkę skojarzona z obiektem HtmlControlDesigner na powierzchni projektowej. (Odziedziczone po HtmlControlDesigner) |
| DesignTimeElementView |
Przestarzałe.
Pobiera obiekt kontrolki widoku dla projektanta kontrolek. (Odziedziczone po ControlDesigner) |
| DesignTimeHtmlRequiresLoadComplete |
Przestarzałe.
Pobiera wartość wskazującą, czy host projektu musi zakończyć ładowanie, zanim będzie można wywołać metodę GetDesignTimeHtml . (Odziedziczone po ControlDesigner) |
| Expressions |
Pobiera powiązania wyrażeń dla bieżącej kontrolki w czasie projektowania. (Odziedziczone po HtmlControlDesigner) |
| HidePropertiesInTemplateMode |
Pobiera wartość wskazującą, czy właściwości skojarzonej kontrolki są ukryte, gdy kontrolka jest w trybie szablonu. (Odziedziczone po ControlDesigner) |
| ID |
Pobiera lub ustawia ciąg identyfikatora dla kontrolki. (Odziedziczone po ControlDesigner) |
| InheritanceAttribute |
Pobiera atrybut wskazujący typ dziedziczenia skojarzonego składnika. (Odziedziczone po ComponentDesigner) |
| Inherited |
Pobiera wartość wskazującą, czy ten składnik jest dziedziczony. (Odziedziczone po ComponentDesigner) |
| InTemplateMode |
Pobiera wartość wskazującą, czy kontrolka jest w trybie wyświetlania szablonu lub edytowania na hoście projektu. Właściwość InTemplateMode jest tylko do odczytu. (Odziedziczone po ControlDesigner) |
| IsDirty |
Przestarzałe.
Pobiera lub ustawia wartość wskazującą, czy kontrolka serwera sieci Web została oznaczona jako zmieniona. (Odziedziczone po ControlDesigner) |
| ParentComponent |
Pobiera składnik nadrzędny dla tego projektanta. (Odziedziczone po ComponentDesigner) |
| ReadOnly |
Przestarzałe.
Pobiera lub ustawia wartość wskazującą, czy właściwości kontrolki są tylko do odczytu w czasie projektowania. (Odziedziczone po ControlDesigner) |
| RootDesigner |
Pobiera projektanta kontrolek dla strony Web Forms zawierającej skojarzona kontrolkę. (Odziedziczone po ControlDesigner) |
| SetTextualDefaultProperty |
Zapewnia obsługę czasu projektowania na hoście projektu dla DataSourceControl klasy. (Odziedziczone po ComponentDesigner) |
| ShadowProperties |
Pobiera kolekcję wartości właściwości, które zastępują ustawienia użytkownika. (Odziedziczone po ComponentDesigner) |
| ShouldCodeSerialize |
Przestarzałe.
Pobiera lub ustawia wartość wskazującą, czy podczas serializacji utworzyć deklarację pola dla kontrolki w pliku za kodem dla bieżącego dokumentu projektowego. (Odziedziczone po HtmlControlDesigner) |
| SuppressingDataSourceEvents |
Pobiera wartość wskazującą, DataSourceChanged czy występuje zdarzenie, czy RefreshSchema(Boolean) metoda. |
| Tag |
Pobiera obiekt reprezentujący element znaczników HTML dla skojarzonej kontrolki. (Odziedziczone po ControlDesigner) |
| TemplateGroups |
Pobiera kolekcję grup szablonów zawierającą co najmniej jedną definicję szablonu. (Odziedziczone po ControlDesigner) |
| UsePreviewControl |
Pobiera wartość wskazującą, czy projektant kontrolek używa tymczasowej kontrolki podglądu do generowania znaczników HTML w czasie projektowania. (Odziedziczone po ControlDesigner) |
| Verbs |
Pobiera czasy projektowania obsługiwane przez składnik skojarzony z projektantem. (Odziedziczone po ComponentDesigner) |
| ViewControl |
Pobiera lub ustawia kontrolkę serwera sieci Web, która może służyć do wyświetlania podglądu znaczników HTML w czasie projektowania. (Odziedziczone po ControlDesigner) |
| ViewControlCreated |
Pobiera lub ustawia wartość wskazującą, czy kontrolka |
| Visible |
Pobiera wartość wskazującą, czy kontrolka jest widoczna w czasie projektowania. (Odziedziczone po ControlDesigner) |
Metody
| Configure() |
Uruchamia narzędzie konfiguracji źródła danych na hoście projektu. |
| CreateErrorDesignTimeHtml(String) |
Tworzy znaczniki HTML w celu wyświetlenia określonego komunikatu o błędzie w czasie projektowania. (Odziedziczone po ControlDesigner) |
| CreateErrorDesignTimeHtml(String, Exception) |
Tworzy znacznik HTML w celu wyświetlenia określonego komunikatu o błędzie wyjątku w czasie projektowania. (Odziedziczone po ControlDesigner) |
| CreatePlaceHolderDesignTimeHtml() |
Udostępnia prostą prostokątną reprezentację symbolu zastępczego, która wyświetla typ i identyfikator kontrolki. (Odziedziczone po ControlDesigner) |
| CreatePlaceHolderDesignTimeHtml(String) |
Zawiera prostą prostokątną reprezentację symbolu zastępczego, która wyświetla typ i identyfikator kontrolki, a także dodatkowe określone instrukcje lub informacje. (Odziedziczone po ControlDesigner) |
| CreateViewControl() |
Zwraca kopię skojarzonej kontrolki do wyświetlania lub renderowania na powierzchni projektowej. (Odziedziczone po ControlDesigner) |
| Dispose() |
Zwalnia wszelkie zasoby używane przez element ComponentDesigner. (Odziedziczone po ComponentDesigner) |
| Dispose(Boolean) |
Zwalnia niezarządzane zasoby, które są używane przez HtmlControlDesigner obiekt i opcjonalnie zwalnia zarządzane zasoby. (Odziedziczone po HtmlControlDesigner) |
| DoDefaultAction() |
Tworzy podpis metody w pliku kodu źródłowego dla zdarzenia domyślnego w składniku i przechodzi kursor użytkownika do tej lokalizacji. (Odziedziczone po ComponentDesigner) |
| Equals(Object) |
Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object) |
| GetBounds() |
Pobiera współrzędne prostokąta reprezentującego granice kontrolki wyświetlane na powierzchni projektowej. (Odziedziczone po ControlDesigner) |
| GetDesignTimeHtml() |
Pobiera znacznik HTML do wyświetlania skojarzonej kontroli źródła danych w czasie projektowania. |
| GetDesignTimeHtml(DesignerRegionCollection) |
Pobiera znacznik HTML, aby wyświetlić kontrolkę i wypełnić kolekcję bieżącymi regionami projektanta kontrolek. (Odziedziczone po ControlDesigner) |
| GetEditableDesignerRegionContent(EditableDesignerRegion) |
Zwraca zawartość dla edytowalnego regionu widoku czasu projektowania skojarzonej kontrolki. (Odziedziczone po ControlDesigner) |
| GetEmptyDesignTimeHtml() |
Pobiera znaczniki HTML, aby reprezentować kontrolkę serwera sieci Web w czasie projektowania, która nie będzie miała wizualnej reprezentacji w czasie wykonywania. (Odziedziczone po ControlDesigner) |
| GetErrorDesignTimeHtml(Exception) |
Pobiera znacznik HTML, który zawiera informacje o określonym wyjątku. (Odziedziczone po ControlDesigner) |
| GetHashCode() |
Służy jako domyślna funkcja skrótu. (Odziedziczone po Object) |
| GetPersistenceContent() |
Pobiera trwały wewnętrzny znacznik HTML kontrolki w czasie projektowania. (Odziedziczone po ControlDesigner) |
| GetPersistInnerHtml() |
Przestarzałe.
Pobiera trwały wewnętrzny znacznik HTML kontrolki. (Odziedziczone po ControlDesigner) |
| GetService(Type) |
Próbuje pobrać określony typ usługi z witryny trybu projektowania składnika projektanta. (Odziedziczone po ComponentDesigner) |
| GetType() |
Type Pobiera bieżące wystąpienie. (Odziedziczone po Object) |
| GetView(String) |
DesignerDataSourceView Pobiera obiekt identyfikowany przez nazwę widoku. |
| GetViewNames() |
Zwraca tablicę nazw widoków dostępnych w tym źródle danych. |
| GetViewRendering() |
Pobiera obiekt zawierający znacznik czasu projektowania zawartości i regionów skojarzonej kontrolki. (Odziedziczone po ControlDesigner) |
| Initialize(IComponent) |
Inicjuje projektanta kontrolek i ładuje określony składnik. (Odziedziczone po ControlDesigner) |
| InitializeExistingComponent(IDictionary) |
Ponownie inicjuje istniejący składnik. (Odziedziczone po ComponentDesigner) |
| InitializeNewComponent(IDictionary) |
Inicjuje nowo utworzony składnik. (Odziedziczone po ComponentDesigner) |
| InitializeNonDefault() |
Przestarzałe.
Przestarzałe.
Inicjuje ustawienia zaimportowanego składnika, który jest już inicjowany do ustawień innych niż domyślne. (Odziedziczone po ComponentDesigner) |
| Invalidate() |
Unieważnia cały obszar kontrolki wyświetlanej na powierzchni projektowej i sygnalizuje projektantowi sterowania ponowne rysowanie kontrolki. (Odziedziczone po ControlDesigner) |
| Invalidate(Rectangle) |
Unieważnia określony obszar kontrolki wyświetlanej na powierzchni projektowej i sygnalizuje projektantowi sterowania ponowne rysowanie kontrolki. (Odziedziczone po ControlDesigner) |
| InvokeGetInheritanceAttribute(ComponentDesigner) |
InheritanceAttribute Pobiera określony ComponentDesignerelement . (Odziedziczone po ComponentDesigner) |
| IsPropertyBound(String) |
Przestarzałe.
Pobiera wartość wskazującą, czy określona właściwość skojarzonej kontrolki jest powiązana z danymi. (Odziedziczone po ControlDesigner) |
| Localize(IDesignTimeResourceWriter) |
Używa dostarczonego składnika zapisywania zasobów do utrwalania zlokalizowanych właściwości skojarzonej kontrolki z zasobem na hoście projektu. (Odziedziczone po ControlDesigner) |
| MemberwiseClone() |
Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object) |
| OnAutoFormatApplied(DesignerAutoFormat) |
Wywoływana, gdy wstępnie zdefiniowany schemat formatowania automatycznego został zastosowany do skojarzonej kontrolki. (Odziedziczone po ControlDesigner) |
| OnBehaviorAttached() |
Wywoływane, gdy projektant kontrolek jest dołączony do obiektu Zachowanie. (Odziedziczone po ControlDesigner) |
| OnBehaviorDetaching() |
Przestarzałe.
Wywoływane, gdy zachowanie nie jest skojarzone z elementem. (Odziedziczone po HtmlControlDesigner) |
| OnBindingsCollectionChanged(String) |
Przestarzałe.
Wywoływane po zmianie kolekcji powiązania danych. (Odziedziczone po ControlDesigner) |
| OnClick(DesignerRegionMouseEventArgs) |
Wywoływane przez hosta projektu, gdy użytkownik kliknie skojarzą kontrolkę w czasie projektowania. (Odziedziczone po ControlDesigner) |
| OnComponentChanged(Object, ComponentChangedEventArgs) |
Wywoływana, gdy skojarzona kontrolka ulegnie zmianie. (Odziedziczone po ControlDesigner) |
| OnComponentChanging(Object, ComponentChangingEventArgs) |
Reprezentuje metodę, która będzie obsługiwać ComponentChanging zdarzenie dla skojarzonej kontrolki. (Odziedziczone po ControlDesigner) |
| OnControlResize() |
Przestarzałe.
Wywoływana po zmianie rozmiaru skojarzonej kontrolki serwera sieci Web na hoście projektu w czasie projektowania. (Odziedziczone po ControlDesigner) |
| OnDataSourceChanged(EventArgs) |
DataSourceChanged Zgłasza zdarzenie, gdy właściwości źródła danych uległy zmianie, a SuppressingDataSourceEvents wartość to |
| OnPaint(PaintEventArgs) |
Wywoływana, gdy projektant kontrolek rysuje skojarzona kontrolkę na powierzchni projektowej, jeśli CustomPaint wartość to |
| OnSchemaRefreshed(EventArgs) |
SchemaRefreshed Zgłasza zdarzenie, gdy schemat źródła danych uległ zmianie, a SuppressingDataSourceEvents wartość to |
| OnSetComponentDefaults() |
Przestarzałe.
Przestarzałe.
Ustawia domyślne właściwości składnika. (Odziedziczone po ComponentDesigner) |
| OnSetParent() |
Zapewnia sposób wykonywania dodatkowego przetwarzania, gdy skojarzona kontrolka jest dołączona do kontrolki nadrzędnej. (Odziedziczone po HtmlControlDesigner) |
| PostFilterAttributes(IDictionary) |
Umożliwia projektantowi zmianę lub usunięcie elementów z zestawu atrybutów, które uwidacznia za pośrednictwem elementu TypeDescriptor. (Odziedziczone po ComponentDesigner) |
| PostFilterEvents(IDictionary) |
Umożliwia projektantowi zmianę lub usunięcie elementów z zestawu zdarzeń udostępnianych za pośrednictwem elementu TypeDescriptor. (Odziedziczone po ComponentDesigner) |
| PostFilterProperties(IDictionary) |
Umożliwia projektantowi zmianę lub usunięcie elementów z zestawu właściwości uwidacznianych za pomocą elementu TypeDescriptor. (Odziedziczone po ComponentDesigner) |
| PreFilterAttributes(IDictionary) |
Umożliwia projektantowi dodanie do zestawu atrybutów uwidacznianych za pośrednictwem elementu TypeDescriptor. (Odziedziczone po ComponentDesigner) |
| PreFilterEvents(IDictionary) |
Ustawia listę zdarzeń, które są uwidocznione w czasie projektowania dla TypeDescriptor obiektu składnika. (Odziedziczone po HtmlControlDesigner) |
| PreFilterProperties(IDictionary) |
Dodaje właściwości do siatki Właściwości lub usuwa je w hoście projektu w czasie projektowania lub udostępnia nowe właściwości czasu projektowania, które mogą odpowiadać właściwościom skojarzonej kontrolki. (Odziedziczone po ControlDesigner) |
| RaiseComponentChanged(MemberDescriptor, Object, Object) |
Powiadamia o IComponentChangeService zmianie tego składnika. (Odziedziczone po ComponentDesigner) |
| RaiseComponentChanging(MemberDescriptor) |
Powiadamia o IComponentChangeService zmianie tego składnika. (Odziedziczone po ComponentDesigner) |
| RaiseResizeEvent() |
Przestarzałe.
OnControlResize() Zgłasza zdarzenie. (Odziedziczone po ControlDesigner) |
| RefreshSchema(Boolean) |
Odświeża schemat ze źródła danych, a opcjonalnie pomija zdarzenia. |
| RegisterClone(Object, Object) |
Rejestruje dane wewnętrzne w sklonowanej kontrolce. (Odziedziczone po ControlDesigner) |
| ResumeDataSourceEvents() |
Przywraca zdarzenia źródła danych po pomijaniu zdarzeń źródła danych. |
| SchemasEquivalent(IDataSourceSchema, IDataSourceSchema) |
Zawiera wartość wskazującą, czy dwa schematy są równe. |
| SetEditableDesignerRegionContent(EditableDesignerRegion, String) |
Określa zawartość edytowalnego regionu kontrolki w czasie projektowania. (Odziedziczone po ControlDesigner) |
| SetRegionContent(EditableDesignerRegion, String) |
Określa zawartość regionu edytowalnego w widoku czasu projektowania kontrolki. (Odziedziczone po ControlDesigner) |
| SetViewFlags(ViewFlags, Boolean) |
Przypisuje określoną wyliczenie bitowe ViewFlags do określonej wartości flagi. (Odziedziczone po ControlDesigner) |
| SuppressDataSourceEvents() |
Odroczy wszystkie zdarzenia źródła danych do momentu wywołania ResumeDataSourceEvents() metody . |
| ToString() |
Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object) |
| UpdateDesignTimeHtml() |
Odświeża znacznik HTML czasu projektowania dla skojarzonej kontrolki serwera sieci Web, wywołując metodę GetDesignTimeHtml . (Odziedziczone po ControlDesigner) |
| ViewSchemasEquivalent(IDataSourceViewSchema, IDataSourceViewSchema) |
Zawiera wartość określającą, czy dwa widoki schematu są równe. |
Zdarzenia
| DataSourceChanged |
Występuje, gdy każda właściwość skojarzonego źródła danych ulegnie zmianie. |
| SchemaRefreshed |
Występuje po odświeżeniu schematu. |
Jawne implementacje interfejsu
| IDesignerFilter.PostFilterAttributes(IDictionary) |
Aby uzyskać opis tego elementu członkowskiego, zobacz metodę PostFilterAttributes(IDictionary) . (Odziedziczone po ComponentDesigner) |
| IDesignerFilter.PostFilterEvents(IDictionary) |
Aby uzyskać opis tego elementu członkowskiego, zobacz metodę PostFilterEvents(IDictionary) . (Odziedziczone po ComponentDesigner) |
| IDesignerFilter.PostFilterProperties(IDictionary) |
Aby uzyskać opis tego elementu członkowskiego, zobacz metodę PostFilterProperties(IDictionary) . (Odziedziczone po ComponentDesigner) |
| IDesignerFilter.PreFilterAttributes(IDictionary) |
Aby uzyskać opis tego elementu członkowskiego, zobacz metodę PreFilterAttributes(IDictionary) . (Odziedziczone po ComponentDesigner) |
| IDesignerFilter.PreFilterEvents(IDictionary) |
Aby uzyskać opis tego elementu członkowskiego, zobacz metodę PreFilterEvents(IDictionary) . (Odziedziczone po ComponentDesigner) |
| IDesignerFilter.PreFilterProperties(IDictionary) |
Aby uzyskać opis tego elementu członkowskiego, zobacz metodę PreFilterProperties(IDictionary) . (Odziedziczone po ComponentDesigner) |
| ITreeDesigner.Children |
Aby uzyskać opis tego elementu członkowskiego, zobacz Children właściwość . (Odziedziczone po ComponentDesigner) |
| ITreeDesigner.Parent |
Aby uzyskać opis tego elementu członkowskiego, zobacz Parent właściwość . (Odziedziczone po ComponentDesigner) |
Dotyczy
Zobacz też
Opinia
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź: https://aka.ms/ContentUserFeedback.
Prześlij i wyświetl opinię dla