EditorPart.ApplyChanges Método

Definição

Namespace:

System.Web.UI.WebControls.WebParts

Assembly:

System.Web.dll

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 -> bool

Public MustOverride Function ApplyChanges () As Boolean

Retornos

Boolean

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.

Confira também

• SyncChanges()
• IWebEditable
• controles de Web Parts ASP.NET