|
|
ASP.NET QuickStart Príručka
Tvorba vlastných Web Parts
Odkedy môžu byť serverové ovládacie prvky ASP.NET použité ako Web Parts, môžete písať vlastné
súčiastky použitím používateľských ovládacích prvkov alebo vlastných serverových ovládacích prvkov.
Príklad ukazuje používateľskú súčiastku (user control web part), ktorá akceptuje vstupný text. Používateľská súčiastka
implementuje rozhranie IWebPart aby poskytla základne zobrazovacie vlastnosti webovej súčiastky (Ako nadpis a popis).
VB User Control Web Part
Webové súčiastky môžete písať ako vlastné serverové ovládacie prvky. Hoci môžete dediť od ktoréhokoľvek
ovládacieho prvku, ASP.NET poskytuje základnú triedu WebPart, ktorá zjednodušuje prispôsobenie štandardného správania
ovládacieho prvku.
Príklad nižšie ukazuje prvok WebPart, ktorý zobrazuje text. Prvok má vlastnosť nazvanú ControlText, ktorá
určuje text, ktorý sa má zobraziť. Zároveň prekrýva vlastnosti AllowMinimize a AllowClose aby používateľovi
zabránil minimalizovať, prípadne uzavrieť súčiastku.
VB Custom Control Web Part
Webová súčiastka môže poskytnúť vlastné príkazy aby umožnila používateľom ovplyvniť svoj vnútorný stav.
Zóna je zodpovedná za ukazovanie príkazov pre webovú súčiastku; vo väčšine prípadov sú príkazy zobrazené v ponuke príkazov webovej súčiastky. V predchádzajúcom príklade na editáciu, položka „Edit“ v menu bola príkazom len v režime editácie.
Aby ste poskytli vlastné príkazy pre ovládací prvok, ktorý dedí od WebPart, môžete preťažiť vlastnosť Verbs. Vytvorte objekt WebPartVerbCollection s kolekciou objektov
WebPartVerb a vráťte ho. Príklad ukazuje kombináciu príkazov poskytnutých základnou triedou a nového príkazu
nazvaného "Save". Príkaz je zobrazený v ponuke príkazov súčiastky.
VB Adding Custom Verbs
Webová súčiastka môže určiť vlastnosti, ktoré môžu byť editované používateľom.
Ak chcete aby vlastnosť bola editovateľná, označte jej deklaráciu atribútom
WebBrowsable. EditorZone na stránke musí samozrejme obsahovať editačnú súčiastku
schopnú editovať vlastné vlastnosti. Môžete použiť PropertyGridEditorPart.
Príklad ukazuje editovateľnú vlastnosť Text súčiastky a na editáciu používa PropertyGridEditorPart.
- Prihláste sa na stránku.
- Vyberte možnosť "Edit" z prvku DropDownList v menu.
- Kliknite na rolovaciu šípku v menu príkazov súčiastky a vyberte možnosť "Edit". Zobrazí sa editor v ktorom sa nachádza property grid ukazujúci editovateľnú vlastnosť Text.
VB Editing Web Part Properties
Zároveň môžete poskytnúť vlastné editačné súčiastky pre editáciu vlastností súčiastok, ktoré
sa zobrazia v editačnej zóne, keď používateľ edituje webovú súčiastku.
Aby ste vytvorili vlastnú editačnú súčiastku, odvoďte ju od prvku EditorWebPart. Prvok
EditorWebPart je kompozitný ovládací prvok, takže môžete prekryť metódu CreateChildControls a vytvoriť
ovládacie prvky pre súčiastku. Tak isto musíte prekryť metódy ApplyChanges a SyncChanges kvôli aplikácii zmien na súčiastku ktorú editujete
a synchronizácii zmien s ostatnými súčiastkami.
Aby ste poskytli vlastné editačné súčiastky, môžete implementovať rozhranie IWebEditable na súčiastke
a implementovať metódu CreateEditorParts a vlastnosť WebBrowsableObject.
Metóda CreateEditorParts vracia kolekciu editačných súčiastok.
Príklad ukazuje vlastnú editačnú súčiastku na editáciu vlastnosti webovej súčiastky.
VB Writing a Custom Editor Part
|
|