AccessDataSourceDesigner Classe

Definizione

Offre supporto in fase di progettazione all'interno di una finestra di progettazione visiva per il controllo server Web AccessDataSource.

public ref class AccessDataSourceDesigner : System::Web::UI::Design::WebControls::SqlDataSourceDesigner
public class AccessDataSourceDesigner : System.Web.UI.Design.WebControls.SqlDataSourceDesigner
type AccessDataSourceDesigner = class
    inherit SqlDataSourceDesigner
Public Class AccessDataSourceDesigner
Inherits SqlDataSourceDesigner
Ereditarietà

Esempio

Questa sezione fornisce due esempi di codice. La prima illustra come estendere la AccessDataSourceDesigner classe. Il secondo illustra come derivare una copia della AccessDataSource classe e associarla a una finestra di progettazione.

Nell'esempio di codice seguente viene illustrato come estendere la AccessDataSourceDesigner classe. Il codice modifica il segnaposto che rappresenta il controllo nell'area di progettazione e aggiunge una proprietà alla griglia Proprietà .

// Shadow control properties with design time properties.
protected override void PreFilterProperties(IDictionary properties)
{
    // Call the base class method first.
    base.PreFilterProperties(properties);

    // Add the ConnectionString property to the property grid.
    PropertyDescriptor property =
        (PropertyDescriptor)properties["ConnectionString"];
    Attribute[] attributes = new Attribute[]
    {
        new BrowsableAttribute(true),
        new ReadOnlyAttribute(true)
    };
    properties["ConnectionString"] = TypeDescriptor.CreateProperty(
        GetType(), property, attributes);
}
' Shadow control properties with design time properties.
Protected Overrides Sub PreFilterProperties(ByVal properties As IDictionary)

    ' Call the base class method first.
    MyBase.PreFilterProperties(properties)

    ' Add the ConnectionString property to the property grid.
    Dim prop As PropertyDescriptor
    prop = CType(properties("ConnectionString"), PropertyDescriptor)

   Dim atts(1) As Attribute
    atts(0) = New BrowsableAttribute(True)
    atts(1) = New ReadOnlyAttribute(True)

    properties("ConnectionString") = TypeDescriptor.CreateProperty( _
        prop.GetType(), prop, atts)
End Sub

Nell'esempio AccessDataSource di codice seguente viene illustrato come derivare una copia della classe e associarla alla finestra di progettazione definita nell'esempio precedente.

// Create a control and bind it to the ExampleAccessDataSourceDesigner.
[AspNetHostingPermission(System.Security.Permissions.SecurityAction.Demand,
    Level = AspNetHostingPermissionLevel.Minimal)]
[AspNetHostingPermission(System.Security.Permissions.SecurityAction.InheritanceDemand,
    Level = AspNetHostingPermissionLevel.Minimal)]
[Designer(typeof(CustomControls.Design.ExampleAccessDataSourceDesigner))]
public class ExampleAccessDataSource : AccessDataSource
{
    // Does nothing extra
}
' Create a control and bind it to the ExampleAccessDataSourceDesigner.
<AspNetHostingPermission(System.Security.Permissions.SecurityAction.Demand, _
    Level:=System.Web.AspNetHostingPermissionLevel.Minimal)> _
<AspNetHostingPermission(System.Security.Permissions.SecurityAction.InheritanceDemand, _
    Level:=System.Web.AspNetHostingPermissionLevel.Minimal)> _
<Designer("CustomControls.Design.ExampleAccessDataSourceDesigner")> _
Public Class ExampleAccessDataSource
    Inherits AccessDataSource

    ' Does nothing extra
End Class

Commenti

In una finestra di progettazione visiva, quando si passa dalla visualizzazione Origine a Progettazione, il codice sorgente di markup che descrive il AccessDataSource controllo viene analizzato e una versione in fase di progettazione del controllo, che è solo un segnaposto, viene creata nell'area di progettazione. Quando si torna alla visualizzazione Origine, il controllo tempo di progettazione, che include i valori delle proprietà nella griglia Proprietà , viene mantenuto nel codice sorgente di markup e modificato nel markup per la pagina Web.

Costruttori

AccessDataSourceDesigner()

Inizializza una nuova istanza della classe AccessDataSource.

Proprietà

ActionLists

Ottiene un elenco delle voci utilizzate per creare un menu dell'elenco di azioni in fase di progettazione.

(Ereditato da DataSourceDesigner)
AllowResize

Ottiene un valore che indica se è possibile ridimensionare il controllo nell'ambiente Design-Time.

(Ereditato da ControlDesigner)
AssociatedComponents

Ottiene l'insieme dei componenti associati al componente gestito dalla finestra di progettazione.

(Ereditato da ComponentDesigner)
AutoFormats

Ottiene la raccolta degli schemi di formattazione automatica predefiniti da visualizzare nella finestra di dialogo Formattazione automatica per il controllo associato in fase di progettazione.

(Ereditato da ControlDesigner)
Behavior
Obsoleti.

Ottiene o imposta il comportamento DHTML associato alla finestra di progettazione.

(Ereditato da HtmlControlDesigner)
CanConfigure

Ottiene un valore che indica se il metodo Configure() può essere chiamato dall'host di progettazione.

(Ereditato da SqlDataSourceDesigner)
CanRefreshSchema

Ottiene un valore che indica se il metodo RefreshSchema(Boolean) può essere chiamato dall'host di progettazione.

(Ereditato da SqlDataSourceDesigner)
Component

Ottiene il componente progettato dalla finestra di progettazione.

(Ereditato da ComponentDesigner)
ConnectionString

Ottiene o imposta la stringa usata per aprire un database.

(Ereditato da SqlDataSourceDesigner)
DataBindings

Ottiene l'insieme di associazioni dati per il controllo corrente.

(Ereditato da HtmlControlDesigner)
DataBindingsEnabled

Ottiene un valore che indica se l'area contenitore per il controllo controllo associato supporta l'associazione di dati.

(Ereditato da ControlDesigner)
DataFile

Consente di implementare una proprietà della finestra di progettazione per nascondere la proprietà DataFile del controllo associato.

DeleteQuery

Ottiene o imposta SqlDataSourceDesigner che supporta le query di eliminazione.

(Ereditato da SqlDataSourceDesigner)
DesignerState

Ottiene un oggetto utilizzato per rendere persistenti i dati per il controllo associato in fase di progettazione.

(Ereditato da ControlDesigner)
DesignTimeElement
Obsoleti.

Ottiene l'oggetto in fase di progettazione che rappresenta il controllo associato all'oggetto HtmlControlDesigner sull'area di progettazione.

(Ereditato da HtmlControlDesigner)
DesignTimeElementView
Obsoleti.

Ottiene l'oggetto di controllo di visualizzazione per la finestra di progettazione.

(Ereditato da ControlDesigner)
DesignTimeHtmlRequiresLoadComplete
Obsoleti.

Ottiene un valore che indica se l'host di progettazione deve terminare il caricamento prima di poter chiamare il metodo GetDesignTimeHtml.

(Ereditato da ControlDesigner)
Expressions

Ottiene le associazioni di espressioni per il controllo corrente in fase di progettazione.

(Ereditato da HtmlControlDesigner)
HidePropertiesInTemplateMode

Ottiene un valore che indica se le proprietà del controllo associato sono nascoste quando per il controllo è attiva la modalità modello.

(Ereditato da ControlDesigner)
ID

Ottiene o imposta a stringa ID per il controllo.

(Ereditato da ControlDesigner)
InheritanceAttribute

Ottiene un attributo che indica il tipo di ereditarietà del componente associato.

(Ereditato da ComponentDesigner)
Inherited

Ottiene un valore che indica se questo componente è ereditato.

(Ereditato da ComponentDesigner)
InsertQuery

Ottiene o imposta SqlDataSourceDesigner che supporta le query di inserimento.

(Ereditato da SqlDataSourceDesigner)
InTemplateMode

Ottiene un valore che indica se il controllo è in modalità di visualizzazione o modifica del modello in un host di progettazione. La proprietà InTemplateMode è di sola lettura.

(Ereditato da ControlDesigner)
IsDirty
Obsoleti.

Ottiene o imposta un valore che indica se il controllo server Web è stato contrassegnato come modificato.

(Ereditato da ControlDesigner)
ParentComponent

Ottiene il componente padre per la finestra di progettazione.

(Ereditato da ComponentDesigner)
ProviderName

Ottiene o imposta il nome del provider di dati .NET Framework usato dal controllo SqlDataSource associato per la connessione a un'origine dati sottostante.

(Ereditato da SqlDataSourceDesigner)
ReadOnly
Obsoleti.

Ottiene o imposta un valore che indica se le proprietà del controllo sono in sola lettura in fase di progettazione.

(Ereditato da ControlDesigner)
RootDesigner

Ottiene la finestra di progettazione di controlli per la pagina del Web Form contenente il controllo associato.

(Ereditato da ControlDesigner)
SelectCommand

Ottiene o imposta la query SQL nell'oggetto SqlDataSource associato per selezionare dati dal database sottostante.

(Ereditato da SqlDataSourceDesigner)
SelectQuery

Ottiene o imposta SqlDataSourceDesigner che supporta le query di selezione.

(Ereditato da SqlDataSourceDesigner)
SetTextualDefaultProperty

Offre supporto in fase di progettazione all'interno di una finestra di progettazione visiva per il controllo server Web AccessDataSource.

(Ereditato da ComponentDesigner)
ShadowProperties

Ottiene un insieme di valori di proprietà che eseguono l'override delle impostazioni utente.

(Ereditato da ComponentDesigner)
ShouldCodeSerialize
Obsoleti.

Ottiene o imposta un valore che indica se durante la serializzazione deve essere creata una dichiarazione di campo per il controllo nel file code-behind, per il documento di progettazione corrente.

(Ereditato da HtmlControlDesigner)
SuppressingDataSourceEvents

Ottiene un valore che indica se si verifica l'evento DataSourceChanged o il metodo RefreshSchema(Boolean).

(Ereditato da DataSourceDesigner)
Tag

Ottiene un oggetto che rappresenta l'elemento del markup HTML per il controllo associato.

(Ereditato da ControlDesigner)
TemplateGroups

Ottiene una raccolta di gruppi di modelli, ognuno contenente una o più definizioni di modello.

(Ereditato da ControlDesigner)
UpdateQuery

Ottiene o imposta SqlDataSourceDesigner che supporta le query di aggiornamento.

(Ereditato da SqlDataSourceDesigner)
UsePreviewControl

Ottiene un valore che indica se la finestra di progettazione controlli usa un controllo di anteprima temporaneo per generare il markup HTML in fase di progettazione.

(Ereditato da ControlDesigner)
Verbs

Ottiene i verbi in fase di progettazione supportati dal componente associato alla finestra di progettazione.

(Ereditato da ComponentDesigner)
ViewControl

Ottiene o imposta un controllo server Web che può essere utilizzato per visualizzare in anteprima il markup HTML Design-Time.

(Ereditato da ControlDesigner)
ViewControlCreated

Ottiene o imposta un valore che indica se il controllo View è stato creato per la visualizzazione nell'area di progettazione.

(Ereditato da ControlDesigner)
Visible

Ottiene un valore che indica se il controllo è visibile in fase di progettazione.

(Ereditato da ControlDesigner)

Metodi

Configure()

Avvia l'utilità di configurazione dell'origine dati nell'host di progettazione.

(Ereditato da SqlDataSourceDesigner)
CreateErrorDesignTimeHtml(String)

Crea il markup HTML per visualizzare un messaggio di errore specificato in fase di progettazione.

(Ereditato da ControlDesigner)
CreateErrorDesignTimeHtml(String, Exception)

Crea il markup HTML per visualizzare un messaggio di errore di eccezione specificato in fase di progettazione.

(Ereditato da ControlDesigner)
CreatePlaceHolderDesignTimeHtml()

Fornisce una rappresentazione del segnaposto rettangolare semplice che visualizza il tipo e l'ID del controllo.

(Ereditato da ControlDesigner)
CreatePlaceHolderDesignTimeHtml(String)

Fornisce una rappresentazione del segnaposto rettangolare semplice che visualizza il tipo e l'ID del controllo e le istruzioni o le informazioni aggiuntive specificate.

(Ereditato da ControlDesigner)
CreateView(String)

Crea una nuova istanza dell'oggetto SqlDesignerDataSourceView usando il nome specificato.

(Ereditato da SqlDataSourceDesigner)
CreateViewControl()

Restituisce una copia del controllo associato per la visualizzazione o il rendering nell'area di progettazione.

(Ereditato da ControlDesigner)
DeriveParameters(String, DbCommand)

Deriva i parametri dal comando SQL specificato e aggiunge oggetti Parameter corrispondenti alla raccolta di parametri del comando.

(Ereditato da SqlDataSourceDesigner)
Dispose()

Rilascia tutte le risorse usate da ComponentDesigner.

(Ereditato da ComponentDesigner)
Dispose(Boolean)

Rilascia le risorse non gestite usate dall'oggetto HtmlControlDesigner ed eventualmente le risorse gestite.

(Ereditato da HtmlControlDesigner)
DoDefaultAction()

Crea una firma di metodo nel file di codice sorgente per l'evento predefinito sul componente e sposta il cursore dell'utente in tale posizione.

(Ereditato da ComponentDesigner)
Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.

(Ereditato da Object)
GetBounds()

Recupera le coordinate del rettangolo che rappresenta i limiti del controllo come visualizzato nell'area di progettazione.

(Ereditato da ControlDesigner)
GetConnectionString()

Ottiene la stringa di connessione valida, durante la fase di progettazione, per il controllo associato alla finestra di progettazione.

GetDesignTimeHtml()

Recupera il markup HTML per la visualizzazione del controllo dell'origine dati associata in fase di progettazione.

(Ereditato da DataSourceDesigner)
GetDesignTimeHtml(DesignerRegionCollection)

Recupera il markup HTML per la visualizzazione del controllo e popola la raccolta con le aree della finestra di progettazione controlli correnti.

(Ereditato da ControlDesigner)
GetEditableDesignerRegionContent(EditableDesignerRegion)

Restituisce il contenuto per un'area modificabile della visualizzazione Design-Time del controllo associato.

(Ereditato da ControlDesigner)
GetEmptyDesignTimeHtml()

Recupera il markup HTML per rappresentare un controllo server Web in fase di progettazione che non avrà rappresentazione visiva in fase di esecuzione.

(Ereditato da ControlDesigner)
GetErrorDesignTimeHtml(Exception)

Recupera il markup HTML che fornisce informazioni sull'eccezione specificata.

(Ereditato da ControlDesigner)
GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetPersistenceContent()

Recupera il markup HTML interno persistente del controllo in fase di progettazione.

(Ereditato da ControlDesigner)
GetPersistInnerHtml()
Obsoleti.

Recupera il markup HTML interno persistente del controllo.

(Ereditato da ControlDesigner)
GetService(Type)

Esegue un tentativo di recuperare il tipo di servizio specificato dal sito della modalità progettazione del componente della finestra di progettazione.

(Ereditato da ComponentDesigner)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.

(Ereditato da Object)
GetView(String)

Recupera un oggetto DesignerDataSourceView identificato dal nome della visualizzazione.

(Ereditato da SqlDataSourceDesigner)
GetViewNames()

Ottiene un elenco delle visualizzazioni disponibili.

(Ereditato da SqlDataSourceDesigner)
GetViewRendering()

Recupera un oggetto contenente il markup Design-Time per il contenuto e le aree del controllo associato.

(Ereditato da ControlDesigner)
InferParameterNames(DesignerDataConnection, String, SqlDataSourceCommandType)

Restituisce una matrice di parametri usando la connessione, il testo e il tipo di comando specificati.

(Ereditato da SqlDataSourceDesigner)
Initialize(IComponent)

Inizializza la finestra di progettazione di controlli e carica il componente specificato.

(Ereditato da ControlDesigner)
InitializeExistingComponent(IDictionary)

Reinizializza un componente esistente.

(Ereditato da ComponentDesigner)
InitializeNewComponent(IDictionary)

Inizializza un nuovo componente creato.

(Ereditato da ComponentDesigner)
InitializeNonDefault()
Obsoleti.
Obsoleti.

Inizializza le impostazioni relative a un componente importato già inizializzato per impostazioni diverse da quelle predefinite.

(Ereditato da ComponentDesigner)
Invalidate()

Invalida l'intera area del controllo visualizzato nell'area di progettazione e comunica alla finestra di progettazione di controlli di ricreare il controllo.

(Ereditato da ControlDesigner)
Invalidate(Rectangle)

Invalida l'area specificata del controllo visualizzato nell'area di progettazione e comunica alla finestra di progettazione di controlli di ricreare il controllo.

(Ereditato da ControlDesigner)
InvokeGetInheritanceAttribute(ComponentDesigner)

Ottiene l'oggetto InheritanceAttribute dell'oggetto ComponentDesigner specificato.

(Ereditato da ComponentDesigner)
IsPropertyBound(String)
Obsoleti.

Recupera un valore che indica se la proprietà specificata sul controllo associato prevede l'associazione a dati.

(Ereditato da ControlDesigner)
Localize(IDesignTimeResourceWriter)

Utilizza il writer di risorse fornito per rendere persistenti le proprietà localizzate del controllo associato in una risorsa nell'host di progettazione.

(Ereditato da ControlDesigner)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.

(Ereditato da Object)
OnAutoFormatApplied(DesignerAutoFormat)

Chiamato dopo che è stato applicato uno schema di formattazione automatica e predefinito al controllo associato.

(Ereditato da ControlDesigner)
OnBehaviorAttached()

Chiamato quando la finestra di progettazione di controlli è collegata a un oggetto Behavior.

(Ereditato da ControlDesigner)
OnBehaviorDetaching()
Obsoleti.

Chiamato quando viene annullata un'associazione di un comportamento dall'elemento.

(Ereditato da HtmlControlDesigner)
OnBindingsCollectionChanged(String)
Obsoleti.

Chiamato se viene modificato l'insieme di associazioni dati.

(Ereditato da ControlDesigner)
OnClick(DesignerRegionMouseEventArgs)

Chiamato dall'host di progettazione quando l'utente fa clic su un controllo associato in fase di progettazione.

(Ereditato da ControlDesigner)
OnComponentChanged(Object, ComponentChangedEventArgs)

Viene chiamato in caso di modifica del controllo associato.

(Ereditato da ControlDesigner)
OnComponentChanging(Object, ComponentChangingEventArgs)

Rappresenta il metodo che gestirà l'evento ComponentChanging per il controllo associato.

(Ereditato da ControlDesigner)
OnControlResize()
Obsoleti.

Chiamato se il controllo server Web associato è stato ridimensionato nell'host di progettazione in fase di progettazione.

(Ereditato da ControlDesigner)
OnDataSourceChanged(EventArgs)

Genera l'evento DataSourceChanged quando le proprietà dell'origine dati sono state modificate e il valore di SuppressingDataSourceEvents è false.

(Ereditato da DataSourceDesigner)
OnPaint(PaintEventArgs)

Chiamato se la finestra di progettazione di controlli crea il controllo associato sull'area di progettazione, se il valore CustomPaint è true.

(Ereditato da ControlDesigner)
OnSchemaRefreshed(EventArgs)

Genera l'evento SchemaRefreshed quando lo schema dell'origine dati è stato modificato e il valore di SuppressingDataSourceEvents è false.

(Ereditato da DataSourceDesigner)
OnSetComponentDefaults()
Obsoleti.
Obsoleti.

Imposta le proprietà predefinite relative al componente.

(Ereditato da ComponentDesigner)
OnSetParent()

Fornisce un modo per eseguire un'ulteriore elaborazione quando il controllo associato viene connesso al controllo padre.

(Ereditato da HtmlControlDesigner)
PostFilterAttributes(IDictionary)

Consente a una finestra di progettazione di modificare o rimuovere elementi dall'insieme di attributi esposti tramite un oggetto TypeDescriptor.

(Ereditato da ComponentDesigner)
PostFilterEvents(IDictionary)

Consente a una finestra di progettazione di modificare o rimuovere elementi dal gruppo di eventi esposti tramite un oggetto TypeDescriptor.

(Ereditato da ComponentDesigner)
PostFilterProperties(IDictionary)

Consente a una finestra di progettazione di modificare o rimuovere elementi dall'insieme di proprietà esposte tramite un oggetto TypeDescriptor.

(Ereditato da ComponentDesigner)
PreFilterAttributes(IDictionary)

Consente a una finestra di progettazione di aggiungere un insieme di attributi che vengono esposti tramite un oggetto TypeDescriptor.

(Ereditato da ComponentDesigner)
PreFilterEvents(IDictionary)

Imposta l'elenco di eventi esposti in fase di progettazione per l'oggetto TypeDescriptor per il componente.

(Ereditato da HtmlControlDesigner)
PreFilterProperties(IDictionary)

Usato dalla finestra di progettazione per aggiungere o rimuovere proprietà dalla griglia Proprietà o per nascondere quelle del controllo associato.

RaiseComponentChanged(MemberDescriptor, Object, Object)

Notifica all'oggetto IComponentChangeService che questo componente è stato modificato.

(Ereditato da ComponentDesigner)
RaiseComponentChanging(MemberDescriptor)

Notifica all'oggetto IComponentChangeService che questo componente sta per essere modificato.

(Ereditato da ComponentDesigner)
RaiseResizeEvent()
Obsoleti.

Genera l'evento OnControlResize().

(Ereditato da ControlDesigner)
RefreshSchema(Boolean)

Aggiorna lo schema dall'origine dati sottostante.

(Ereditato da SqlDataSourceDesigner)
RegisterClone(Object, Object)

Registra i dati interni in un controllo duplicato.

(Ereditato da ControlDesigner)
ResumeDataSourceEvents()

Ripristina gli eventi dell'origine dati dopo la relativa soppressione.

(Ereditato da DataSourceDesigner)
SetEditableDesignerRegionContent(EditableDesignerRegion, String)

Specifica il contenuto di un'area modificabile del controllo in fase di progettazione.

(Ereditato da ControlDesigner)
SetRegionContent(EditableDesignerRegion, String)

Specifica il contenuto per un'area modificabile della visualizzazione Design-Time del controllo.

(Ereditato da ControlDesigner)
SetViewFlags(ViewFlags, Boolean)

Assegna l'enumerazione ViewFlags bit per bit specificata al valore del flag specificato.

(Ereditato da ControlDesigner)
SuppressDataSourceEvents()

Pospone tutti gli eventi dell'origine dati fino alla chiamata del metodo ResumeDataSourceEvents().

(Ereditato da DataSourceDesigner)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)
UpdateDesignTimeHtml()

Aggiorna il markup HTML Design-Time per il controllo server Web associato mediante la chiamata al metodo GetDesignTimeHtml.

(Ereditato da ControlDesigner)

Eventi

DataSourceChanged

Si verifica quando viene modificata una qualsiasi proprietà dell'origine dati associata.

(Ereditato da DataSourceDesigner)
SchemaRefreshed

Si verifica dopo l'aggiornamento dello schema.

(Ereditato da DataSourceDesigner)

Implementazioni dell'interfaccia esplicita

IDesignerFilter.PostFilterAttributes(IDictionary)

Per una descrizione di questo membro, vedere il metodo PostFilterAttributes(IDictionary).

(Ereditato da ComponentDesigner)
IDesignerFilter.PostFilterEvents(IDictionary)

Per una descrizione di questo membro, vedere il metodo PostFilterEvents(IDictionary).

(Ereditato da ComponentDesigner)
IDesignerFilter.PostFilterProperties(IDictionary)

Per una descrizione di questo membro, vedere il metodo PostFilterProperties(IDictionary).

(Ereditato da ComponentDesigner)
IDesignerFilter.PreFilterAttributes(IDictionary)

Per una descrizione di questo membro, vedere il metodo PreFilterAttributes(IDictionary).

(Ereditato da ComponentDesigner)
IDesignerFilter.PreFilterEvents(IDictionary)

Per una descrizione di questo membro, vedere il metodo PreFilterEvents(IDictionary).

(Ereditato da ComponentDesigner)
IDesignerFilter.PreFilterProperties(IDictionary)

Per una descrizione di questo membro, vedere il metodo PreFilterProperties(IDictionary).

(Ereditato da ComponentDesigner)
ITreeDesigner.Children

Per una descrizione di questo membro, vedere la proprietà Children.

(Ereditato da ComponentDesigner)
ITreeDesigner.Parent

Per una descrizione di questo membro, vedere la proprietà Parent.

(Ereditato da ComponentDesigner)

Si applica a

Vedi anche