EditorPart.SyncChanges 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.
Ruft die Eigenschaftswerte aus einem WebPart-Steuerelement für das zugeordnete EditorPart-Steuerelement ab.
public:
abstract void SyncChanges();public abstract void SyncChanges ();abstract member SyncChanges : unit -> unitPublic MustOverride Sub SyncChanges ()Beispiele
Im folgenden Codebeispiel wird veranschaulicht, wie die SyncChanges -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 SyncChanges -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 abgerufen und aktualisiert, welches Element im Dropdownlistensteuerelement (auf das von der TextDisplayEditorPart.PartContentFontStyle -Eigenschaft verwiesen wird) für das benutzerdefinierte EditorPart Steuerelement ausgewählt ist.
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
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 SyncChanges -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 aktuellen Werte aus dem Steuerelement abzurufen, auf das WebPart in der WebPartToEdit -Eigenschaft verwiesen wird, und die Felder im EditorPart Steuerelement mit diesen Werten zu aktualisieren, sodass ein Benutzer sie bearbeiten kann.
Die SyncChanges -Methode wird aufgerufen, wenn sich die Werte im zugeordneten WebPart Steuerelement möglicherweise geändert haben. Für jedes EditorPart Steuerelement ruft die EditorZoneBase Zone, die das Steuerelement enthält, die SyncChanges -Methode sofort nach dem Aufrufen der ApplyChanges -Methode auf, sodass die Werte im EditorPart Steuerelement immer mit den Werten im zugeordneten WebPart Steuerelement synchronisiert werden. Ein weiterer Fall, in dem die SyncChanges -Methode aufgerufen wird, ist, wenn ein Steuerelement in den WebPart Bearbeitungsmodus wechselt.
Hinweis
Die SyncChanges -Methode wird nach der ApplyChanges -Methode nicht aufgerufen, wenn diese Methode zurückgibt false, da in diesem Fall ein Fehler aufgetreten ist.
Hinweise für Ausführende
Eine Klasse, die von der EditorPart -Klasse abgeleitet ist, muss die SyncChanges() -Methode implementieren. Die implementierte Methode ruft mithilfe der -Eigenschaft einen Verweis auf das WebPartToEdit zugeordnete Steuerelement ab und aktualisiert das EditorPart Steuerelement dann mit den Eigenschaftenwerten des zugeordneten WebPart Steuerelements.
