Partilhar via


ExpressionEditor.GetExpressionEditorSheet(String, IServiceProvider) Método

Definição

Retorna uma folha do editor de expressão que está associada ao editor de expressão atual.

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

Parâmetros

expression
String

A cadeia de caracteres de expressão definida para uma propriedade de controle, usada para inicializar a folha do editor de expressão.

serviceProvider
IServiceProvider

Uma implementação do provedor de serviço fornecida pelo host do designer, usada para obter serviços de tempo de design adicionais.

Retornos

ExpressionEditorSheet

Um ExpressionEditorSheet que define as propriedades de expressão personalizada.

Comentários

O GetExpressionEditorSheet método retorna uma implementação ExpressionEditorSheet que define as cadeias de caracteres que são combinadas para formar uma expressão personalizada. O designer visual usa uma folha do editor de expressões para solicitar uma ou mais cadeias de caracteres que se combinam em uma expressão personalizada. O método de classe base retorna uma folha de editor de expressão padrão, que usa uma única cadeia de caracteres de entrada para formar a expressão. A folha do editor de expressões define a grade de propriedades da expressão. Portanto, as propriedades expostas pelo editor de expressão tornam-se propriedades que podem ser definidas para a expressão na caixa de diálogo.

As classes derivadas da ExpressionEditor classe opcionalmente podem substituir o GetExpressionEditorSheet método para fornecer uma folha de editor de expressão personalizada. Uma folha de editor de expressões personalizadas pode permitir a entrada em tempo de design para várias propriedades, que são combinadas em conjunto para formar a cadeia de caracteres de expressão.

Por exemplo, a ResourceExpressionEditor classe deriva da ExpressionEditor classe e fornece uma implementação para avaliar e associar uma referência de cadeia de caracteres de recurso a uma propriedade de controle em tempo de design. A ResourceExpressionBuilder classe está associada ao prefixo Resources de expressão e à ResourceExpressionEditor implementação. O ResourceExpressionEditor.GetExpressionEditorSheet método retorna um ResourceExpressionEditorSheet, que define as propriedades individuais que formam uma expressão de referência de recurso.

Notas aos Herdeiros

Normalmente, para fornecer um novo tipo de expressão em tempo de design, você define um prefixo de expressão exclusiva e fornece implementações e ExpressionEditor personalizadasExpressionBuilder. Opcionalmente, você pode fornecer uma implementação personalizada ExpressionEditorSheet que define as propriedades usadas para formar a expressão. Embora o arquivo de configuração defina o prefixo, você também deve aplicar um ExpressionPrefixAttribute objeto e um ExpressionEditorAttribute objeto.

Substitua o GetExpressionEditorSheet(String, IServiceProvider) método para retornar uma folha do editor de expressões que define a entrada em tempo de design para várias propriedades em uma expressão personalizada. Quando você seleciona uma propriedade de controle e o tipo de editor de expressão, o designer visual chama o GetExpressionEditorSheet(String, IServiceProvider) método e fornece a cadeia de caracteres de expressão atual definida para a propriedade de controle. Use expression para definir os valores iniciais para as propriedades de expressão. Use serviceProvider para inicializar um construtor de folha de expressões personalizada e acessar os serviços fornecidos pelo host do designer. Por exemplo, chame o GetService(Type) método com o IWebApplication tipo para acessar itens de projeto, documentos ou detalhes do arquivo de configuração fornecidos por meio do designer visual.

Aplica-se a

Confira também