EditorPart.ApplyChanges Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Guarda os valores num EditorPart controlo para as propriedades correspondentes no controlo associado WebPart .
public:
abstract bool ApplyChanges();public abstract bool ApplyChanges();abstract member ApplyChanges : unit -> boolPublic MustOverride Function ApplyChanges () As BooleanDevoluções
true se a ação de guardar valores do EditorPart controlo para o WebPart controlo for bem-sucedida; caso contrário (se ocorrer um erro), false.
Exemplos
O seguinte exemplo de código demonstra como implementar o ApplyChanges método num controlo personalizado EditorPart . Para o código completo necessário para executar o exemplo, consulte a secção Exemplo da EditorPart visão geral da classe.
A primeira parte do exemplo de código demonstra a implementação do ApplyChanges método na classe personalizada EditorPart chamada TextDisplayEditorPart. Este método obtém uma referência ao controlo associado TextDisplayWebPart usando a WebPartToEdit propriedade. Depois, atualiza o valor da TextDisplayWebPart.FontStyle propriedade.
public override bool ApplyChanges()
{
TextDisplayWebPart part =
(TextDisplayWebPart)WebPartToEdit;
// Update the custom WebPart control with the font style.
part.FontStyle = PartContentFontStyle.SelectedValue;
return true;
}
Public Overrides Function ApplyChanges() As Boolean
Dim part As TextDisplayWebPart = CType(WebPartToEdit, _
TextDisplayWebPart)
' Update the custom WebPart control with the font style.
part.FontStyle = PartContentFontStyle.SelectedValue
Return True
End Function
A segunda parte do exemplo de código mostra como o controlo associado WebPart , TextDisplayWebPart, cria uma coleção de controlos associados EditorPart (neste caso, há apenas um EditorPart controlo nomeado TextDisplayEditorPart na coleção) na sua implementação do CreateEditorParts método. Este método é executado quando o TextDisplayWebPart controlo entra em modo de edição.
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
Observações
O ApplyChanges método é crítico num EditorPart controlo. É definido como um método abstrato na EditorPart classe e deve ser implementado por controlos herdados. O objetivo do método é guardar os valores que o utilizador introduziu num EditorPart controlo para as propriedades correspondentes no WebPart controlo referenciado nessa WebPartToEdit propriedade.
O ApplyChanges método é chamado quando o utilizador clica num botão que representa um OK ou um apply verb na interface de edição (UI).
Notas para Implementadores
Uma classe que deriva da EditorPart classe deve implementar o ApplyChanges() método. O método implementado recebe uma referência ao controlo associado usando a WebPartToEdit propriedade e depois atualiza as propriedades desse controlo com os valores atuais no EditorPart controlo.