EditorPart.ApplyChanges Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Uloží hodnoty v ovládacím prvku EditorPart do odpovídajících vlastností v přidruženém WebPart ovládacím prvku.
public:
abstract bool ApplyChanges();
public abstract bool ApplyChanges ();
abstract member ApplyChanges : unit -> bool
Public MustOverride Function ApplyChanges () As Boolean
Návraty
true
pokud je akce ukládání hodnot z EditorPart ovládacího prvku do WebPart ovládacího prvku úspěšná; v opačném případě (pokud dojde k chybě), false
.
Příklady
Následující příklad kódu ukazuje, jak implementovat metodu ApplyChanges ve vlastním EditorPart ovládacím prvku. Úplný kód potřebný ke spuštění příkladu najdete v části Příklad v přehledu EditorPart třídy.
První část příkladu kódu ukazuje implementaci ApplyChanges metody ve vlastní EditorPart třídě s názvem TextDisplayEditorPart
. Tato metoda získá odkaz na přidružený TextDisplayWebPart
ovládací prvek pomocí WebPartToEdit vlastnosti . Potom aktualizuje hodnotu TextDisplayWebPart.FontStyle
vlastnosti.
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
Druhá část příkladu kódu ukazuje, jak přidružený WebPart ovládací prvek , TextDisplayWebPart
vytvoří kolekci přidružených EditorPart ovládacích prvků (v tomto případě je v kolekci pouze jeden EditorPart ovládací prvek pojmenovaný TextDisplayEditorPart
) v implementaci CreateEditorParts metody. Tato metoda se spustí, TextDisplayWebPart
když ovládací prvek přejde do režimu úprav.
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
Poznámky
Metoda ApplyChanges je kritickou metodou EditorPart ovládacího prvku. Je definován jako abstraktní metoda ve EditorPart třídě a musí být implementována zděděnými ovládacími prvky. Účelem metody je uložit hodnoty, které uživatel zadal do EditorPart ovládacího prvku, do odpovídajících vlastností v ovládacím WebPart prvku, na který odkazuje vlastnost WebPartToEdit .
Metoda ApplyChanges je volána, když uživatel klikne na tlačítko představující OK nebo příkaz použít v uživatelském rozhraní pro úpravy.
Poznámky pro implementátory
Třída, která je odvozena z EditorPart třídy musí implementovat metodu ApplyChanges() . Implementovaná metoda získá odkaz na přidružený ovládací prvek pomocí WebPartToEdit vlastnosti a potom aktualizuje vlastnosti tohoto ovládacího prvku aktuálními hodnotami v ovládacím EditorPart prvku.