EditorPart.ApplyChanges Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Salva os valores em um controle EditorPart para as propriedades correspondentes no controle WebPart associado.
public:
abstract bool ApplyChanges();public abstract bool ApplyChanges ();abstract member ApplyChanges : unit -> boolPublic MustOverride Function ApplyChanges () As BooleanRetornos
true se a ação de salvar os valores do controle EditorPart no controle WebPart for bem-sucedida; caso contrário (se ocorrer um erro), false.
Exemplos
O exemplo de código a seguir demonstra como implementar o ApplyChanges método em um controle personalizado EditorPart . Para obter o código completo necessário para executar o exemplo, consulte a seção Exemplo da visão geral da EditorPart classe.
A primeira parte do exemplo de código demonstra a implementação do ApplyChanges método na classe personalizada EditorPart chamada TextDisplayEditorPart. Esse método obtém uma referência ao controle associado TextDisplayWebPart usando a WebPartToEdit propriedade . Em seguida, ele 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 controle associado WebPart , TextDisplayWebPart, cria uma coleção de controles associados EditorPart (nesse caso, há apenas um EditorPart controle chamado TextDisplayEditorPart na coleção) em sua implementação do CreateEditorParts método . Esse método é executado quando o TextDisplayWebPart controle entra no 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
Comentários
O ApplyChanges método é um método crítico em um EditorPart controle . Ele é definido como um método abstrato na EditorPart classe e deve ser implementado por controles herdados. A finalidade do método é salvar os valores que um usuário inseriu em um EditorPart controle para as propriedades correspondentes no WebPart controle referenciado na WebPartToEdit propriedade .
O ApplyChanges método é chamado quando o usuário clica em um botão que representa um ok ou um verbo apply na interface do usuário (interface do usuário) de edição.
Notas aos Implementadores
Uma classe derivada da EditorPart classe deve implementar o ApplyChanges() método . O método implementado obtém uma referência ao controle associado usando a WebPartToEdit propriedade e atualiza as propriedades desse controle com os valores atuais no EditorPart controle.
