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 EditorPart prvku do odpovídajících vlastností přidruženého WebPart ovládacího prvku.
public:
abstract bool ApplyChanges();public abstract bool ApplyChanges();abstract member ApplyChanges : unit -> boolPublic MustOverride Function ApplyChanges () As BooleanNávraty
true pokud akce ukládání hodnot z EditorPart ovládacího prvku do WebPart ovládacího prvku je úspěšná; jinak (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 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 , TextDisplayWebPartvytvoří kolekci přidružených EditorPart ovládacích prvků (v tomto případě existuje pouze jeden EditorPart ovládací prvek pojmenovaný TextDisplayEditorPart v kolekci) v jeho implementaci CreateEditorParts metody. Tato metoda se spustí, když TextDisplayWebPart 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 kritická metoda EditorPart ovládacího prvku. Je definována 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í WebPart ovládacího prvku, na který se odkazuje ve WebPartToEdit vlastnosti.
Metoda ApplyChanges se volá, když uživatel klikne na tlačítko představující OK nebo použít příkaz 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 pak aktualizuje vlastnosti tohoto ovládacího prvku s aktuálními hodnotami v ovládacím EditorPart prvku.
