EditorPart.ApplyChanges Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Salva i valori in un EditorPart controllo nelle proprietà corrispondenti nel controllo associato WebPart .
public:
abstract bool ApplyChanges();public abstract bool ApplyChanges();abstract member ApplyChanges : unit -> boolPublic MustOverride Function ApplyChanges () As BooleanRestituisce
true se l'azione di salvataggio dei valori dal EditorPart controllo al WebPart controllo ha esito positivo; in caso contrario, se si verifica un errore, 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 in che modo il controllo associato WebPart , TextDisplayWebPart, crea una raccolta di controlli associati EditorPart (in questo caso, nella raccolta è presente un EditorPart solo controllo denominato TextDisplayEditorPart ) 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 in un EditorPart controllo . Viene definito come metodo astratto nella EditorPart classe e deve essere implementato da 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 si fa riferimento nella WebPartToEdit proprietà .
Il ApplyChanges metodo viene chiamato quando l'utente fa clic su un pulsante che rappresenta un verbo OK o un verbo di applicazione 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 .
