ExpressionEditor.GetExpressionEditorSheet(String, IServiceProvider) Metodo

Definizione

Restituisce una pagina dell'editor di espressioni associata all'editor di espressioni corrente.

public:
 virtual System::Web::UI::Design::ExpressionEditorSheet ^ GetExpressionEditorSheet(System::String ^ expression, IServiceProvider ^ serviceProvider);
public virtual System.Web.UI.Design.ExpressionEditorSheet GetExpressionEditorSheet (string expression, IServiceProvider serviceProvider);
abstract member GetExpressionEditorSheet : string * IServiceProvider -> System.Web.UI.Design.ExpressionEditorSheet
override this.GetExpressionEditorSheet : string * IServiceProvider -> System.Web.UI.Design.ExpressionEditorSheet
Public Overridable Function GetExpressionEditorSheet (expression As String, serviceProvider As IServiceProvider) As ExpressionEditorSheet

Parametri

expression
String

Stringa di espressione impostata per una proprietà di un controllo, utilizzata per inizializzare la pagina dell'editor di espressioni.

serviceProvider
IServiceProvider

Implementazione del provider di servizi fornita dall'host di progettazione, utilizzata per ottenere ulteriori servizi in fase di progettazione.

Restituisce

ExpressionEditorSheet

Oggetto ExpressionEditorSheet che definisce le proprietà dell'espressione personalizzata.

Commenti

Il GetExpressionEditorSheet metodo restituisce un'implementazione ExpressionEditorSheet che definisce le stringhe combinate per formare un'espressione personalizzata. La finestra di progettazione visiva usa un foglio dell'editor di espressioni per richiedere una o più stringhe combinate in un'espressione personalizzata. Il metodo della classe base restituisce un foglio dell'editor di espressioni predefinito, che usa una singola stringa di input per formare l'espressione. Il foglio dell'editor di espressioni definisce la griglia delle proprietà per l'espressione. Di conseguenza, le proprietà esposte dall'editor di espressioni diventano proprietà che possono essere definite per l'espressione nella finestra di dialogo.

Le classi derivate dalla classe facoltativamente possono eseguire l'override ExpressionEditor del GetExpressionEditorSheet metodo per fornire un foglio dell'editor di espressioni personalizzato. Un foglio dell'editor di espressioni personalizzato può consentire l'input in fase di progettazione per più proprietà, che vengono combinate insieme per formare la stringa dell'espressione.

Ad esempio, la ResourceExpressionEditor classe deriva dalla ExpressionEditor classe e fornisce un'implementazione per la valutazione e l'associazione di un riferimento stringa di risorsa a una proprietà del controllo in fase di progettazione. La ResourceExpressionBuilder classe è associata al prefisso Resources dell'espressione e all'implementazione ResourceExpressionEditor . Il ResourceExpressionEditor.GetExpressionEditorSheet metodo restituisce un ResourceExpressionEditorSheetoggetto , che definisce le singole proprietà che formano un'espressione di riferimento alla risorsa.

Note per gli eredi

In genere, per fornire un nuovo tipo di espressione in fase di progettazione, è necessario definire un prefisso di espressione univoco e fornire implementazioni e ExpressionEditor personalizzateExpressionBuilder. Facoltativamente, è possibile fornire un'implementazione personalizzata ExpressionEditorSheet che definisce le proprietà utilizzate per formare l'espressione. Anche se il file di configurazione definisce il prefisso, è necessario applicare anche un ExpressionPrefixAttribute oggetto e un ExpressionEditorAttribute oggetto .

Eseguire l'override del GetExpressionEditorSheet(String, IServiceProvider) metodo per restituire un foglio dell'editor di espressioni che definisce l'input in fase di progettazione per più proprietà in un'espressione personalizzata. Quando si seleziona una proprietà del controllo e il tipo di editor di espressioni, progettazione oggetti visivi chiama il GetExpressionEditorSheet(String, IServiceProvider) metodo e quindi specifica la stringa di espressione corrente impostata per la proprietà del controllo. Utilizzare expression per impostare i valori iniziali per le proprietà dell'espressione. Utilizzare serviceProvider per inizializzare un costruttore del foglio di espressioni personalizzato e accedere ai servizi forniti dall'host della finestra di progettazione. Ad esempio, chiamare il GetService(Type) metodo con il IWebApplication tipo per accedere agli elementi, ai documenti o ai dettagli del file di configurazione forniti tramite la finestra di progettazione visiva.

Si applica a

Vedi anche