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.
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::SqlDataSourceDesignerpublic class AccessDataSourceDesigner : System.Web.UI.Design.WebControls.SqlDataSourceDesignertype AccessDataSourceDesigner = class
inherit SqlDataSourceDesignerPublic Class AccessDataSourceDesigner
Inherits SqlDataSourceDesigner- Ereditarietà
-
AccessDataSourceDesigner
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 |
| 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 è |
| OnPaint(PaintEventArgs) |
Chiamato se la finestra di progettazione di controlli crea il controllo associato sull'area di progettazione, se il valore CustomPaint è |
| OnSchemaRefreshed(EventArgs) |
Genera l'evento SchemaRefreshed quando lo schema dell'origine dati è stato modificato e il valore di SuppressingDataSourceEvents è |
| 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) |
