EditorPart.ApplyChanges Methode

Definition

Speichert die Werte in einem EditorPart-Steuerelement in den entsprechenden Eigenschaften im zugeordneten WebPart-Steuerelement.

public:
 abstract bool ApplyChanges();
public abstract bool ApplyChanges ();
abstract member ApplyChanges : unit -> bool
Public MustOverride Function ApplyChanges () As Boolean

Gibt zurück

true, wenn das Speichern von Werten vom EditorPart-Steuerelement im WebPart-Steuerelement erfolgreich war, andernfalls (wenn ein Fehler auftritt) false.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die ApplyChanges -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 ApplyChanges -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 aktualisiert.

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

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 ApplyChanges -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 Werte zu speichern, die ein Benutzer in ein EditorPart Steuerelement eingegeben hat, in den entsprechenden Eigenschaften des Steuerelements, auf das WebPart in der WebPartToEdit -Eigenschaft verwiesen wird.

Die ApplyChanges -Methode wird aufgerufen, wenn der Benutzer auf eine Schaltfläche klickt, die ein OK- oder apply-Verb in der Bearbeitungs-Benutzeroberfläche darstellt.

Hinweise für Ausführende

Eine Klasse, die von der EditorPart -Klasse abgeleitet ist, muss die ApplyChanges() -Methode implementieren. Die implementierte Methode ruft mithilfe der WebPartToEdit -Eigenschaft einen Verweis auf das zugeordnete Steuerelement ab und aktualisiert dann die Eigenschaften dieses Steuerelements mit den aktuellen Werten im EditorPart Steuerelement.

Gilt für:

Weitere Informationen