EditorPart.SyncChanges 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.
Haalt de eigenschapswaarden op uit een WebPart besturingselement voor het bijbehorende EditorPart besturingselement.
public:
abstract void SyncChanges();public abstract void SyncChanges();abstract member SyncChanges : unit -> unitPublic MustOverride Sub SyncChanges ()Voorbeelden
In het volgende codevoorbeeld ziet u hoe u de SyncChanges 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 SyncChanges 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 opgehaald en wordt bijgewerkt welk item is geselecteerd in het besturingselement voor de vervolgkeuzelijst (waarnaar wordt verwezen door de TextDisplayEditorPart.PartContentFontStyle eigenschap) op het aangepaste EditorPart besturingselement.
public override void SyncChanges()
{
TextDisplayWebPart part =
(TextDisplayWebPart)WebPartToEdit;
String currentStyle = part.FontStyle;
// Select the current font style in the drop-down control.
foreach (ListItem item in PartContentFontStyle.Items)
{
if (item.Value == currentStyle)
{
item.Selected = true;
break;
}
}
}
Public Overrides Sub SyncChanges()
Dim part As TextDisplayWebPart = CType(WebPartToEdit, _
TextDisplayWebPart)
Dim currentStyle As String = part.FontStyle
' Select the current font style in the drop-down control.
Dim item As ListItem
For Each item In PartContentFontStyle.Items
If item.Value = currentStyle Then
item.Selected = True
Exit For
End If
Next item
End Sub
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 SyncChanges 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 huidige waarden op te halen uit het WebPart besturingselement waarnaar in de WebPartToEdit eigenschap wordt verwezen en de velden in het EditorPart besturingselement bij te werken met deze waarden, zodat een gebruiker deze kan bewerken.
De SyncChanges methode wordt aangeroepen wanneer de waarden in het bijbehorende WebPart besturingselement mogelijk zijn gewijzigd. Voor elk EditorPart besturingselement roept de EditorZoneBase zone met het besturingselement de SyncChanges methode aan direct na het aanroepen van de ApplyChanges methode, zodat de waarden in het EditorPart besturingselement altijd worden gesynchroniseerd met de waarden in het bijbehorende WebPart besturingselement. Een ander geval waarin de SyncChanges methode wordt aangeroepen, is wanneer een WebPart besturingselement de bewerkingsmodus opent.
Note
De SyncChanges methode wordt niet aangeroepen na de ApplyChanges methode als deze methode retourneert false, omdat in dat geval een fout is opgetreden.
Notities voor uitvoerders
Een klasse die is afgeleid van de EditorPart klasse, moet de SyncChanges() methode implementeren. De geïmplementeerde methode haalt een verwijzing naar het bijbehorende besturingselement op met behulp van de WebPartToEdit eigenschap en werkt vervolgens het EditorPart besturingselement bij met de eigenschapswaarden van het bijbehorende WebPart besturingselement.