EditorPart.ApplyChanges Metod

Definition

Sparar värdena i en EditorPart kontroll till motsvarande egenskaper i den associerade WebPart kontrollen.

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

Returer

true om åtgärden att spara värden från EditorPart kontrollen till WebPart kontrollen lyckas, annars (om ett fel inträffar), false.

Exempel

Följande kodexempel visar hur du implementerar ApplyChanges metoden i en anpassad EditorPart kontroll. Den fullständiga kod som krävs för att köra exemplet finns i avsnittet Exempel i klassöversikten EditorPart .

Den första delen av kodexemplet visar implementeringen av ApplyChanges metoden i den anpassade EditorPart klassen med namnet TextDisplayEditorPart. Den här metoden hämtar en referens till den associerade TextDisplayWebPart kontrollen med hjälp av WebPartToEdit egenskapen . Sedan uppdateras värdet för TextDisplayWebPart.FontStyle egenskapen.

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

Den andra delen av kodexemplet visar hur den associerade WebPart kontrollen, TextDisplayWebPart, skapar en samling associerade EditorPart kontroller (i det här fallet finns det bara en EditorPart kontroll med namnet TextDisplayEditorPart i samlingen) i dess implementering av CreateEditorParts metoden. Den här metoden körs när kontrollen går in i TextDisplayWebPart redigeringsläge.

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

Kommentarer

Metoden ApplyChanges är en kritisk metod för en EditorPart kontroll. Den definieras som en abstrakt metod i EditorPart klassen och måste implementeras med ärvda kontroller. Metodens syfte är att spara de värden som en användare har angett i en EditorPart kontroll till motsvarande egenskaper i kontrollen WebPart som refereras i WebPartToEdit egenskapen.

Metoden ApplyChanges anropas när användaren klickar på en knapp som representerar ett OK eller ett tillämpat verb i användargränssnittet (UI).

Anteckningar till implementerare

En klass som härleds från EditorPart klassen måste implementera ApplyChanges() metoden. Den implementerade metoden hämtar en referens till den associerade kontrollen med hjälp av WebPartToEdit egenskapen och uppdaterar sedan egenskaperna för kontrollen med de aktuella värdena i EditorPart kontrollen.

Gäller för

Se även