EditorPart.SyncChanges Methode

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.

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.

Weitere Informationen

• IWebEditable
• ApplyChanges()
• ASP.NET Webpart-Steuerelemente