AccessDataSourceDesigner Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Fornisce supporto in fase di progettazione in una finestra di progettazione visiva per il AccessDataSource controllo server Web.
public ref class AccessDataSourceDesigner : System::Web::UI::Design::WebControls::SqlDataSourceDesignerpublic class AccessDataSourceDesigner : System.Web.UI.Design.WebControls.SqlDataSourceDesignertype AccessDataSourceDesigner = class
inherit SqlDataSourceDesignerPublic Class AccessDataSourceDesigner
Inherits SqlDataSourceDesigner- Ereditarietà
-
AccessDataSourceDesigner
Esempio
In questa sezione vengono forniti 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 di codice seguente viene illustrato come derivare una copia della AccessDataSource 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 del markup che descrive il AccessDataSource controllo viene analizzato e viene creata una versione design-time del controllo, che è semplicemente un segnaposto, nell'area di progettazione. Quando si torna alla visualizzazione Origine, il controllo in fase di progettazione, che include i valori delle proprietà nella griglia Proprietà , viene salvato in modo permanente nel codice sorgente del markup e modificato nel markup per la pagina Web.
Costruttori
| Nome | Descrizione |
|---|---|
| AccessDataSourceDesigner() |
Inizializza una nuova istanza della classe AccessDataSource. |
Proprietà
| Nome | Descrizione |
|---|---|
| ActionLists |
Ottiene un elenco di elementi utilizzati per creare un menu elenco di azioni in fase di progettazione. (Ereditato da DataSourceDesigner) |
| AllowResize |
Ottiene un valore che indica se il controllo può essere ridimensionato nell'ambiente in fase di progettazione. (Ereditato da ControlDesigner) |
| AssociatedComponents |
Ottiene la raccolta di componenti associati al componente gestito dalla finestra di progettazione. (Ereditato da ComponentDesigner) |
| AutoFormats |
Ottiene l'insieme di schemi di formattazione automatica predefiniti da visualizzare nella finestra di dialogo Formato automatico 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 Configure() metodo può essere chiamato dall'host di progettazione. (Ereditato da SqlDataSourceDesigner) |
| CanRefreshSchema |
Ottiene un valore che indica se il RefreshSchema(Boolean) metodo può essere chiamato dall'host di progettazione. (Ereditato da SqlDataSourceDesigner) |
| Component |
Ottiene il componente che la finestra di progettazione sta progettando. (Ereditato da ComponentDesigner) |
| ConnectionString |
Ottiene o imposta la stringa utilizzata per aprire un database. (Ereditato da SqlDataSourceDesigner) |
| DataBindings |
Ottiene la raccolta di data binding per il controllo corrente. (Ereditato da HtmlControlDesigner) |
| DataBindingsEnabled |
Ottiene un valore che indica se il data binding è supportato dall'area contenitore per il controllo associato. (Ereditato da ControlDesigner) |
| DataFile |
Implementa una proprietà della finestra di progettazione per nascondere la DataFile proprietà del controllo associato. |
| DeleteQuery |
Ottiene o imposta l'oggetto 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 nell'area HtmlControlDesigner di progettazione. (Ereditato da HtmlControlDesigner) |
| DesignTimeElementView |
Obsoleti.
Ottiene l'oggetto view-control per la finestra di progettazione dei controlli. (Ereditato da ControlDesigner) |
| DesignTimeHtmlRequiresLoadComplete |
Obsoleti.
Ottiene un valore che indica se l'host di progettazione deve completare il caricamento prima che il GetDesignTimeHtml metodo possa essere chiamato. (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 il controllo è in modalità modello. (Ereditato da ControlDesigner) |
| ID |
Ottiene o imposta la 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 il componente è ereditato. (Ereditato da ComponentDesigner) |
| InsertQuery |
Ottiene o imposta l'oggetto 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 di modelli nell'host di progettazione. La InTemplateMode proprietà è 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 questa finestra di progettazione. (Ereditato da ComponentDesigner) |
| ProviderName |
Ottiene o imposta il nome del provider di dati .NET Framework utilizzato dal controllo associato SqlDataSource per connettersi a un'origine dati sottostante. (Ereditato da SqlDataSourceDesigner) |
| ReadOnly |
Obsoleti.
Ottiene o imposta un valore che indica se le proprietà del controllo sono di sola lettura in fase di progettazione. (Ereditato da ControlDesigner) |
| RootDesigner |
Ottiene la finestra di progettazione controlli per la pagina Web Form che contiene il controllo associato. (Ereditato da ControlDesigner) |
| SelectCommand |
Ottiene o imposta la query SQL nell'oggetto associato SqlDataSource per la selezione dei dati dal database sottostante. (Ereditato da SqlDataSourceDesigner) |
| SelectQuery |
Ottiene o imposta l'oggetto SqlDataSourceDesigner che supporta le query select. (Ereditato da SqlDataSourceDesigner) |
| ShadowProperties |
Ottiene una raccolta di valori di proprietà che eseguono l'override delle impostazioni utente. (Ereditato da ComponentDesigner) |
| ShouldCodeSerialize |
Obsoleti.
Ottiene o imposta un valore che indica se creare una dichiarazione di campo per il controllo nel file code-behind per il documento di progettazione corrente durante la serializzazione. (Ereditato da HtmlControlDesigner) |
| SuppressingDataSourceEvents |
Ottiene un valore che indica se l'evento DataSourceChanged o il RefreshSchema(Boolean) metodo si verifica. (Ereditato da DataSourceDesigner) |
| Tag |
Ottiene un oggetto che rappresenta l'elemento di 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 l'oggetto SqlDataSourceDesigner che supporta le query di aggiornamento. (Ereditato da SqlDataSourceDesigner) |
| UsePreviewControl |
Ottiene un valore che indica se la finestra di progettazione dei controlli utilizza un controllo di anteprima temporaneo per generare il markup HTML in fase di progettazione. (Ereditato da ControlDesigner) |
| Verbs |
Ottiene i verbi della 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 in fase di progettazione. (Ereditato da ControlDesigner) |
| ViewControlCreated |
Ottiene o imposta un valore che indica se è stato creato un |
| Visible |
Ottiene un valore che indica se il controllo è visibile in fase di progettazione. (Ereditato da ControlDesigner) |
Metodi
| Nome | Descrizione |
|---|---|
| Configure() |
Avvia l'utilità di configurazione dell'origine dati nell'host di progettazione. (Ereditato da SqlDataSourceDesigner) |
| CreateErrorDesignTimeHtml(String, Exception) |
Crea il markup HTML per visualizzare un messaggio di errore di eccezione specificato in fase di progettazione. (Ereditato da ControlDesigner) |
| CreateErrorDesignTimeHtml(String) |
Crea markup HTML per visualizzare un messaggio di errore specificato in fase di progettazione. (Ereditato da ControlDesigner) |
| CreatePlaceHolderDesignTimeHtml() |
Fornisce una rappresentazione segnaposto rettangolare semplice che visualizza il tipo e l'ID del controllo. (Ereditato da ControlDesigner) |
| CreatePlaceHolderDesignTimeHtml(String) |
Fornisce una rappresentazione segnaposto rettangolare semplice che visualizza il tipo e l'ID del controllo, nonché istruzioni o informazioni aggiuntive specificate. (Ereditato da ControlDesigner) |
| CreateView(String) |
Crea una nuova SqlDesignerDataSourceView istanza 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 gli oggetti corrispondenti Parameter all'insieme 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 e, facoltativamente, rilascia le risorse gestite. (Ereditato da HtmlControlDesigner) |
| DoDefaultAction() |
Crea una firma del metodo nel file del codice sorgente per l'evento predefinito nel 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 per il controllo come visualizzato nell'area di progettazione. (Ereditato da ControlDesigner) |
| GetConnectionString() |
Ottiene la stringa di connessione valida in fase di progettazione per il controllo associato a questa finestra di progettazione. |
| GetDesignTimeHtml() |
Recupera il markup HTML per la visualizzazione del controllo origine dati associato in fase di progettazione. (Ereditato da DataSourceDesigner) |
| GetDesignTimeHtml(DesignerRegionCollection) |
Recupera il markup HTML per visualizzare il controllo e popola la raccolta con le aree di Progettazione controlli correnti. (Ereditato da ControlDesigner) |
| GetEditableDesignerRegionContent(EditableDesignerRegion) |
Restituisce il contenuto per un'area modificabile della visualizzazione in fase di progettazione 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) |
Tenta di recuperare il tipo di servizio specificato dal sito in modalità progettazione del componente della finestra di progettazione. (Ereditato da ComponentDesigner) |
| GetType() |
Ottiene il Type dell'istanza corrente. (Ereditato da Object) |
| GetView(String) |
Recupera un DesignerDataSourceView oggetto identificato dal nome della vista. (Ereditato da SqlDataSourceDesigner) |
| GetViewNames() |
Ottiene un elenco di visualizzazioni disponibili. (Ereditato da SqlDataSourceDesigner) |
| GetViewRendering() |
Recupera un oggetto che contiene il markup in fase di progettazione per il contenuto e le aree del controllo associato. (Ereditato da ControlDesigner) |
| InferParameterNames(DesignerDataConnection, String, SqlDataSourceCommandType) |
Restituisce una matrice di parametri utilizzando la connessione, il testo del comando e il tipo di comando specificati. (Ereditato da SqlDataSourceDesigner) |
| Initialize(IComponent) |
Inizializza la finestra di progettazione dei controlli e carica il componente specificato. (Ereditato da ControlDesigner) |
| InitializeExistingComponent(IDictionary) |
Reinizializza un componente esistente. (Ereditato da ComponentDesigner) |
| InitializeNewComponent(IDictionary) |
Inizializza un componente appena creato. (Ereditato da ComponentDesigner) |
| InitializeNonDefault() |
Obsoleti.
Obsoleti.
Inizializza le impostazioni per un componente importato già inizializzato in impostazioni diverse dalle impostazioni predefinite. (Ereditato da ComponentDesigner) |
| Invalidate() |
Invalida l'intera area del controllo visualizzata nell'area di progettazione e segnala alla finestra di progettazione di ridisegnare il controllo. (Ereditato da ControlDesigner) |
| Invalidate(Rectangle) |
Invalida l'area specificata del controllo visualizzata nell'area di progettazione e segnala alla finestra di progettazione di ridisegnare il controllo. (Ereditato da ControlDesigner) |
| InvokeGetInheritanceAttribute(ComponentDesigner) |
Ottiene l'oggetto dell'oggetto InheritanceAttribute specificato ComponentDesigner. (Ereditato da ComponentDesigner) |
| IsPropertyBound(String) |
Obsoleti.
Recupera un valore che indica se la proprietà specificata nel controllo associato è associata a dati. (Ereditato da ControlDesigner) |
| Localize(IDesignTimeResourceWriter) |
Usa il writer di risorse fornito per rendere persistenti le proprietà localizzabili del controllo associato a una risorsa nell'host di progettazione. (Ereditato da ControlDesigner) |
| MemberwiseClone() |
Crea una copia superficiale del Objectcorrente. (Ereditato da Object) |
| OnAutoFormatApplied(DesignerAutoFormat) |
Chiamato quando al controllo associato è stato applicato uno schema di formattazione automatico predefinito. (Ereditato da ControlDesigner) |
| OnBehaviorDetaching() |
Obsoleti.
Chiamato quando un comportamento annulla l'associazione dall'elemento . (Ereditato da HtmlControlDesigner) |
| OnBindingsCollectionChanged(String) |
Obsoleti.
Chiamato quando cambia la raccolta di data binding. (Ereditato da ControlDesigner) |
| OnClick(DesignerRegionMouseEventArgs) |
Chiamato dall'host di progettazione quando l'utente fa clic sul controllo associato in fase di progettazione. (Ereditato da ControlDesigner) |
| OnComponentChanged(Object, ComponentChangedEventArgs) |
Chiamato quando cambia il 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 quando 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 SuppressingDataSourceEvents valore è |
| OnPaint(PaintEventArgs) |
Chiamato quando la finestra di progettazione dei controlli disegna il controllo associato nell'area di progettazione, se il CustomPaint valore è |
| OnSchemaRefreshed(EventArgs) |
Genera l'evento SchemaRefreshed quando lo schema dell'origine dati è stato modificato e il SuppressingDataSourceEvents valore è |
| OnSetComponentDefaults() |
Obsoleti.
Obsoleti.
Imposta le proprietà predefinite per il componente. (Ereditato da ComponentDesigner) |
| OnSetParent() |
Fornisce un modo per eseguire un'elaborazione aggiuntiva quando il controllo associato è collegato a un controllo padre. (Ereditato da HtmlControlDesigner) |
| PostFilterAttributes(IDictionary) |
Consente a una finestra di progettazione di modificare o rimuovere elementi dal set di attributi esposti tramite un oggetto TypeDescriptor. (Ereditato da ComponentDesigner) |
| PostFilterEvents(IDictionary) |
Consente a una finestra di progettazione di modificare o rimuovere elementi dal set di eventi esposti tramite un oggetto TypeDescriptor. (Ereditato da ComponentDesigner) |
| PostFilterProperties(IDictionary) |
Consente a una finestra di progettazione di modificare o rimuovere elementi dal set di proprietà esposte tramite un oggetto TypeDescriptor. (Ereditato da ComponentDesigner) |
| PreFilterAttributes(IDictionary) |
Consente a una finestra di progettazione di aggiungere al set di attributi 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) |
Utilizzato dalla finestra di progettazione per aggiungere proprietà o rimuoverle dalla griglia Proprietà o per nascondere le proprietà 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 il 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 clonato. (Ereditato da ControlDesigner) |
| ResumeDataSourceEvents() |
Ripristina gli eventi dell'origine dati dopo che gli eventi dell'origine dati sono stati eliminati. (Ereditato da DataSourceDesigner) |
| SetEditableDesignerRegionContent(EditableDesignerRegion, String) |
Specifica il contenuto per un'area modificabile del controllo in fase di progettazione. (Ereditato da ControlDesigner) |
| SetRegionContent(EditableDesignerRegion, String) |
Specifica il contenuto di un'area modificabile nella visualizzazione in fase di progettazione del controllo. (Ereditato da ControlDesigner) |
| SetViewFlags(ViewFlags, Boolean) |
Assegna l'enumerazione bit per ViewFlags bit specificata al valore del flag specificato. (Ereditato da ControlDesigner) |
| SuppressDataSourceEvents() |
Posticipa tutti gli eventi dell'origine dati fino a quando viene chiamato il ResumeDataSourceEvents() metodo . (Ereditato da DataSourceDesigner) |
| ToString() |
Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object) |
| UpdateDesignTimeHtml() |
Aggiorna il markup HTML in fase di progettazione per il controllo server Web associato chiamando il GetDesignTimeHtml metodo . (Ereditato da ControlDesigner) |
Eventi
| Nome | Descrizione |
|---|---|
| DataSourceChanged |
Si verifica quando viene modificata una proprietà dell'origine dati associata. (Ereditato da DataSourceDesigner) |
| SchemaRefreshed |
Si verifica dopo l'aggiornamento dello schema. (Ereditato da DataSourceDesigner) |
