EditorPart.ApplyChanges Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
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.