DataSourceDesigner Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Ofrece compatibilidad en tiempo de diseño en un host de diseño para la clase DataSourceControl.
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- Herencia
- Derivado
- Implementaciones
Ejemplos
En el ejemplo de código siguiente se muestra cómo usar un control de origen de datos personalizado con otras clases personalizadas pequeñas, como se muestra en la tabla siguiente.
| Clase personalizada | Derivado de |
|---|---|
CustomDataSource |
ObjectDataSource |
CustomDataSourceDesigner |
DataSourceDesigner |
CustomDataSourceView |
ObjectDataSourceView |
CustomDesignDataSourceView |
DesignerDataSourceView |
BookListViewSchema |
IDataSourceViewSchema |
CustomIDFieldSchema |
IDataSourceFieldSchema |
CustomTitleFieldSchema |
IDataSourceFieldSchema |
BookItem (Estructura de datos de dos campos). |
Después de compilar el ejemplo de código, abra la página .aspx en la vista Diseño y establezca la DataSourceID propiedad en el identificador del control de origen de datos personalizado.
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>
Comentarios
La DataSourceDesigner clase es la clase base para los diseñadores de orígenes de datos, como las SqlDataSourceDesignerclases , AccessDataSourceDesignery ObjectDataSourceDesigner . Si crea un nuevo control de origen de datos, es posible que también quiera crear un diseñador de controles personalizado para el control y derivarlo de la DataSourceDesigner clase .
La DataSourceDesigner clase tiene dos métodos de evento: los OnDataSourceChanged métodos y OnSchemaRefreshed . Ambos eventos se pueden deshabilitar temporalmente con el SuppressDataSourceEvents método , que establece la SuppressingDataSourceEvents propiedad . Los métodos de evento se pueden volver a habilitar con el ResumeDataSourceEvents método .
Hay dos métodos estáticos que puede usar para evaluar la equivalencia de esquemas o vistas sin crear una instancia de la clase :
El SchemasEquivalent método compara dos esquemas.
El ViewSchemasEquivalent método compara los esquemas de dos vistas.
Notas a los desarrolladores de herederos
Para proporcionar comandos para el menú de lista de acciones en tiempo de diseño en una clase derivada, debe invalidar la ActionLists propiedad para devolver un objeto personalizado con elementos personalizados DesignerActionListCollection derivados del DesignerActionList objeto .
Constructores
| DataSourceDesigner() |
Inicializa una nueva instancia de la clase DataSourceDesigner. |
Propiedades
| ActionLists |
Obtiene una lista de elementos que se usa para crear un menú de lista de acciones en tiempo de diseño. |
| AllowResize |
Obtiene un valor que indica si se puede cambiar el tamaño del control en el entorno en tiempo de diseño. (Heredado de ControlDesigner) |
| AssociatedComponents |
Obtiene la colección de componentes asociados al componente administrado por el diseñador. (Heredado de ComponentDesigner) |
| AutoFormats |
Obtiene la colección de esquemas de formato automático predefinidos para mostrarla en tiempo de diseño en el cuadro de diálogo Formato automático correspondiente al control asociado. (Heredado de ControlDesigner) |
| Behavior |
Obsoletos.
Obtiene o establece el comportamiento DHTML asociado al diseñador. (Heredado de HtmlControlDesigner) |
| CanConfigure |
Obtiene un valor que indica si se puede llamar al método Configure(). |
| CanRefreshSchema |
Obtiene un valor que indica si se puede llamar al método RefreshSchema(Boolean). |
| Component |
Obtiene el componente que el diseñador está creando. (Heredado de ComponentDesigner) |
| DataBindings |
Obtiene la colección de enlaces de datos del control actual. (Heredado de HtmlControlDesigner) |
| DataBindingsEnabled |
Obtiene un valor que indica si la región contenedora del control asociado permite el enlace a datos. (Heredado de ControlDesigner) |
| DesignerState |
Obtiene un objeto que se utiliza para guardar los datos del control asociado en tiempo de diseño. (Heredado de ControlDesigner) |
| DesignTimeElement |
Obsoletos.
Obtiene el objeto en tiempo de diseño que representa el control asociado al objeto HtmlControlDesigner en la superficie de diseño. (Heredado de HtmlControlDesigner) |
| DesignTimeElementView |
Obsoletos.
Obtiene el objeto de control de vista para el diseñador de controles. (Heredado de ControlDesigner) |
| DesignTimeHtmlRequiresLoadComplete |
Obsoletos.
Obtiene un valor que indica si el host de diseño debe terminar de cargarse antes de que se pueda llamar al método GetDesignTimeHtml. (Heredado de ControlDesigner) |
| Expressions |
Obtiene los enlaces de expresión en tiempo de diseño para el control actual. (Heredado de HtmlControlDesigner) |
| HidePropertiesInTemplateMode |
Obtiene un valor que indica si las propiedades del control asociado están ocultas cuando el control está en modo de plantilla. (Heredado de ControlDesigner) |
| ID |
Obtiene o establece la cadena del identificador del control. (Heredado de ControlDesigner) |
| InheritanceAttribute |
Obtiene un atributo que indica el tipo de herencia del componente asociado. (Heredado de ComponentDesigner) |
| Inherited |
Obtiene un valor que indica si este componente es heredado. (Heredado de ComponentDesigner) |
| InTemplateMode |
Obtiene un valor que indica si el control está en el modo de vista o de edición de plantilla en el host de diseño. La propiedad InTemplateMode es de sólo lectura. (Heredado de ControlDesigner) |
| IsDirty |
Obsoletos.
Obtiene o establece un valor que indica si el control de servidor Web se ha marcado como modificado. (Heredado de ControlDesigner) |
| ParentComponent |
Obtiene el componente primario de este diseñador. (Heredado de ComponentDesigner) |
| ReadOnly |
Obsoletos.
Obtiene o establece un valor que indica si las propiedades del control son de sólo lectura en tiempo de diseño. (Heredado de ControlDesigner) |
| RootDesigner |
Obtiene el diseñador de controles para la página de formularios Web Forms que contiene el control asociado. (Heredado de ControlDesigner) |
| SetTextualDefaultProperty |
Ofrece compatibilidad en tiempo de diseño en un host de diseño para la clase DataSourceControl. (Heredado de ComponentDesigner) |
| ShadowProperties |
Obtiene una colección de valores de propiedad que reemplazan la configuración del usuario. (Heredado de ComponentDesigner) |
| ShouldCodeSerialize |
Obsoletos.
Obtiene o establece un valor que indica si se debe crear una declaración de campo para el control en el archivo de código subyacente para el documento de diseño actual durante la serialización. (Heredado de HtmlControlDesigner) |
| SuppressingDataSourceEvents |
Obtiene un valor que indica si se produce el evento DataSourceChanged o el método RefreshSchema(Boolean). |
| Tag |
Obtiene un objeto que representa el elemento de formato HTML del control asociado. (Heredado de ControlDesigner) |
| TemplateGroups |
Obtiene una colección de grupos de plantillas, cada una con una o varias definiciones de plantilla. (Heredado de ControlDesigner) |
| UsePreviewControl |
Obtiene un valor que indica si el diseñador de control utiliza un control de vista previa temporal para generar el marcado HTML en tiempo de diseño. (Heredado de ControlDesigner) |
| Verbs |
Obtiene los verbos en tiempo de diseño que admite el componente asociado al diseñador. (Heredado de ComponentDesigner) |
| ViewControl |
Obtiene o establece un control de servidor Web que se puede utilizar para ofrecer una vista previa del formato HTML en tiempo de diseño. (Heredado de ControlDesigner) |
| ViewControlCreated |
Obtiene o establece un valor que indica si se ha creado un control |
| Visible |
Obtiene un valor que indica si el control está visible en tiempo de diseño. (Heredado de ControlDesigner) |
Métodos
| Configure() |
Inicia la utilidad de configuración de orígenes de datos en el host de diseño. |
| CreateErrorDesignTimeHtml(String) |
Crea el formato HTML para mostrar un mensaje de error especificado en tiempo de diseño. (Heredado de ControlDesigner) |
| CreateErrorDesignTimeHtml(String, Exception) |
Crea el formato HTML para mostrar un mensaje de error de excepción especificado en tiempo de diseño. (Heredado de ControlDesigner) |
| CreatePlaceHolderDesignTimeHtml() |
Proporciona una representación sencilla del marcador de posición rectangular que muestra el tipo y el Id. del control. (Heredado de ControlDesigner) |
| CreatePlaceHolderDesignTimeHtml(String) |
Proporciona una representación sencilla del marcador de posición rectangular que muestra el tipo y el Id. del control, así como instrucciones o información adicionales que se hayan especificado. (Heredado de ControlDesigner) |
| CreateViewControl() |
Devuelve una copia del control asociado para verlo o representarlo en la superficie de diseño. (Heredado de ControlDesigner) |
| Dispose() |
Libera todos los recursos que usa ComponentDesigner. (Heredado de ComponentDesigner) |
| Dispose(Boolean) |
Libera los recursos no administrados utilizados por el objeto HtmlControlDesigner y, de forma opcional, libera los recursos administrados. (Heredado de HtmlControlDesigner) |
| DoDefaultAction() |
Crea una firma de método en el archivo de código fuente para el evento predeterminado del componente y hace navegar el cursor del usuario en esa ubicación. (Heredado de ComponentDesigner) |
| Equals(Object) |
Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object) |
| GetBounds() |
Recupera las coordenadas del rectángulo que representa los límites del control mostrado en la superficie de diseño. (Heredado de ControlDesigner) |
| GetDesignTimeHtml() |
Recupera el formato HTML que se usa para mostrar el control de origen de datos asociado en tiempo de diseño. |
| GetDesignTimeHtml(DesignerRegionCollection) |
Recupera el formato HTML para mostrar el control y rellena la colección con las regiones actuales del diseñador de controles. (Heredado de ControlDesigner) |
| GetEditableDesignerRegionContent(EditableDesignerRegion) |
Devuelve el contenido de una región modificable de la vista en tiempo de diseño del control asociado. (Heredado de ControlDesigner) |
| GetEmptyDesignTimeHtml() |
Recupera el formato HTML para presentar un control de servidor web en tiempo de diseño que no tendrá ninguna representación visual en tiempo de ejecución. (Heredado de ControlDesigner) |
| GetErrorDesignTimeHtml(Exception) |
Recupera el formato HTML que proporciona información sobre la excepción especificada. (Heredado de ControlDesigner) |
| GetHashCode() |
Sirve como la función hash predeterminada. (Heredado de Object) |
| GetPersistenceContent() |
Recupera el formato HTML interno con persistencia del control en tiempo de diseño. (Heredado de ControlDesigner) |
| GetPersistInnerHtml() |
Obsoletos.
Recupera el formato HTML interno con persistencia del control. (Heredado de ControlDesigner) |
| GetService(Type) |
Intenta recuperar el tipo de servicio especificado del sitio en modo de diseño del componente del diseñador. (Heredado de ComponentDesigner) |
| GetType() |
Obtiene el Type de la instancia actual. (Heredado de Object) |
| GetView(String) |
Recupera un objeto DesignerDataSourceView identificado por el nombre de vista. |
| GetViewNames() |
Devuelve una matriz de los nombres de vista disponibles en este origen de datos. |
| GetViewRendering() |
Recupera un objeto que contiene el formato en tiempo de diseño para el contenido y las regiones del control asociado. (Heredado de ControlDesigner) |
| Initialize(IComponent) |
Inicializa el diseñador de controles y carga el componente especificado. (Heredado de ControlDesigner) |
| InitializeExistingComponent(IDictionary) |
Reinicializa un componente existente. (Heredado de ComponentDesigner) |
| InitializeNewComponent(IDictionary) |
Inicializa un componente recién creado. (Heredado de ComponentDesigner) |
| InitializeNonDefault() |
Obsoletos.
Obsoletos.
Inicializa la configuración de un componente importado que ya se ha inicializado con una configuración que no es la predeterminada. (Heredado de ComponentDesigner) |
| Invalidate() |
Invalida todo el área del control que se muestra en la superficie de diseño y señala al diseñador de controles que vuelva a dibujar el control. (Heredado de ControlDesigner) |
| Invalidate(Rectangle) |
Invalida el área especificada del control que se muestra en la superficie de diseño y señala al diseñador de controles que vuelva a dibujar el control. (Heredado de ControlDesigner) |
| InvokeGetInheritanceAttribute(ComponentDesigner) |
Obtiene el objeto InheritanceAttribute de la enumeración ComponentDesigner especificada. (Heredado de ComponentDesigner) |
| IsPropertyBound(String) |
Obsoletos.
Recupera un valor que indica si la propiedad especificada en el control asociado está enlazada a datos o no. (Heredado de ControlDesigner) |
| Localize(IDesignTimeResourceWriter) |
Utiliza el sistema de escritura de recursos proporcionado para conservar las propiedades adaptables del control asociado en un recurso en el host de diseño. (Heredado de ControlDesigner) |
| MemberwiseClone() |
Crea una copia superficial del Object actual. (Heredado de Object) |
| OnAutoFormatApplied(DesignerAutoFormat) |
Se le llama cuando se ha aplicado un esquema de formato automático predefinido al control asociado. (Heredado de ControlDesigner) |
| OnBehaviorAttached() |
Se llama cuando el diseñador de controles está asociado a un objeto Behavior. (Heredado de ControlDesigner) |
| OnBehaviorDetaching() |
Obsoletos.
Se le llama cuando se anula la asociación de un comportamiento al elemento. (Heredado de HtmlControlDesigner) |
| OnBindingsCollectionChanged(String) |
Obsoletos.
Se le llama cuando cambia la colección de enlace a datos. (Heredado de ControlDesigner) |
| OnClick(DesignerRegionMouseEventArgs) |
Lo llama el host de diseño cuando el usuario hace clic en el control asociado en tiempo de diseño. (Heredado de ControlDesigner) |
| OnComponentChanged(Object, ComponentChangedEventArgs) |
Se le llama cuando cambia el control asociado. (Heredado de ControlDesigner) |
| OnComponentChanging(Object, ComponentChangingEventArgs) |
Representa el método que controlará el evento ComponentChanging del control asociado. (Heredado de ControlDesigner) |
| OnControlResize() |
Obsoletos.
Se le llama cuando el control de servidor Web asociado ha cambiado de tamaño en tiempo de diseño en el host de diseño. (Heredado de ControlDesigner) |
| OnDataSourceChanged(EventArgs) |
Provoca el evento DataSourceChanged cuando las propiedades del origen de datos han cambiado y el valor de la propiedad SuppressingDataSourceEvents es |
| OnPaint(PaintEventArgs) |
Se le llama cuando el diseñador de controles dibuja el control asociado en la superficie de diseño, si el valor CustomPaint es |
| OnSchemaRefreshed(EventArgs) |
Provoca el evento SchemaRefreshed cuando el esquema del origen de datos ha cambiado y el valor de la propiedad SuppressingDataSourceEvents es |
| OnSetComponentDefaults() |
Obsoletos.
Obsoletos.
Establece las propiedades predeterminadas del componente. (Heredado de ComponentDesigner) |
| OnSetParent() |
Proporciona una manera de realizar el procesamiento adicional cuando el control asociado se asocia a un control primario. (Heredado de HtmlControlDesigner) |
| PostFilterAttributes(IDictionary) |
Permite a un diseñador cambiar o quitar elementos en el conjunto de atributos que expone mediante un TypeDescriptor. (Heredado de ComponentDesigner) |
| PostFilterEvents(IDictionary) |
Permite a un diseñador cambiar o quitar elementos del conjunto de eventos que expone mediante un objeto TypeDescriptor. (Heredado de ComponentDesigner) |
| PostFilterProperties(IDictionary) |
Permite a un diseñador cambiar o quitar elementos del conjunto de propiedades que expone mediante un objeto TypeDescriptor. (Heredado de ComponentDesigner) |
| PreFilterAttributes(IDictionary) |
Permite a un diseñador agregar elementos al conjunto de atributos que expone mediante un objeto TypeDescriptor. (Heredado de ComponentDesigner) |
| PreFilterEvents(IDictionary) |
Establece la lista de eventos que se exponen en tiempo de diseño para el objeto TypeDescriptor para el componente. (Heredado de HtmlControlDesigner) |
| PreFilterProperties(IDictionary) |
Agrega propiedades o quita propiedades de la cuadrícula Propiedades en un host de diseño en tiempo de diseño, o proporciona nuevas propiedades en tiempo de diseño que pueden corresponderse con las propiedades del control asociado. (Heredado de ControlDesigner) |
| RaiseComponentChanged(MemberDescriptor, Object, Object) |
Notifica a IComponentChangeService que este componente se ha cambiado. (Heredado de ComponentDesigner) |
| RaiseComponentChanging(MemberDescriptor) |
Notifica a IComponentChangeService que este componente se va a cambiar. (Heredado de ComponentDesigner) |
| RaiseResizeEvent() |
Obsoletos.
Genera el evento OnControlResize(). (Heredado de ControlDesigner) |
| RefreshSchema(Boolean) |
Actualiza el esquema de origen de datos, suprimiendo opcionalmente los eventos. |
| RegisterClone(Object, Object) |
Registra los datos internos en un control clonado. (Heredado de ControlDesigner) |
| ResumeDataSourceEvents() |
Restaura los eventos del origen de datos después de que se hayan suprimido. |
| SchemasEquivalent(IDataSourceSchema, IDataSourceSchema) |
Proporciona un valor que indica si los dos esquemas son iguales. |
| SetEditableDesignerRegionContent(EditableDesignerRegion, String) |
Especifica el contenido de una región modificable del control en tiempo de diseño. (Heredado de ControlDesigner) |
| SetRegionContent(EditableDesignerRegion, String) |
Especifica el contenido de una región modificable en la vista en tiempo de diseño del control. (Heredado de ControlDesigner) |
| SetViewFlags(ViewFlags, Boolean) |
Asigna la enumeración ViewFlags bit a bit especificada al valor de marcador especificado. (Heredado de ControlDesigner) |
| SuppressDataSourceEvents() |
Pospone todos los eventos del origen de datos hasta después de que se haya llamado al método ResumeDataSourceEvents(). |
| ToString() |
Devuelve una cadena que representa el objeto actual. (Heredado de Object) |
| UpdateDesignTimeHtml() |
Actualiza el formato HTML en tiempo de diseño para el control de servidor Web asociado llamando al método GetDesignTimeHtml. (Heredado de ControlDesigner) |
| ViewSchemasEquivalent(IDataSourceViewSchema, IDataSourceViewSchema) |
Proporciona un valor que determina si las dos vista del esquema son iguales. |
Eventos
| DataSourceChanged |
Tiene lugar cuando cambia alguna propiedad del origen de datos asociado. |
| SchemaRefreshed |
Tiene lugar una vez que se ha actualizado el esquema. |
Implementaciones de interfaz explícitas
Se aplica a
Consulte también
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de