ASP.NET QuickStart Tutorial

Novinky v 2.0

ASP.NET 2.0 bolo navrhnuté s ohľadom na rozšíriteľnosť a podporu zásuvných modulov. Zároveň umožňuje nahradiť vstavané správanie (behavior) v ASP.NET z Vašou vlastnou implementáciou. Viacej k rozšíriteľnosti nájdete v nasledujúcej sekcii:

Životný cyklus štruktúry stránky (Page framework lifecycle) - má dodatočné kroky a procesy;
Beh serverových ovládacích prvkov(Server controls runtime) - Môžete napísať vlastné ovládacie prvky pre podporu nových funkcii ako:
1. Riadenie stavu (State management) ako je view-state a control-state, alebo požadovanie šifrovania stránky (requesting encryption of the page-state);
2. Môžete napísať adaptéry stránky a ovládacích prvkov (control and page adapters), ak od Vašich ovládacích prvkov alebo stránok požadujete správanie, ktoré je závislé od prehliadača, prostriedku alebo triedy prostriedku (device class) alebo značiek (markup). Adaptéry sa zapájajú do životného cyklu behu programu
3. Nové ovládacie prvky dátového zdroja a dátovo-viazané ovládacie prvky umožňujú pridať deklaratívnu podporu dátového viazania pre nových poskytovateľov, tak že napíšete vlastné dátovo-viazané ovládacie prvky, ktoré budú týchto poskytovateľov reprezentovať;
4. Webové zdroje, umožňujúce vkladanie zdrojov ako súbory skriptov klienta;
5. Používanie rozšírených funkcií riadenia klientských skriptov;
6. Využitie funkcii témovania(theming) alebo filtrácie prostriedkov (device filtering) v ASP.NET, alebo;
7. Callbacks - Ak vývojár stránky alebo ovládacieho prvku potrebuje uskutočniť akcie, ktoré vyžadujú komunikáciu zo serverom, bez kompletného postback-u, môžu využiť spätné volania (callbacks);
Page-state - Okrem spracovania view-state a control-state v ovládacom prvku môžete tiež rozšíriť tzv. "page-state persister" používaný na spracovanie kolektívneho stavu stránky;
Dizajnový čas serverových ovládacích prvkov - Dizajnérske triedy priradené k serverovým ovládacím prvkom poskytujú spôsoby ako editovať ovládací prvok vo vizuálnom dizajnéri. Môžete napísať dizajnéry ovládacích prvkov ak potrebujete editačné funkcie ako editovanie regiónov (region-editing), editovanie na základe úloh (task-based editing), maľovanie (painting) a editovanie šablón (template-editing);
Poskytovatelia aplikačných služieb (Application service providers) - Všetky vstavané služby v ASP.NET 2.0 sú plne rozšíriteľné pomocou registračného modelu, založenom na poskytovateľoch (provider-based registration model). Model zahŕňa Členstvo (Membership), Roly (Roles), Personalizáciu (Personalization), Počítadlá (Site Counters), Profil (Profile), Stav Session (Session State), Stránkovú navigáciu (Site Navigation) a Webové udalosti (Web Events).
Stavitele výrazov (Expression builders) - Môžete pridať vlastný staviteľ výrazov (expression builder) pre podporu implementácie deklaratívneho nahradzovania hodnôt vo fázach analýzy a kompilácie. Stavitele výrazov môžu poskytovať podporu počas behu programu aj počas dizajnovania;
Lokalizácia - Namiesto používania ResX súborov, môžete implementovať Vašich vlastných poskytovateľov zdrojov pre podporu behového a dizajnového lokalizačného modelu, ktoré získavajú údaje z rôznych zdrojov (napríklad dátové úložiská);
Kompilácia a pred-kompilácia - Do kompilačného systému ASP.NET môžete pridať príponu nového súborového formátu použitím poskytovateľov zostavovania(build providers). ASP.NET 2.0 používa poskytovateľov zostavovania(build providers) pre súbory WSDL slúžiacich na kompiláciu zástupcov webových služieb a pre súbory XSD na kompiláciu silno typových dátových množín(data sets), ktoré sú umiestnené v adresári App_Code. Ak chcete poskytovať Váš webový obsah z iného zdroja akým sú tradičné súbory, potom môžete implementovať poskytovateľ virtuálnej cesty (virtual path provider).

Táto časť hovorí o uvedených, ako aj ďalších funkciách rozšíriteľnosti v ASP.NET 2.0.

Životný cyklus štruktúry stránky (Page framework lifecycle)

Beh serverových ovládacích prvkov(Server controls runtime)

Pri vytváraní vlastných ovládacích prvkov môžete Vaše ovládacie prvky skompilovať do assemblies, ktoré sú pridané do adresára Bin alebo v prípade ASP.NET 2.0, môžete pridať priamo súbor(y) kódu do aplikačného adresára App_Code. ASP.NET 2.0 ovládací prvok dynamicky skompiluje. V ASP.NET 2.0 môžete taktiež použiť prefixy značiek, pri registrovaní ovládacích prvkov z viacerých menných priestorov. Takže je možné vytvoriť niekoľko ovládacích prvkov vo viacerých priestoroch mien, ak všetky spĺňajú podmienku spoločného prefixu.

Triedy ovládacích prvkov (Control Classes)

CompositeControl je WebControl a implementuje INamingContainer. Kolekcia Controls zavolá EnsureChildControls. Všetky dcérske ovládacie prvky by ste mali vytvoriť v reakcii na udalosť CreateChildControls. Základná trieda zároveň poskytuje podporu dizajnového času, a zabezpečuje tvorbu kolekcie Controls.

Vývojárovi stránky môžete umožniť štylizáciu Vášho ovládacieho prvku odkrytím vlastností najvyššej úrovne (top-level properties), ktoré sa ďalej delegujú štylizačným vlastnostiam dcérskych prvkov. Ak máte veľa vlastností a ovládacích prvkov, potom uvažujte o použití vlastností typu Style a ich spracovaní počas zobrazovacích metód , tak že ich dcérske ovládacie prvky preberú ako stav zobrazenia(view-state),a na rodičovských prvkoch zostáva ich správa.

Trieda ovládacieho prvku a vlastnosť Meta-data

Riadenie stavu

V ASP.NET 2.0, sú control-state a view-state kombinované do skrytého poľa vo fáze zobrazovania stránky. Stránke môžete poslať žiadosť, aby toto pole šifrovala, ak potrebujete prenášať potenciálne citlivé údaje.(Page.RegisterRequiresViewStateEncryption)

Adaptéry ovládacích prvkov a stránky: Riadenie správania zariadení, prehliadačov a značiek

Proces tvorby HttpBrowserCapabilities používa deklaratívne súbory prehladača, ktoré sa nachádzajú v inštalačnom adresári Config\Browsers a/alebo v lokálnom adresári App_Browser aplikácie. Nasledujúci príklad ukazuje vlastný súbor prehliadača, ktorý mapuje adaptér na vlastný ovládací prvok; V tomto príklade je assembly obsahujúca adaptér automaticky renderovaná z adresára App_Code aplikácie a definície typov sú ukázané bez úplnej kvalifikácie.

Počas životného cyklu štruktúry stránky sa ASP.NET 2.0 pokúša vyhľadať adaptér na ovládacom prvku použitím metódy Control.ResolveAdapter. Ak je adaptér vrátený, kód stránky zavolá metódy adaptéra namiesto metód životného cyklu ovládacieho prvku. Ako vývojár programujúci rozšírenia môžete využiť a rozšíriť základné triedy ako ControlAdapter, WebControlAdapter a PageAdapter a definovať tak prekrytia pre časti životného cyklu ovládacích prvkov, ako aj pre ostatné metódy (tvorba dcérskych ovládacích prvkov, riešenie spätného volania)


' Control
Public Class MyControl 
  Inherits Control
  ' Example showing override of Render to control entire rendering
  Protected Overrides Sub Render(ByVal writer As HtmlTextWriter)
    Dim s As New Style()
    s.ForeColor = System.Drawing.Color.Green
    writer.EnterStyle(s)
    writer.Write("Welcome custom control.")
    writer.ExitStyle(s)
  End Sub
  ' Additional implementation
End Class
' Adapter	
Public Class MyControlAdapter 
  Inherits ControlAdapter
  ' Example showing override of Render to control entire rendering      
  Protected Overrides Sub Render(ByVal writer As HtmlTextWriter) 
    Dim s As New Style()
    s.ForeColor = System.Drawing.Color.Red
    writer.EnterStyle(s)
    writer.Write("Welcome custom control adapter.")
    writer.ExitStyle(s)
  End Sub
  ' Additional implementation
End Class

Ovládacie prvky dátového zdroja, a dátovo-viazané ovládacie prvky

Webové zdroje (Resources)

Riadenie klientského skriptu

Prostriedky, Filtrovanie

Spätné volania


Public Class CustomControl
  Inherits CompositeControl
  Implements ICallbackEventHandler

  Private Sub PrepareCallbackEvent(ByVal eventArgument As String)
    Implements System.Web.UI.ICallbackEventHandler.PrepareCallbackEvent
    PrepareCallbackEvent(eventArgument)
  End Sub

  Private Function RenderCallbackResult() As String _
    Implements System.Web.UI.ICallbackEventHandler.RenderCallbackResult
    Return RenderCallbackResult()
  End Function

  Private _callbackEventArg As String;

  Protected Overridable Sub PrepareCallback(ByVal eventArgument As String)
    _callbackEventArg = eventArgument
  End Sub

  Protected Overridable Function RenderCallbackResult() As String   
    Dim result As String

    If (_callbackEventArg = "theArg") Then
      result = "Some data"
    Else
      result = "Only theArg allowed!" 
    End If

    Return result 
  End Function

  Private sButtonCallBack As String = _
    "function ButtonCallBack(result, context){ alert(result);}"
  Private sButtonCallBackError As String = _
    "function ButtonErrorCallBack(result, context){ alert(result);}"

  Protected Overrides Sub OnInit(ByVal e As System.EventArgs)
    MyBase.OnInit(e)
    Page.ClientScript.RegisterClientScriptBlock(GetType(MyControl), _
      "ButtonCallBack", sButtonCallBack, True);
    Page.ClientScript.RegisterClientScriptBlock(GetType(MyControl), _
      "ButtonCallBackError", sButtonCallBackError, True);
  End Sub

  ' Additional implementation

  Protected Overrides Sub OnPreRender(ByVal e As EventArgs)
    Me.Attributes("OnClick") = _
    Page.ClientScript.GetCallbackEventReference(Me, _
      "'theArg'", "ButtonCallback", "null", "ButtonErrorCallback", True)
    MyBase.OnPreRender(e)
  End Sub
End Class

Page-state

ASP.NET 2.0 zároveň umožňuje rozdelenie jedného skrytého poľa prostredníctvom konfiguračného atribútu maxPageStateFieldLength.

Dizajnový čas serverových ovládacích prvkov


<Designer(GetType(MyDesigner)), ParseChildren(false), PersistChildren(true)>
Namespace CustomControls

  <Designer(GetType(MyDesigner)), ParseChildren(False), PersistChildren(True)> _
  Public Class MyControl
      Inherits WebControl
  End Class

  Public Class MyDesigner
    Inherits ContainerControlDesigner

    Private _style As Style = Nothing
    Public Overrides ReadOnly Property FrameCaption() As String
      Get
        ' Return a caption
      End Get
    End Property

    Public Overrides ReadOnly Property FrameStyle() As Style
      Get
        ' Return a style for the frame
      End Get
    End Property

    Public Overrides ReadOnly Property ActionLists() _
      As System.ComponentModel.Design.DesignerActionListCollection
      Get
        ' Get the base collection and add my own list
      End Get
    End Property

    Private Class MyList
      Inherits System.ComponentModel.Design.DesignerActionList
      ' Members to handle the smart-tag
		    ..
      Public Overrides Function GetSortedActionItems() _
        As System.ComponentModel.Design.DesignerActionItemCollection
	' Create a collection and add DesignerActionTextItem, 
	' DesignerActionPropertyItem and DesignerActionMethodItem types
      End Function
    End Class
  End Class
End Namespace

Poskytovatelia služieb aplikácie

Staviteľe výrazov (Expression Builders)

Stavitele výrazov môžu byť konštruované pre podporu vlastnosti no compile ASP.NET 2.0. Namiesto generovania kódu prostredníctvom staviteľa počas generovania triedy stránky, behové prostredie inštancuje staviteľ a vyhodnotí výraz. Nasledujúci príklad demonštruje pseudo ExpressionBuilder a ExpressionBuilderEditor.


Namespace CustomExpressionBuilders
  ' Create the expression builder and define the prefix, the editor etc.
   _
  Public NotInheritable Class CustomExpressionBuilder
    Inherits ExpressionBuilder

    Public Overrides ReadOnly Property SupportsEvaluate() As Boolean
      Get
        Return True
        ' Supports the evaluation for no compile scenarios
      End Get
    End Property

    Public Overrides Function GetCodeExpression(ByVal entry As System.Web.UI.BoundPropertyEntry, _
      ByVal parsedData As Object, ByVal context As System.Web.Compilation.ExpressionBuilderContext) _
      As System.CodeDom.CodeExpression
      ' Return a code expression, given the declarative expression
    End Function

    Public Overrides Function EvaluateExpression(ByVal target As Object, _
      ByVal entry As System.Web.UI.BoundPropertyEntry, ByVal parsedData As Object, _
      ByVal context As System.Web.Compilation.ExpressionBuilderContext) As Object
      ' Return an evaluation of the expression for no compile scenarios
    End Function

    ' Additional implementation

  End Class

  ' The editor is used at design-time
  Public NotInheritable Class CustomExpressionEditor
    Inherits ExpressionEditor

    Public Overrides Function GetExpressionEditorSheet(ByVal expression As String, _
      ByVal serviceProvider As System.IServiceProvider) As System.Web.UI.Design.ExpressionEditorSheet
      ' Create a sheet
    End Function

    Public Overrides Function EvaluateExpression(ByVal expression As String, _
      ByVal parseTimeData As Object, ByVal propertyType As System.Type, _
      ByVal serviceProvider As System.IServiceProvider) As Object
      ' Return an evaluation during design-time
    End Function

    Private NotInheritable Class CustomExpressionEditorSheet
        Inherits ExpressionEditorSheet
      ' Expose any properties that represent the expression's value, you can define
      ' default values, type converters and descriptions
    End Class
  End Class
End Namespace

Lokalizácia

Lokalizačný model v ASP.NET 2.0 umožňuje vývojárovi stránky nastaviť explicitné alebo implicitné deklaratívne výrazy. Výrazy zdrojov (resource expression) môžete rozšíriť tak, ako bolo popísané vyššie aj pri stálom využívaní poskytovateľov zdrojov (resource providers). Omnoho lepšie je rozšíriť lokalizáciu, aby poskytovala dodatočné možnosti prístupu ku zdrojom (nie len použitie ResX a satelitných assemblies). Jednoducho môžete vymeniť existujúcu ResourceProviderFactory, ktorá je definovaná v konfigurácii a dodať novú. Továreň jednoducho vytvorí rozhrania IResourceProvider pre globálne aj lokálne zdroje. Nasledujúci pseudo-kód ukazuje jednoduchý prípad výmeny továrne. (vlastná továreň musí byť definovaná v konfigurácii).


' Note that to support design-time too, add the following attribute and
' define the provider
Namespace CustomLocalizationProviders
  <DesignTimeResourceProviderFactoryAttribute(GetType(CustomDesignTimeResourceProviderFactory))> _
  Public NotInheritable Class CustomResourceProviderFactory
    Inherits ResourceProviderFactory

    Public Overrides Function CreateGlobalResourceProvider(ByVal classKey As String) _
      As System.Web.Compilation.IResourceProvider
      Return New CustomGlobalResourceProvider(classKey)
    End Function

    Public Overrides Function CreateLocalResourceProvider(ByVal virtualPath As String) _
      As System.Web.Compilation.IResourceProvider
      Return New CustomLocalResourceProvider(virtualPath)
    End Function

    Private NotInheritable Class CustomGlobalResourceProvider
      Implements IResourceProvider

      Public Sub New(ByVal classKey As String)
        ' ..
      End Sub

      Public Function GetObject(ByVal resourceKey As String, _
        ByVal culture As System.Globalization.CultureInfo) _
        As Object Implements System.Web.Compilation.IResourceProvider.GetObject
        ' Get a resource object for the resource key and culture
      End Function

      Public ReadOnly Property ResourceReader() As System.Resources.IResourceReader _
        Implements System.Web.Compilation.IResourceProvider.ResourceReader
        Get
          ' Return a reader that enumerates the neutral resource */
        End Get
      End Property
    End Class

    ' Implement CustomLocalResourceProvider

  End Class
End Namespace

Kompilácia a pred-kompilácia

Dynamická kompilácia zahŕňa na príklad, súbory separácie kódu (code separation files) asociované s webovými stránkami a používateľskými ovládacími prvkami, kódom v adresári App_Code a abstraktnými súbormi ako ASPX, ASCX, RESX, a tiež, WSDL, XSD.

Existujú dve formy pred-kompilácie stránok pre nasadenie ako aj pred-kompilácia, ktorá stránku 'štartuje'. Pred-kompilácia pre nasadenie môže byť vykonaná dvomi spôsobmi, ktoré buď umožňujú špecifické aktualizácie na kompilovanú stránku, alebo nie. V oboch prípadoch je kód odstránený z kompilovanej stránky (cieľovej). V prípade v ktorom nie sú povolené aktualizácie po nasadení sa odstraňujú aj súbory ako ASPX. Pred-kompilácia na 'naštartovanie' stránky znamená, že ASP.NET vykoná bežnú kompiláciu celej stránky, aby sa zamedzilo spomaleniu pri prvej požiadavke.

Na pred-kompiláciu stránky môžete použiť pomôcku aspnet_compiler.exe. Pomôcka sa nachádza v inštalačnom adresári .NET Framework, na príklad %WINDIR%\Microsoft.NET\Framework\<version>. Môžete spustiť jej verziu s parametrom /? na zobrazenie zoznamu dostupných možností. Na príklad na pred-kompiláciu stránky určením virtuálnej cesty k aplikácii použite nasledujúci príkaz.

Kompilačné procesy môžete rozšíriť viacerými spôsobmi; dodaním nových súborových typov alebo prípon do kompilácie použitím Poskytovateľov výstavby (BuildProviders), alebo urobením špecifického obsahu virtuálnym, takže jeho zdroj nemusí byť na disku. VirtualPathProvider poskytuje práve uvedený spôsob bod rozšírenia.

Poskytovatele výstavby (Build Providers)

Nasledujúca ukážka ilustruje mapovanie vlastného poskytovateľa výstavby na nový typ súboru (prípona: myext). Keď sú súbory s uvedenou príponou pridané len do adresára App_Code, vlastný poskytovateľ výstavby sa používa na preklad súboru a na následné odovzdanie kódu naspäť ASP.NET. Vlastný poskytovateľ je zároveň definovaný v adresári App_Code, v jeho špeciálne nakonfigurovanom pod-adresári. Toto zaistí, že typ objektu vlastného poskytovateľa bude prístupný pre systém výstavby (build), keď dôjde ku styku s asociovaným súborom v adresári App_Code.


Namespace CustomBuildProviders 
  <BuildProviderAppliesToAttribute(BuildProviderAppliesTo.Code)> _
  Public NotInheritable Class CustomBuildProvider 
    Inherits BuildProvider
    
    ' Additional implementation
		
    Public Overrides Sub GenerateCode(ByVal assemblyBuilder As System.Web.Compilation.AssemblyBuilder)
      ' Return code, e.g. a CodeCompileUnit that is added to the 
      ' assembly builder.

      ParseVirtualPath()

      ' Generate codeDOM for the type
      Dim ccu As CodeCompileUnit
      ccu = GenerateCodeCompileUnit()
      If Not (ccu Is Nothing) Then
        assemblyBuilder.AddCodeCompileUnit(Me, ccu)
      End If
    End Sub
		
    Private Sub ParseVirtualPath()
      ' Additional implementation
    End Sub

    Provate Function GenerateCodeCompileUnit() As CodeCompileUnit
      ' Return a new CodeCompileUnit 				
    End Function
  End Class
End Namespace

Ak potrebujete získať zostavený typ v aplikačnom kóde, môžete použiť metódu BuildManager.GetType, pretože meno assembly nie je signifikantné.

Poskytovateľ virtuálnej cesty (Virtual Path Provider)

Aby ste mohli využívať poskytovateľ virtuálnej cesty, musíte ho zaregistrovať s ASP.NET v úvodnej časti životného cyklu aplikácie, na príklad použitím špeciálnej statickej metódy definovanej kódom, ktorý je umiestnený v adresári App_Code (a teda automaticky kompilovaný), nazvanej AppInitialize. Len špecifické typy webového obsahu môžu byť virtualizované týmto spôsobom. Na príklad kód v adresári App_Code nemôže byť mapovaný na VirtualPathProvider.

Poskytovatelia virtuálnej cesty sa používajú na obsluhu žiadostí o obsah založený na virtuálnej ceste. Poskytovateľom môže byť zaregistrovaných hneď niekoľko. Je možné, že webový obsah vo Vašej aplikácii môže byť obslúžený celou množinou poskytovateľov virtuálnej cesty. Na príklad Váš vlastný poskytovateľ a zabudovaný poskytovateľ ASP.NET, ktorý obhospodaruje štandardný súborový systém. V tomto prípade budete musieť vytvoriť Vášho vlastného poskytovateľa spôsobom, ktorý odovzdáva riadenie zabudovanému v prípade, že nedokáže spracovať špecifickú virtuálnu cestu.

Nasledujúca ukážka ukazuje pseudo-kód vlastného poskytovateľa VirtualPathProvider.


' For example, using code in the App_Code directory
Namespace CustomVirtualPathProviders

  Public NotInheritable Class CustomVirtualPathProvider
    Inherits VirtualPathProvider

    Public Sub AppInitialize()
      Dim myVpp As New CustomVirtualPathProvider()
      HostingEnvironment.RegisterVirtualPathProvider(myVpp)
    End Sub

    Public Overrides Function GetFileHash(ByVal virtualPath As String, _ 
      ByVal virtualPathDependencies As System.Collections.IEnumerable) As String
      ' Return a hash value based on the virtualPathDependencies
      ' For unhandled dependencies, create a list of these, then defer to the Previous to
      ' get it's hash and combine with this hash value
    End Function

    Public Overrides Function GetCacheDependency(ByVal virtualPath As String, _
      ByVal virtualPathDependencies As System.Collections.IEnumerable, _ 
      ByVal utcStart As Date) As System.Web.Caching.CacheDependency
      ' If the custom virtual path provider handles the path or dependency and it can
      ' create a CahceDependency create on and combine with that from the Previous
      ' If the provider cannot create a cacheDependency and it handles one of the
      ' dependencies, return null
    End Function

    Public Overrides Function FileExists(ByVal virtualPath As String) As Boolean
      ' If the custom virtual path provider handles the virtualPath and 
      ' it exists return true, otherwise defer to Previous
    End Function

    Public Overrides Function DirectoryExists(ByVal virtualDir As String) As Boolean
      ' If the custom virtual path provider handles the virtualDir and 
      ' it exists return true, otherwise defer to Previous
    End Function

    Public Overrides Function GetDirectory(ByVal virtualDir As String) _ 
      As System.Web.Hosting.VirtualDirectory
      ' If the custom virtual path provider handles the virtualDir and 
      ' it exists return true, otherwise defer to Previous
    End Function

    Public Overrides Function GetFile(ByVal virtualPath As String) _ 
      As System.Web.Hosting.VirtualFile
      ' If the custom virtual path provider handles the virtualPath and 
      ' it exists then create a custom VirtualFile and return, otherwise defer to Previous
      ' VirtualFile implements an Open method to return a Stream
    End Function

    Private NotInheritable Class MyVirtualFile
      Inherits VirtualFile
      Sub New(ByVal virtualPath As String)
          MyBase.New(VirtualPath)
      End Sub
      Public Overrides Function Open() As System.IO.Stream
	' Return a Stream
      End Function
    End Class

  End Class
End Namespace

ASP.NET Quickstart Tutorial

Rozširovanie(extending) ASP.NET