IWebEditable.CreateEditorParts 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 colección de controles EditorPart personalizados asociados a un control de servidor que implementa la interfaz IWebEditable.
public:
System::Web::UI::WebControls::WebParts::EditorPartCollection ^ CreateEditorParts();
public System.Web.UI.WebControls.WebParts.EditorPartCollection CreateEditorParts ();
abstract member CreateEditorParts : unit -> System.Web.UI.WebControls.WebParts.EditorPartCollection
Public Function CreateEditorParts () As EditorPartCollection
Devoluciones
Un objeto EditorPartCollection que contiene la colección de controles EditorPart personalizados asociados a un control de servidor.
Ejemplos
En el ejemplo de código siguiente se muestra una invalidación del CreateEditorParts método en un control personalizado WebPart . El código fuente completo necesario para ejecutar el ejemplo se encuentra en la sección Ejemplo del tema de información general de la IWebEditable clase.
El ejemplo de código contiene ambos miembros de la IWebEditable interfaz. Tenga en cuenta que la invalidación del CreateEditorParts método crea un ArrayList objeto para recopilar uno o varios controles personalizados EditorPart y, a continuación, usa la lista para crear el EditorPartCollection objeto .
public override EditorPartCollection CreateEditorParts()
{
ArrayList editorArray = new ArrayList();
TextDisplayEditorPart edPart = new TextDisplayEditorPart();
edPart.ID = this.ID + "_editorPart1";
editorArray.Add(edPart);
EditorPartCollection editorParts =
new EditorPartCollection(editorArray);
return editorParts;
}
public override object WebBrowsableObject
{
get { return this; }
}
Public Overrides Function CreateEditorParts() _
As EditorPartCollection
Dim editorArray As New ArrayList()
Dim edPart as New TextDisplayEditorPart()
edPart.ID = Me.ID & "_editorPart1"
editorArray.Add(edPart)
Dim editorParts As New EditorPartCollection(editorArray)
Return editorParts
End Function
Public Overrides ReadOnly Property WebBrowsableObject() _
As Object
Get
Return Me
End Get
End Property
Comentarios
El CreateEditorParts método permite crear una colección de todos los controles personalizados EditorPart asociados a su control personalizado, WebPart control o control de usuario, y devolverlos como un EditorPartCollection objeto . El WebPartManager control toma la colección y crea instancias de todos los EditorPart controles cada vez que el control de servidor entra en modo de edición.
Normalmente, este método se implementa en un control personalizado WebPart reemplazando su CreateEditorParts método. En el método , se crean instancias de los controles personalizados EditorPart que desea asociar a los controles, se agregan a un EditorPartCollection objeto y, a continuación, se devuelve ese objeto. A continuación, la colección de EditorPart controles se asigna a la EditorParts propiedad de la EditorZoneBase zona.
Nota
Cualquier EditorPart que se agregue a la colección de controles de EditorPart una implementación del CreateEditorParts método debe tener un valor asignado a su propiedad ID; de lo contrario, se producirá una excepción cuando se asigne la colección a la EditorParts propiedad .
Notas a los implementadores
El EditorPartCollection objeto que devuelve el CreateEditorParts() método es de solo lectura y no tiene ningún método accesible para agregarle controles individuales. Sin embargo, en la invalidación o implementación del método, puede crear otro tipo de ICollection objeto, como , ArrayListpara contener todos los controles personalizados EditorPart y pasarlo al constructor al crear un nuevo EditorPartCollection objeto. Para obtener un ejemplo de código, consulte la sección Ejemplo.