EditorPart.ApplyChanges Methode

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.

Der erste Teil des Codebeispiels veranschaulicht die Implementierung der ApplyChanges -Methode in der benutzerdefinierten EditorPart Klasse namens TextDisplayEditorPart. 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, wie das zugeordnete WebPart Steuerelement , TextDisplayWebPart, eine Auflistung von zugeordneten EditorPart Steuerelementen (in diesem Fall gibt es nur ein EditorPart Steuerelement namens 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, die ein Benutzer in ein EditorPart Steuerelement eingegeben hat, in den entsprechenden Eigenschaften des Steuerelements zu speichern, 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 WebPartToEdit der -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

• SyncChanges()
• IWebEditable
• ASP.NET Webparts-Steuerelemente