EditorPart.SyncChanges Methode

  • Referenz

Definition

Namespace:
System.Web.UI.WebControls.WebParts
Assembly:
System.Web.dll

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 -> unit
Public 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.

Der erste Teil des Codebeispiels veranschaulicht die Implementierung der SyncChanges Methode in der benutzerdefinierten EditorPart Klasse namens TextDisplayEditorPart. Diese Methode ruft einen Verweis auf das zugeordnete TextDisplayWebPart Steuerelement mithilfe der WebPartToEdit Eigenschaft ab. Anschließend wird der Wert der TextDisplayWebPart.FontStyle Eigenschaft abgerufen und aktualisiert, welches Element im Dropdownlistensteuerelement (auf die TextDisplayEditorPart.PartContentFontStyle Eigenschaft verwiesen wird) im benutzerdefinierten 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, wie das zugeordnete WebPart Steuerelement, TextDisplayWebParterstellt eine Sammlung zugeordneter EditorPart Steuerelemente (in diesem Fall gibt es nur ein EditorPart Steuerelement, das in der Auflistung benannt TextDisplayEditorPart ist) in der Implementierung der CreateEditorParts Methode. Diese Methode wird ausgeführt, wenn das TextDisplayWebPart Steuerelement den Bearbeitungsmodus eingibt.

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 wird als abstrakte Methode in der EditorPart Klasse definiert und muss durch geerbte Steuerelemente 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 aktualisieren, damit ein Benutzer sie bearbeiten kann.

Die SyncChanges Methode wird aufgerufen, wenn sich die Werte im zugehörigen WebPart Steuerelement möglicherweise geändert haben. Für jedes EditorPart Steuerelement ruft die EditorZoneBase Zone, die das Steuerelement enthält, die SyncChanges Methode unmittelbar nach dem Aufrufen der ApplyChanges Methode auf, sodass die Werte im Steuerelement immer mit den Werten im EditorPart zugehörigen WebPart Steuerelement synchronisiert werden. Ein weiterer Fall, bei dem die SyncChanges Methode aufgerufen wird, ist, wenn ein WebPart Steuerelement den Bearbeitungsmodus eingibt.

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 wird, muss die SyncChanges() Methode implementieren. Die implementierte Methode ruft einen Verweis auf das zugeordnete Steuerelement mithilfe der WebPartToEdit Eigenschaft ab und aktualisiert dann das EditorPart Steuerelement mit den Eigenschaftenwerten aus dem zugeordneten WebPart Steuerelement.

Gilt für

Siehe auch