ExpressionEditorSheet Classe

Definição

Representa uma folha de editor de tempo de design para uma expressão personalizada.Represents a design-time editor sheet for a custom expression. Essa classe deve ser herdada.This class must be inherited.

public ref class ExpressionEditorSheet abstract
public abstract class ExpressionEditorSheet
type ExpressionEditorSheet = class
Public MustInherit Class ExpressionEditorSheet
Herança
ExpressionEditorSheet
Derivado

Comentários

Uma planilha de editor de expressão personalizada permite que um desenvolvedor defina propriedades em uma expressão personalizada em tempo de design.A custom expression editor sheet lets a developer set properties on a custom expression at design-time. Os valores de propriedade de controle podem ser definidos usando cadeias de caracteres de expressão; as cadeias de caracteres de expressão são avaliadas em tempo de execução por um construtor de expressões e em tempo de design por um editor de expressão.Control property values can be set using expression strings; the expression strings are evaluated at run time by an expression builder and at design time by an expression editor.

Quando você procura a Expressions propriedade de um controle na grade de propriedades de tempo de design, o designer visual exibe uma caixa de diálogo para definir expressões que fornecem o valor para uma propriedade de controle.When you browse the Expressions property for a control in the design-time properties grid, the visual designer displays a dialog box to set expressions that provide the value for a control property. Você pode selecionar o tipo de expressão com base em uma lista de prefixos de expressão.You can select the expression type based on a list of expression prefixes. Quando você seleciona um prefixo de expressão na lista, o designer visual usa os ExpressionEditor objetos associados e ExpressionEditorSheet para avaliar e converter a cadeia de caracteres de expressão com base na sintaxe para esse tipo de expressão.When you select an expression prefix from the list, the visual designer uses the associated ExpressionEditor and ExpressionEditorSheet objects to evaluate and convert the expression string based on the syntax for that type of expression. O designer visual usa propriedades de planilha do editor de expressões para solicitar uma ou mais cadeias de caracteres que se combinam na cadeia de expressão personalizada.The visual designer uses expression editor sheet properties to prompt for one or more strings that combine into the custom expression string.

Normalmente, para fornecer um novo tipo de expressão em tempo de design, você define um prefixo de expressão exclusivo e fornece ExpressionBuilder ExpressionEditor implementações personalizadas e.Typically, to supply a new expression type at design time, you define a unique expression prefix and provide custom ExpressionBuilder and ExpressionEditor implementations. Opcionalmente, você pode fornecer uma ExpressionEditorSheet implementação personalizada que define as propriedades que são usadas para formar a expressão.Optionally, you can provide a custom ExpressionEditorSheet implementation that defines properties that are used to form the expression. Para associar um prefixo de expressão a um construtor de expressões e a um editor de expressão, aplique o ExpressionEditorAttribute atributo e um ExpressionPrefixAttribute atributo à ExpressionBuilder classe personalizada e, em seguida, configure o prefixo de expressão para um construtor de expressões no expressionBuilders elemento no arquivo de configuração da Web.To associate an expression prefix with an expression builder and an expression editor, apply the ExpressionEditorAttribute attribute and an ExpressionPrefixAttribute attribute to the custom ExpressionBuilder class, and then configure the expression prefix for an expression builder in the expressionBuilders element in the Web configuration file.

A implementação padrão do GetExpressionEditorSheet método retorna uma folha de editor básica, que usa uma única cadeia de caracteres de entrada para formar a expressão.The default implementation of the GetExpressionEditorSheet method returns a basic editor sheet, which uses a single input string to form the expression. Os editores de expressão personalizada que são derivados do ExpressionEditor podem substituir o GetExpressionEditorSheet método para retornar uma implementação de planilha de editor Personalizada.Custom expression editors that are derived from the ExpressionEditor can override the GetExpressionEditorSheet method to return a custom editor sheet implementation. Normalmente, uma planilha de editor personalizada contém várias propriedades que são usadas para criar a cadeia de caracteres de expressão.Typically, a custom editor sheet contains multiple properties that are used to build the expression string. O GetExpression método retorna a cadeia de caracteres de expressão resultante com base nas propriedades da expressão atual.The GetExpression method returns the resulting expression string based on the current expression properties.

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 com uma propriedade de controle em tempo de design.For example, the ResourceExpressionEditor class derives from the ExpressionEditor class and provides an implementation for evaluating and associating a resource string reference with a control property at design time. A ResourceExpressionBuilder classe é associada ao prefixo da expressão Resources e à ResourceExpressionEditor implementação.The ResourceExpressionBuilder class is associated with the expression prefix Resources and the ResourceExpressionEditor implementation. O GetExpressionEditorSheet método retorna um ResourceExpressionEditorSheet , que define as propriedades individuais que formam uma expressão de referência de recurso.The GetExpressionEditorSheet method returns a ResourceExpressionEditorSheet, which defines the individual properties that form a resource reference expression.

Ao herdar da ExpressionEditorSheet classe, você deve substituir os seguintes membros:When you inherit from the ExpressionEditorSheet class, you must override the following members:

  • O GetExpressionEditorSheet método para retornar uma implementação de planilha de editor Personalizada.The GetExpressionEditorSheet method to return a custom editor sheet implementation.

  • O ExpressionEditorSheet construtor para implementar ações de inicialização personalizadas para a implementação da planilha do editor de expressão.The ExpressionEditorSheet constructor to implement custom initialization actions for your expression editor sheet implementation.

Notas aos Implementadores

Derive uma folha de editor de expressão personalizada da ExpressionEditorSheet classe, se você estiver definindo um novo tipo de expressão para valores de propriedade de controle e desejar criar a cadeia de caracteres de expressão com base em vários valores de propriedade de expressão.Derive a custom expression editor sheet from the ExpressionEditorSheet class, if you are defining a new expression type for control property values and you want to build the expression string based on multiple expression property values. Uma implementação de classe derivada deve conter o seguinte:A derived class implementation should contain the following: – Uma propriedade pública para cada valor distinto na cadeia de caracteres de expressão que pode ser definida em tempo de design.- A public property for each distinct value in the expression string that can be set at design time.

-Uma implementação do GetExpression() método que forma a cadeia de caracteres de expressão personalizada dos valores de propriedade da planilha do editor.- An implementation of the GetExpression() method that forms the custom expression string from the editor sheet property values.

-Opcionalmente, uma implementação de construtor que define os valores iniciais das propriedades da planilha do editor.- Optionally, a constructor implementation that sets the initial values of the editor sheet properties.

A classe do editor de expressão personalizada associada cria uma instância da folha do editor derivado no GetExpressionEditorSheet(String, IServiceProvider) método, inicializa essa instância com a cadeia de caracteres de expressão atual definida para a propriedade Control e retorna a instância para o designer visual.The associated custom expression editor class creates an instance of the derived editor sheet in the GetExpressionEditorSheet(String, IServiceProvider) method, initializes that instance with the current expression string set for the control property, and returns the instance to the visual designer. O designer visual permite que você defina as propriedades da folha de expressões e, em seguida, chama o GetExpression() método para formar a cadeia de caracteres de expressão a partir dos valores de propriedade da folha de expressões de entrada.The visual designer allows you to set the expression sheet properties, and then calls the GetExpression() method to form the expression string from the input expression sheet property values.

Construtores

ExpressionEditorSheet(IServiceProvider)

Inicializa uma nova instância da classe ExpressionEditorSheet.Initializes a new instance of the ExpressionEditorSheet class.

Propriedades

IsValid

Obtém um valor que indica se a cadeia de caracteres da expressão é válida.Gets a value that indicates whether the expression string is valid.

ServiceProvider

Obtém a implementação do provedor de serviço usada pela folha do editor de expressão.Gets the service provider implementation that is used by the expression editor sheet.

Métodos

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Herdado de Object)
GetExpression()

Quando substituído em uma classe derivada, retorna a cadeia de caracteres de expressão que é formada pelos valores de propriedade de folha de editor de expressão.When overridden in a derived class, returns the expression string that is formed by the expression editor sheet property values.

GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Herdado de Object)

Aplica-se a

Confira também