BaseValidatorDesigner 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 i controlli server Web derivati dalla BaseValidator classe .
public ref class BaseValidatorDesigner : System::Web::UI::Design::ControlDesignerpublic ref class BaseValidatorDesigner : System::Web::UI::Design::WebControls::PreviewControlDesignerpublic class BaseValidatorDesigner : System.Web.UI.Design.ControlDesigner[System.Web.UI.Design.SupportsPreviewControl(true)]
public class BaseValidatorDesigner : System.Web.UI.Design.WebControls.PreviewControlDesignertype BaseValidatorDesigner = class
inherit ControlDesigner[<System.Web.UI.Design.SupportsPreviewControl(true)>]
type BaseValidatorDesigner = class
inherit PreviewControlDesignerPublic Class BaseValidatorDesigner
Inherits ControlDesignerPublic Class BaseValidatorDesigner
Inherits PreviewControlDesigner- Ereditarietà
- Ereditarietà
-
BaseValidatorDesigner
- Attributi
Esempio
Nell'esempio seguente viene derivato il SimpleCompareValidator controllo dalla CompareValidator classe .
SimpleCompareValidator è una copia di CompareValidator. L'esempio deriva anche la finestra di progettazione SimpleCompareValidatorDesigner dalla BaseValidatorDesigner classe e usa l'attributo DesignerAttribute per associare la SimpleCompareValidatorDesigner classe al SimpleCompareValidator controllo .
SimpleCompareValidatorDesigner esegue l'override del GetDesignTimeHtml metodo per disegnare un bordo solido intorno al SimpleCompareValidator controllo in fase di progettazione se il valore della BorderStyle proprietà del controllo è il NotSet campo o None .
using System;
using System.Web;
using System.Web.UI.WebControls;
using System.Web.UI.Design.WebControls;
using System.ComponentModel;
using System.Security.Permissions;
namespace Examples.CS.WebControls.Design
{
// The SimpleCompareValidator is a copy of the CompareValidator.
[AspNetHostingPermission(SecurityAction.Demand,
Level = AspNetHostingPermissionLevel.Minimal)]
[AspNetHostingPermission(SecurityAction.InheritanceDemand,
Level = AspNetHostingPermissionLevel.Minimal)]
[Designer(typeof(Examples.CS.WebControls.Design.
SimpleCompareValidatorDesigner))]
public class SimpleCompareValidator : CompareValidator
{
} // SimpleCompareValidator
// Derive a designer that inherits from the BaseValidatorDesigner.
public class SimpleCompareValidatorDesigner : BaseValidatorDesigner
{
// Make the full extent of the control more visible in the designer.
// If the border style is None or NotSet, change the border to a
// solid line.
public override string GetDesignTimeHtml()
{
// Get a reference to the control or a copy of the control.
SimpleCompareValidator myCV = (SimpleCompareValidator)ViewControl;
string markup = null;
// Check if the border style should be changed.
if (myCV.BorderStyle == BorderStyle.NotSet ||
myCV.BorderStyle == BorderStyle.None)
{
// Save the current property setting.
BorderStyle oldBorderStyle = myCV.BorderStyle;
// Set the design-time property and catch any exceptions.
try
{
myCV.BorderStyle = BorderStyle.Solid;
// Call the base method to generate the markup.
markup = base.GetDesignTimeHtml();
}
catch (Exception ex)
{
markup = GetErrorDesignTimeHtml(ex);
}
finally
{
// Restore the property to its original setting.
myCV.BorderStyle = oldBorderStyle;
}
}
else
{
// Call the base method to generate the markup.
markup = base.GetDesignTimeHtml();
}
return markup;
} // GetDesignTimeHtml
} // SimpleCompareValidatorDesigner
} // Examples.CS.WebControls.Design
Imports System.Web
Imports System.Web.UI.WebControls
Imports System.Web.UI.Design.WebControls
Imports System.ComponentModel
Imports System.Security.Permissions
Namespace Examples.VB.WebControls.Design
' The SimpleCompareValidator is a copy of the CompareValidator.
<AspNetHostingPermission(SecurityAction.Demand, _
Level:=AspNetHostingPermissionLevel.Minimal)> _
<AspNetHostingPermission(SecurityAction.InheritanceDemand, _
Level:=AspNetHostingPermissionLevel.Minimal)> _
<Designer(GetType(Examples.VB.WebControls.Design. _
SimpleCompareValidatorDesigner))> _
Public Class SimpleCompareValidator
Inherits CompareValidator
End Class
' Derive a designer that inherits from the BaseValidatorDesigner.
Public Class SimpleCompareValidatorDesigner
Inherits BaseValidatorDesigner
' Make the full extent of the control more visible in the designer.
' If the border style is None or NotSet, change the border to a
' solid line.
Public Overrides Function GetDesignTimeHtml() As String
' Get a reference to the control or a copy of the control.
Dim myCV As SimpleCompareValidator = _
CType(ViewControl, SimpleCompareValidator)
Dim markup As String
' Check if the border style should be changed.
If (myCV.BorderStyle = BorderStyle.NotSet Or _
myCV.BorderStyle = BorderStyle.None) Then
' Save the current property setting.
Dim oldBorderStyle As BorderStyle = myCV.BorderStyle
' Set the design-time property and catch any exceptions.
Try
myCV.BorderStyle = BorderStyle.Solid
' Call the base method to generate the markup.
markup = MyBase.GetDesignTimeHtml()
Catch ex As Exception
markup = GetErrorDesignTimeHtml(ex)
Finally
' Restore the property to its original setting.
myCV.BorderStyle = oldBorderStyle
End Try
Else
' Call the base method to generate the markup.
markup = MyBase.GetDesignTimeHtml()
End If
Return markup
End Function
End Class
End Namespace ' Examples.VB.WebControls.Design
Commenti
In una finestra di progettazione visiva, quando si passa dalla visualizzazione Origine a Progettazione, il codice sorgente di markup che descrive un controllo derivato dalla BaseValidator classe astratta viene analizzato e viene creata una versione in fase di progettazione del controllo nell'area di progettazione. Quando si torna alla visualizzazione Origine, il controllo design-time viene salvato in modo permanente nel codice sorgente di markup e modificato nel markup per la pagina Web. Gli BaseValidatorDesigner oggetti forniscono il supporto della fase di progettazione per i controlli derivati dalla BaseValidator classe in una finestra di progettazione visiva.
Il GetDesignTimeHtml metodo ottiene il markup utilizzato per eseguire il rendering del controllo associato in fase di progettazione.
Costruttori
| Nome | Descrizione |
|---|---|
| BaseValidatorDesigner() |
Inizializza una nuova istanza della classe BaseValidatorDesigner. |
Proprietà
| Nome | Descrizione |
|---|---|
| ActionLists |
Ottiene la raccolta di elenchi di azioni per la finestra di progettazione dei controlli. (Ereditato da ControlDesigner) |
| 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) |
| Component |
Ottiene il componente che la finestra di progettazione sta progettando. (Ereditato da ComponentDesigner) |
| 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) |
| 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) |
| 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) |
| 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) |
| 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) |
| 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) |
| 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 PreviewControlDesigner) |
| 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 |
|---|---|
| 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) |
| CreateViewControl() |
Restituisce una copia del controllo associato per il rendering nell'area di progettazione. |
| CreateViewControl() |
Restituisce una copia del controllo associato per la visualizzazione o il rendering nell'area di progettazione. (Ereditato da ControlDesigner) |
| 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) |
| GetDesignTimeHtml() |
Ottiene il markup utilizzato per eseguire il rendering del controllo associato in fase di progettazione. |
| 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) |
| GetViewRendering() |
Recupera un oggetto che contiene il markup in fase di progettazione per il contenuto e le aree del controllo associato. (Ereditato da ControlDesigner) |
| 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) |
| OnBehaviorAttached() |
Chiamato quando la finestra di progettazione controlli è associata a un oggetto Behavior. (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) |
| OnPaint(PaintEventArgs) |
Chiamato quando la finestra di progettazione dei controlli disegna il controllo associato nell'area di progettazione, se il CustomPaint 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 rimuovere o aggiungere proprietà nella griglia delle proprietà o per nascondere le proprietà del controllo associato. |
| PreFilterProperties(IDictionary) |
Aggiunge o rimuove proprietà dalla griglia Proprietà in un host di progettazione in fase di progettazione o fornisce nuove proprietà in fase di progettazione che potrebbero corrispondere alle proprietà del controllo associato. (Ereditato da ControlDesigner) |
| 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) |
| RegisterClone(Object, Object) |
Registra i dati interni in un controllo clonato. (Ereditato da ControlDesigner) |
| 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) |
| 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) |
