ExpressionEditor.GetExpressionEditorSheet(String, IServiceProvider) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Devuelve una hoja del editor de expresiones que está asociada al actual editor de expresiones.
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.ExpressionEditorSheetPublic Overridable Function GetExpressionEditorSheet (expression As String, serviceProvider As IServiceProvider) As ExpressionEditorSheetParámetros
- expression
- String
La cadena de expresión establecida para una propiedad de control, utilizada para inicializar la hoja del editor de expresiones.
- serviceProvider
- IServiceProvider
Implementación del proveedor de servicios proporcionada por el host del diseñador, que se utiliza para obtener servicios en tiempo de diseño adicionales.
Devoluciones
Una hoja ExpressionEditorSheet que define las propiedades de expresión personalizadas.
Comentarios
El GetExpressionEditorSheet método devuelve una ExpressionEditorSheet implementación que define las cadenas que se combinan para formar una expresión personalizada. El diseñador visual usa una hoja del editor de expresiones para solicitar una o varias cadenas que se combinan en una expresión personalizada. El método de clase base devuelve una hoja de editor de expresiones predeterminada, que usa una sola cadena de entrada para formar la expresión. La hoja del editor de expresiones define la cuadrícula de propiedades de la expresión. Por lo tanto, las propiedades que expone el editor de expresiones se convierten en propiedades que se pueden definir para la expresión en el cuadro de diálogo.
Opcionalmente, las clases que derivan de la ExpressionEditor clase pueden invalidar el GetExpressionEditorSheet método para proporcionar una hoja de editor de expresiones personalizada. Una hoja del editor de expresiones personalizada puede permitir la entrada en tiempo de diseño para varias propiedades, que se combinan juntas para formar la cadena de expresión.
Por ejemplo, la ResourceExpressionEditor clase se deriva de la ExpressionEditor clase y proporciona una implementación para evaluar y asociar una referencia de cadena de recursos con una propiedad de control en tiempo de diseño. La ResourceExpressionBuilder clase está asociada al prefijo Resources de expresión y a la ResourceExpressionEditor implementación. El ResourceExpressionEditor.GetExpressionEditorSheet método devuelve , ResourceExpressionEditorSheetque define las propiedades individuales que forman una expresión de referencia de recursos.
Notas a los desarrolladores de herederos
Normalmente, para proporcionar un nuevo tipo de expresión en tiempo de diseño, se define un prefijo de expresión único y se proporcionan implementaciones personalizadasExpressionBuilder.ExpressionEditor Opcionalmente, puede proporcionar una implementación personalizada ExpressionEditorSheet que defina las propiedades que se usan para formar la expresión. Aunque el archivo de configuración define el prefijo, también debe aplicar un ExpressionPrefixAttribute objeto y un ExpressionEditorAttribute objeto .
Invalide el GetExpressionEditorSheet(String, IServiceProvider) método para devolver una hoja del editor de expresiones que define la entrada en tiempo de diseño para varias propiedades de una expresión personalizada. Al seleccionar una propiedad de control y el tipo de editor de expresiones, el diseñador visual llama al GetExpressionEditorSheet(String, IServiceProvider) método y, a continuación, proporciona la cadena de expresión actual establecida para la propiedad de control. Use expression para establecer los valores iniciales de las propiedades de expresión. Use serviceProvider para inicializar un constructor de hoja de expresiones personalizada y para tener acceso a los servicios proporcionados por el host del diseñador. Por ejemplo, llame al GetService(Type) método con el IWebApplication tipo para tener acceso a los elementos del proyecto, documentos o detalles del archivo de configuración que se proporcionan a través del diseñador visual.