EditorPart.ApplyChanges Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.Web.UI.WebControls.WebParts
Assembly:
System.Web.dll

Salva i valori di un controllo EditorPart nelle proprietà corrispondenti del controllo WebPart associato.

public:
 abstract bool ApplyChanges();
public abstract bool ApplyChanges ();
abstract member ApplyChanges : unit -> bool
Public MustOverride Function ApplyChanges () As Boolean

Restituisce

Boolean

true se l'azione di salvataggio dei valori del controllo EditorPart nel controllo WebPart viene eseguita correttamente; in caso contrario, ovvero se si verificano errori, false.

Esempio

Nell'esempio di codice seguente viene illustrato come implementare il ApplyChanges metodo in un controllo personalizzato EditorPart . Per il codice completo necessario per eseguire l'esempio, vedere la sezione Esempio della panoramica della EditorPart classe.

La prima parte dell'esempio di codice illustra l'implementazione del ApplyChanges metodo nella classe personalizzata denominata EditorPartTextDisplayEditorPart. Questo metodo ottiene un riferimento al controllo associato TextDisplayWebPart utilizzando la WebPartToEdit proprietà . Aggiorna quindi il valore della TextDisplayWebPart.FontStyle proprietà .

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

La seconda parte dell'esempio di codice mostra come il controllo associato WebPart , TextDisplayWebPart, crea una raccolta di controlli associati EditorPart (in questo caso, nella raccolta è presente un EditorPart solo controllo denominato TextDisplayEditorPart nella raccolta) nell'implementazione del CreateEditorParts metodo . Questo metodo viene eseguito quando il controllo entra in TextDisplayWebPart modalità di modifica.

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

Commenti

Il ApplyChanges metodo è un metodo critico su un EditorPart controllo . Viene definito come metodo astratto nella EditorPart classe e deve essere implementato dai controlli ereditati. Lo scopo del metodo consiste nel salvare i valori immessi da un utente in un EditorPart controllo alle proprietà corrispondenti nel WebPart controllo a cui viene fatto riferimento nella WebPartToEdit proprietà .

Il ApplyChanges metodo viene chiamato quando l'utente fa clic su un pulsante che rappresenta un verbo OK o applica nell'interfaccia utente di modifica.

Note per gli implementatori

Una classe che deriva dalla EditorPart classe deve implementare il ApplyChanges() metodo . Il metodo implementato ottiene un riferimento al controllo associato utilizzando la WebPartToEdit proprietà e quindi aggiorna le proprietà di tale controllo con i valori correnti nel EditorPart controllo .

Si applica a

Vedi anche