IPersistComponentSettings.SettingsKey Propiedad
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í.
Obtiene o establece el valor de la clave de configuración de aplicación para la instancia actual del control.
public:
property System::String ^ SettingsKey { System::String ^ get(); void set(System::String ^ value); };public string SettingsKey { get; set; }member this.SettingsKey : string with get, setPublic Property SettingsKey As StringValor de propiedad
String que contiene la clave de configuración para la instancia actual del control.
Comentarios
Use la propiedad para eliminar la SettingsKey ambigüedad de los grupos de propiedades de configuración de la aplicación cuando hay varias instancias de la misma clase contenedora. Por ejemplo, si un control contiene una clase contenedora asociada, la colocación de varias instancias del mismo control en la misma aplicación normalmente dará lugar a varias instancias de la clase contenedora. Solo se requiere una clave de configuración cuando los datos de configuración difieren por instancia; por ejemplo, la ubicación de los controles colocados dinámicamente.
Las siguientes reglas generales se aplican al uso de SettingsKey:
Un control, como cualquier clase, puede contener cero o más clases de configuración de aplicación, derivadas de ApplicationSettingsBase. Cada clase de configuración contiene su propia ApplicationSettingsBase.SettingsKey propiedad, lo que ayuda a eliminar la ambigüedad de varias instancias de esa clase.
Un control debe separar sus datos por instancia y sus datos compartidos en diferentes clases de configuración.
Para un control con cualquier dato de configuración por instancia, el
getdescriptor de acceso de la SettingsKey propiedad debe tener como valor predeterminado el Name del control . En la mayoría de los casos, el nombre del control será único dentro de una aplicación. Si el control solo contiene datos de configuración compartidos,getel valor predeterminadonulles .El
setdescriptor de acceso de esta propiedad debe implementarse para distinguir entre las clases de configuración que contienen datos de configuración por instancia y compartidos. Para cada clase de configuración que contenga datos por instancia,setsolo debe pasarse a la ApplicationSettingsBase.SettingsKey propiedad de la clase settings. Para las clases de configuración que contienen datos compartidos,setno debe realizar ninguna acción para esa clase de configuración.
