EditorPart.ApplyChanges Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Speichert die Werte in einem EditorPart-Steuerelement in den entsprechenden Eigenschaften im zugeordneten WebPart-Steuerelement.
public:
abstract bool ApplyChanges();public abstract bool ApplyChanges ();abstract member ApplyChanges : unit -> boolPublic MustOverride Function ApplyChanges () As BooleanGibt zurück
true, wenn das Speichern von Werten vom EditorPart-Steuerelement im WebPart-Steuerelement erfolgreich war, andernfalls (wenn ein Fehler auftritt) false.
Beispiele
Im folgenden Codebeispiel wird veranschaulicht, wie die ApplyChanges -Methode in einem benutzerdefinierten EditorPart Steuerelement implementiert wird. Den vollständigen Code, der zum Ausführen des Beispiels erforderlich ist, finden Sie im Abschnitt Beispiel der EditorPart Klassenübersicht.
Im ersten Teil des Codebeispiels wird die Implementierung der ApplyChanges -Methode in der benutzerdefinierten EditorPart Klasse mit dem Namen TextDisplayEditorPartveranschaulicht. Diese Methode ruft mithilfe der -Eigenschaft einen Verweis auf das WebPartToEdit zugeordnete TextDisplayWebPart Steuerelement ab. Anschließend wird der Wert der TextDisplayWebPart.FontStyle -Eigenschaft aktualisiert.
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
Der zweite Teil des Codebeispiels zeigt, TextDisplayWebPartwie das zugeordnete WebPart Steuerelement , , eine Auflistung von zugeordneten EditorPart Steuerelementen (in diesem Fall gibt es nur ein EditorPart Steuerelement mit dem Namen TextDisplayEditorPart in der Auflistung) in seiner Implementierung der CreateEditorParts -Methode erstellt. Diese Methode wird ausgeführt, wenn das Steuerelement in den TextDisplayWebPart Bearbeitungsmodus wechselt.
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
Hinweise
Die ApplyChanges -Methode ist eine kritische Methode für ein EditorPart Steuerelement. Sie ist als abstrakte Methode in der EditorPart -Klasse definiert und muss von geerbten Steuerelementen implementiert werden. Der Zweck der Methode besteht darin, die Werte zu speichern, die ein Benutzer in ein EditorPart Steuerelement eingegeben hat, in den entsprechenden Eigenschaften des Steuerelements, auf das WebPart in der WebPartToEdit -Eigenschaft verwiesen wird.
Die ApplyChanges -Methode wird aufgerufen, wenn der Benutzer auf eine Schaltfläche klickt, die ein OK- oder apply-Verb in der Bearbeitungs-Benutzeroberfläche darstellt.
Hinweise für Ausführende
Eine Klasse, die von der EditorPart -Klasse abgeleitet ist, muss die ApplyChanges() -Methode implementieren. Die implementierte Methode ruft mithilfe der WebPartToEdit -Eigenschaft einen Verweis auf das zugeordnete Steuerelement ab und aktualisiert dann die Eigenschaften dieses Steuerelements mit den aktuellen Werten im EditorPart Steuerelement.
