DataSourceDesigner Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Poskytuje podporu v době návrhu v hostiteli návrhu DataSourceControl pro třídu.
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- Dědičnost
- Odvozené
- Implementuje
Příklady
Následující příklad kódu ukazuje, jak použít vlastní ovládací prvek zdroje dat s několika dalšími malými vlastními třídami, jak je uvedeno v následující tabulce.
| Vlastní třída | Odvozeno z |
|---|---|
CustomDataSource |
ObjectDataSource |
CustomDataSourceDesigner |
DataSourceDesigner |
CustomDataSourceView |
ObjectDataSourceView |
CustomDesignDataSourceView |
DesignerDataSourceView |
BookListViewSchema |
IDataSourceViewSchema |
CustomIDFieldSchema |
IDataSourceFieldSchema |
CustomTitleFieldSchema |
IDataSourceFieldSchema |
BookItem (Datová struktura se dvěma poli.) |
Po kompilaci příkladu kódu otevřete stránku .aspx v návrhovém zobrazení a nastavte DataSourceID vlastnost na ID ovládacího prvku vlastního zdroje dat.
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>
Poznámky
Třída DataSourceDesigner je základní třídou pro návrháře zdrojů dat, jako SqlDataSourceDesignerjsou třídy , AccessDataSourceDesignera ObjectDataSourceDesigner . Pokud vytvoříte nový ovládací prvek zdroje dat, můžete také vytvořit vlastního návrháře ovládacích prvků pro ovládací prvek a odvodit ho DataSourceDesigner z třídy.
Třída DataSourceDesigner má dvě metody událostí: OnDataSourceChanged metody a OnSchemaRefreshed . Obě tyto události lze dočasně zakázat metodou SuppressDataSourceEvents , která nastavuje SuppressingDataSourceEvents vlastnost. Metody událostí je možné znovu povolit pomocí ResumeDataSourceEvents metody .
Existují dvě statické metody, které můžete použít k vyhodnocení ekvivalence schémat nebo zobrazení bez vytvoření instance třídy:
Metoda SchemasEquivalent porovnává dvě schémata.
Metoda ViewSchemasEquivalent porovnává schémata dvou zobrazení.
Poznámky pro dědice
Chcete-li poskytnout příkazy pro nabídku seznamu akcí v době návrhu v odvozené třídě, je nutné přepsat ActionLists vlastnost vrátit vlastní DesignerActionListCollection objekt s vlastními položkami, které jsou odvozeny z objektu DesignerActionList .
Konstruktory
| DataSourceDesigner() |
Inicializuje novou instanci DataSourceDesigner třídy. |
Vlastnosti
| ActionLists |
Získá seznam položek, které se používají k vytvoření nabídky seznamu akcí v době návrhu. |
| AllowResize |
Získá hodnotu označující, zda lze změnit velikost ovládacího prvku v prostředí návrhu. (Zděděno od ControlDesigner) |
| AssociatedComponents |
Získá kolekci komponent přidružených k komponentě spravované návrhářem. (Zděděno od ComponentDesigner) |
| AutoFormats |
Získá kolekci předdefinovaných schémat automatického formátování, které se zobrazí v dialogovém okně Automatický formát pro přidružený ovládací prvek v době návrhu. (Zděděno od ControlDesigner) |
| Behavior |
Zastaralé.
Získá nebo nastaví chování DHTML, která je přidružena k návrháři. (Zděděno od HtmlControlDesigner) |
| CanConfigure |
Získá hodnotu označující, zda lze volat metodu Configure() . |
| CanRefreshSchema |
Získá hodnotu označující, zda lze volat metodu RefreshSchema(Boolean) . |
| Component |
Získá komponentu, která tento návrhář navrhuje. (Zděděno od ComponentDesigner) |
| DataBindings |
Získá kolekci datových vazeb pro aktuální ovládací prvek. (Zděděno od HtmlControlDesigner) |
| DataBindingsEnabled |
Získá hodnotu určující, zda je datová vazba podporována obsahující oblast pro přidružený ovládací prvek. (Zděděno od ControlDesigner) |
| DesignerState |
Získá objekt, který se používá k uchování dat pro přidružený ovládací prvek v době návrhu. (Zděděno od ControlDesigner) |
| DesignTimeElement |
Zastaralé.
Získá návrh-čas objekt představující ovládací prvek, který je přidružen k objektu HtmlControlDesigner na návrhové ploše. (Zděděno od HtmlControlDesigner) |
| DesignTimeElementView |
Zastaralé.
Získá objekt view-control pro návrhář ovládacího prvku. (Zděděno od ControlDesigner) |
| DesignTimeHtmlRequiresLoadComplete |
Zastaralé.
Získá hodnotu označující, zda návrhový hostitel musí dokončit načítání před volat metodu GetDesignTimeHtml . (Zděděno od ControlDesigner) |
| Expressions |
Získá vazby výrazu pro aktuální ovládací prvek v době návrhu. (Zděděno od HtmlControlDesigner) |
| HidePropertiesInTemplateMode |
Získá hodnotu určující, zda jsou vlastnosti přidruženého ovládacího prvku skryté, když je ovládací prvek v režimu šablony. (Zděděno od ControlDesigner) |
| ID |
Získá nebo nastaví řetězec ID ovládacího prvku. (Zděděno od ControlDesigner) |
| InheritanceAttribute |
Získá atribut, který označuje typ dědičnosti přidružené komponenty. (Zděděno od ComponentDesigner) |
| Inherited |
Získá hodnotu označující, zda je tato komponenta zděděna. (Zděděno od ComponentDesigner) |
| InTemplateMode |
Získá hodnotu označující, zda je ovládací prvek v režimu zobrazení šablony nebo úpravy v hostiteli návrhu. Vlastnost InTemplateMode je jen pro čtení. (Zděděno od ControlDesigner) |
| IsDirty |
Zastaralé.
Získá nebo nastaví hodnotu označující, zda byl ovládací prvek webového serveru označen jako změněn. (Zděděno od ControlDesigner) |
| ParentComponent |
Získá nadřazenou komponentu pro tohoto návrháře. (Zděděno od ComponentDesigner) |
| ReadOnly |
Zastaralé.
Získá nebo nastaví hodnotu označující, zda jsou vlastnosti ovládacího prvku jen pro čtení v době návrhu. (Zděděno od ControlDesigner) |
| RootDesigner |
Získá návrhář ovládacího prvku pro Web Forms stránku, která obsahuje přidružený ovládací prvek. (Zděděno od ControlDesigner) |
| SetTextualDefaultProperty |
Poskytuje podporu v době návrhu v hostiteli návrhu DataSourceControl pro třídu. (Zděděno od ComponentDesigner) |
| ShadowProperties |
Získá kolekci hodnot vlastností, které přepíší nastavení uživatele. (Zděděno od ComponentDesigner) |
| ShouldCodeSerialize |
Zastaralé.
Získá nebo nastaví hodnotu určující, zda vytvořit pole deklarace pro ovládací prvek v souboru kódu na pozadí aktuálního dokumentu návrhu během serializace. (Zděděno od HtmlControlDesigner) |
| SuppressingDataSourceEvents |
Získá hodnotu označující, zda dojde k DataSourceChanged události nebo RefreshSchema(Boolean) metodě. |
| Tag |
Získá objekt představující html značky element pro přidružený ovládací prvek. (Zděděno od ControlDesigner) |
| TemplateGroups |
Získá kolekci skupin šablon, z nichž každá obsahuje jednu nebo více definic šablon. (Zděděno od ControlDesigner) |
| UsePreviewControl |
Získá hodnotu označující, zda návrhář ovládacího prvku používá dočasný náhled ovládací prvek generovat kód HTML v době návrhu. (Zděděno od ControlDesigner) |
| Verbs |
Získá příkazy v době návrhu podporované komponentou, která je přidružena k návrháři. (Zděděno od ComponentDesigner) |
| ViewControl |
Získá nebo nastaví ovládací prvek webového serveru, který lze použít pro náhled kódu HTML v době návrhu. (Zděděno od ControlDesigner) |
| ViewControlCreated |
Získá nebo nastaví hodnotu označující, zda |
| Visible |
Získá hodnotu, která označuje, zda je ovládací prvek viditelný v době návrhu. (Zděděno od ControlDesigner) |
Metody
| Configure() |
Spustí nástroj pro konfiguraci zdroje dat v hostiteli návrhu. |
| CreateErrorDesignTimeHtml(String) |
Vytvoří kód HTML pro zobrazení zadané chybové zprávy v době návrhu. (Zděděno od ControlDesigner) |
| CreateErrorDesignTimeHtml(String, Exception) |
Vytvoří kód HTML, který zobrazí zadanou chybovou zprávu o výjimce v době návrhu. (Zděděno od ControlDesigner) |
| CreatePlaceHolderDesignTimeHtml() |
Poskytuje jednoduchou obdélníkovou zástupnou reprezentaci, která zobrazuje typ a ID ovládacího prvku. (Zděděno od ControlDesigner) |
| CreatePlaceHolderDesignTimeHtml(String) |
Poskytuje jednoduchou obdélníkovou zástupnou reprezentaci, která zobrazuje typ a ID ovládacího prvku a také další zadané pokyny nebo informace. (Zděděno od ControlDesigner) |
| CreateViewControl() |
Vrátí kopii přidruženého ovládacího prvku pro zobrazení nebo vykreslování na návrhové ploše. (Zděděno od ControlDesigner) |
| Dispose() |
Uvolní všechny prostředky používané nástrojem ComponentDesigner. (Zděděno od ComponentDesigner) |
| Dispose(Boolean) |
Uvolní nespravované prostředky, které objekt používá HtmlControlDesigner , a volitelně uvolní spravované prostředky. (Zděděno od HtmlControlDesigner) |
| DoDefaultAction() |
Vytvoří podpis metody v souboru zdrojového kódu pro výchozí událost v komponentě a přejde kurzor uživatele do daného umístění. (Zděděno od ComponentDesigner) |
| Equals(Object) |
Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object) |
| GetBounds() |
Načte souřadnice obdélníku představující hranice ovládacího prvku, jak je znázorněno na návrhové ploše. (Zděděno od ControlDesigner) |
| GetDesignTimeHtml() |
Načte kód HTML pro zobrazení přidruženého ovládacího prvku zdroje dat v době návrhu. |
| GetDesignTimeHtml(DesignerRegionCollection) |
Načte kód HTML pro zobrazení ovládacího prvku a naplní kolekci aktuálními oblastmi návrháře ovládacích prvků. (Zděděno od ControlDesigner) |
| GetEditableDesignerRegionContent(EditableDesignerRegion) |
Vrátí obsah pro upravitelnou oblast zobrazení v době návrhu přidruženého ovládacího prvku. (Zděděno od ControlDesigner) |
| GetEmptyDesignTimeHtml() |
Načte kód HTML představující ovládací prvek webového serveru v době návrhu, který nebude mít za běhu žádnou vizuální reprezentaci. (Zděděno od ControlDesigner) |
| GetErrorDesignTimeHtml(Exception) |
Načte kód HTML, který poskytuje informace o zadané výjimce. (Zděděno od ControlDesigner) |
| GetHashCode() |
Slouží jako výchozí hashovací funkce. (Zděděno od Object) |
| GetPersistenceContent() |
Načte trvalé vnitřní kódy HTML ovládacího prvku v době návrhu. (Zděděno od ControlDesigner) |
| GetPersistInnerHtml() |
Zastaralé.
Načte trvalé vnitřní značky HTML ovládacího prvku. (Zděděno od ControlDesigner) |
| GetService(Type) |
Pokusí se načíst zadaný typ služby z webu režimu návrhu komponenty návrháře. (Zděděno od ComponentDesigner) |
| GetType() |
Získá aktuální Type instanci. (Zděděno od Object) |
| GetView(String) |
Načte DesignerDataSourceView objekt, který je identifikován názvem zobrazení. |
| GetViewNames() |
Vrátí pole názvů zobrazení, které jsou k dispozici v tomto zdroji dat. |
| GetViewRendering() |
Načte objekt, který obsahuje značky v době návrhu pro obsah a oblasti přidruženého ovládacího prvku. (Zděděno od ControlDesigner) |
| Initialize(IComponent) |
Inicializuje návrhář ovládacího prvku a načte zadanou komponentu. (Zděděno od ControlDesigner) |
| InitializeExistingComponent(IDictionary) |
Znovu inicializuje existující komponentu. (Zděděno od ComponentDesigner) |
| InitializeNewComponent(IDictionary) |
Inicializuje nově vytvořenou komponentu. (Zděděno od ComponentDesigner) |
| InitializeNonDefault() |
Zastaralé.
Zastaralé.
Inicializuje nastavení pro importovanou komponentu, která je již inicializována do jiných než výchozích nastavení. (Zděděno od ComponentDesigner) |
| Invalidate() |
Zruší platnost celé oblasti ovládacího prvku, která je zobrazena na návrhové ploše, a signalizuje návrháři ovládacích prvků, aby ovládací prvek překreslil. (Zděděno od ControlDesigner) |
| Invalidate(Rectangle) |
Zruší platnost zadané oblasti ovládacího prvku, která je zobrazena na návrhové ploše, a signalizuje návrháři ovládacích prvků překreslit ovládací prvek. (Zděděno od ControlDesigner) |
| InvokeGetInheritanceAttribute(ComponentDesigner) |
Získá zadaný InheritanceAttribute .ComponentDesigner (Zděděno od ComponentDesigner) |
| IsPropertyBound(String) |
Zastaralé.
Načte hodnotu označující, zda je zadaná vlastnost přidruženého ovládacího prvku vázána na data. (Zděděno od ControlDesigner) |
| Localize(IDesignTimeResourceWriter) |
Použije zadaný zapisovač prostředků k zachování lokalizovatelných vlastností přidruženého ovládacího prvku pro prostředek v hostiteli návrhu. (Zděděno od ControlDesigner) |
| MemberwiseClone() |
Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object) |
| OnAutoFormatApplied(DesignerAutoFormat) |
Volá se, když je u přidruženého ovládacího prvku použito předdefinované schéma automatického formátování. (Zděděno od ControlDesigner) |
| OnBehaviorAttached() |
Volá se, když je návrhář ovládacího prvku připojen k objektu Behavior. (Zděděno od ControlDesigner) |
| OnBehaviorDetaching() |
Zastaralé.
Volá se, když se chování oddělí od elementu. (Zděděno od HtmlControlDesigner) |
| OnBindingsCollectionChanged(String) |
Zastaralé.
Volá se při změně kolekce datových vazeb. (Zděděno od ControlDesigner) |
| OnClick(DesignerRegionMouseEventArgs) |
Volá ho hostitel návrhu, když uživatel klikne na přidružený ovládací prvek v době návrhu. (Zděděno od ControlDesigner) |
| OnComponentChanged(Object, ComponentChangedEventArgs) |
Volá se při změně přidruženého ovládacího prvku. (Zděděno od ControlDesigner) |
| OnComponentChanging(Object, ComponentChangingEventArgs) |
Představuje metodu, která bude zpracovávat ComponentChanging událost přidruženého ovládacího prvku. (Zděděno od ControlDesigner) |
| OnControlResize() |
Zastaralé.
Volá se při změně velikosti přidruženého ovládacího prvku webového serveru v hostiteli návrhu v době návrhu. (Zděděno od ControlDesigner) |
| OnDataSourceChanged(EventArgs) |
Vyvolá událost, DataSourceChanged když se změní vlastnosti zdroje dat a SuppressingDataSourceEvents hodnota je |
| OnPaint(PaintEventArgs) |
Volá se, když návrhář ovládacího prvku nakreslí přidružený ovládací prvek na návrhové ploše, pokud CustomPaint je |
| OnSchemaRefreshed(EventArgs) |
Vyvolá událost, SchemaRefreshed když se změnilo schéma zdroje dat a SuppressingDataSourceEvents hodnota je |
| OnSetComponentDefaults() |
Zastaralé.
Zastaralé.
Nastaví výchozí vlastnosti komponenty. (Zděděno od ComponentDesigner) |
| OnSetParent() |
Poskytuje způsob, jak provést další zpracování, když je přidružený ovládací prvek připojen k nadřazený ovládací prvek. (Zděděno od HtmlControlDesigner) |
| PostFilterAttributes(IDictionary) |
Umožňuje návrháři změnit nebo odebrat položky ze sady atributů, které zveřejňuje prostřednictvím TypeDescriptor. (Zděděno od ComponentDesigner) |
| PostFilterEvents(IDictionary) |
Umožňuje návrháři změnit nebo odebrat položky ze sady událostí, které zveřejňuje prostřednictvím TypeDescriptor. (Zděděno od ComponentDesigner) |
| PostFilterProperties(IDictionary) |
Umožňuje návrháři změnit nebo odebrat položky ze sady vlastností, které zveřejňuje prostřednictvím TypeDescriptor. (Zděděno od ComponentDesigner) |
| PreFilterAttributes(IDictionary) |
Umožňuje návrháři přidat do sady atributů, které zveřejňuje prostřednictvím TypeDescriptor. (Zděděno od ComponentDesigner) |
| PreFilterEvents(IDictionary) |
Nastaví seznam událostí, které jsou vystaveny v době návrhu TypeDescriptor pro objekt pro komponentu. (Zděděno od HtmlControlDesigner) |
| PreFilterProperties(IDictionary) |
Přidá vlastnosti do nebo odebere vlastnosti z mřížky Vlastnosti v hostiteli návrhu v době návrhu nebo poskytne nové vlastnosti v době návrhu, které můžou odpovídat vlastnostem přidruženého ovládacího prvku. (Zděděno od ControlDesigner) |
| RaiseComponentChanged(MemberDescriptor, Object, Object) |
Oznámí, IComponentChangeService že tato komponenta byla změněna. (Zděděno od ComponentDesigner) |
| RaiseComponentChanging(MemberDescriptor) |
Upozorní, IComponentChangeService že se tato komponenta chystá ke změně. (Zděděno od ComponentDesigner) |
| RaiseResizeEvent() |
Zastaralé.
OnControlResize() Vyvolá událost. (Zděděno od ControlDesigner) |
| RefreshSchema(Boolean) |
Aktualizuje schéma ze zdroje dat a volitelně potlačí události. |
| RegisterClone(Object, Object) |
Registruje interní data v klonovaném ovládacím prvku. (Zděděno od ControlDesigner) |
| ResumeDataSourceEvents() |
Obnoví události zdroje dat po potlačení událostí zdroje dat. |
| SchemasEquivalent(IDataSourceSchema, IDataSourceSchema) |
Poskytuje hodnotu, která označuje, zda jsou dvě schémata rovna. |
| SetEditableDesignerRegionContent(EditableDesignerRegion, String) |
Určuje obsah pro upravitelnou oblast ovládacího prvku v době návrhu. (Zděděno od ControlDesigner) |
| SetRegionContent(EditableDesignerRegion, String) |
Určuje obsah pro upravitelnou oblast v zobrazení ovládacího prvku v době návrhu. (Zděděno od ControlDesigner) |
| SetViewFlags(ViewFlags, Boolean) |
Přiřadí zadaný bitový ViewFlags výčet zadané hodnotě příznaku. (Zděděno od ControlDesigner) |
| SuppressDataSourceEvents() |
Odloží všechny události zdroje dat až po zavolání ResumeDataSourceEvents() metody. |
| ToString() |
Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object) |
| UpdateDesignTimeHtml() |
Aktualizuje kód HTML v době návrhu pro přidružený ovládací prvek webového serveru voláním GetDesignTimeHtml metody. (Zděděno od ControlDesigner) |
| ViewSchemasEquivalent(IDataSourceViewSchema, IDataSourceViewSchema) |
Poskytuje hodnotu, která určuje, zda jsou dvě zobrazení schématu rovna. |
Událost
| DataSourceChanged |
Nastane, když se změní jakákoli vlastnost přidruženého zdroje dat. |
| SchemaRefreshed |
Nastane po aktualizaci schématu. |
Explicitní implementace rozhraní
Platí pro
Viz také
Váš názor
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu: https://aka.ms/ContentUserFeedback.
Odeslat a zobrazit názory pro