EditorPart.ApplyChanges Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Slaat de waarden in een EditorPart besturingselement op in de bijbehorende eigenschappen in het bijbehorende WebPart besturingselement.
public:
abstract bool ApplyChanges();public abstract bool ApplyChanges();abstract member ApplyChanges : unit -> boolPublic MustOverride Function ApplyChanges () As BooleanRetouren
true als de actie van het opslaan van waarden van het EditorPart besturingselement naar het WebPart besturingselement is geslaagd; anders (als er een fout optreedt), false.
Voorbeelden
In het volgende codevoorbeeld ziet u hoe u de ApplyChanges methode implementeert in een aangepast besturingselement EditorPart . Zie de sectie Voorbeeld van het EditorPart klassenoverzicht voor de volledige code die nodig is om het voorbeeld uit te voeren.
Het eerste deel van het codevoorbeeld toont de implementatie van de ApplyChanges methode in de aangepaste EditorPart klasse met de naam TextDisplayEditorPart. Met deze methode wordt een verwijzing naar het bijbehorende TextDisplayWebPart besturingselement opgehaald met behulp van de WebPartToEdit eigenschap. Vervolgens wordt de waarde van de TextDisplayWebPart.FontStyle eigenschap bijgewerkt.
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
In het tweede deel van het codevoorbeeld ziet u hoe het gekoppelde WebPart besturingselement, TextDisplayWebParteen verzameling gekoppelde EditorPart besturingselementen maakt (in dit geval is er slechts één EditorPart besturingselement met de naam TextDisplayEditorPart in de verzameling) in de implementatie van de CreateEditorParts methode. Deze methode wordt uitgevoerd wanneer het besturingselement in de TextDisplayWebPart bewerkingsmodus komt.
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
Opmerkingen
De ApplyChanges methode is een kritieke methode voor een EditorPart besturingselement. Deze wordt gedefinieerd als een abstracte methode in de EditorPart klasse en moet worden geïmplementeerd door overgenomen besturingselementen. Het doel van de methode is om de waarden op te slaan die een gebruiker in een EditorPart besturingselement heeft ingevoerd voor de bijbehorende eigenschappen in het WebPart besturingselement waarnaar wordt verwezen in de WebPartToEdit eigenschap.
De ApplyChanges methode wordt aangeroepen wanneer de gebruiker op een knop klikt die een OK vertegenwoordigt of een werkwoord toepassen in de gebruikersinterface (UI) bewerken.
Notities voor uitvoerders
Een klasse die is afgeleid van de EditorPart klasse, moet de ApplyChanges() methode implementeren. De geïmplementeerde methode haalt een verwijzing naar het bijbehorende besturingselement op met behulp van de WebPartToEdit eigenschap en werkt vervolgens de eigenschappen van dat besturingselement bij met de huidige waarden in het EditorPart besturingselement.