Instructions RAD Controls

transcript

8/13/2019 Instructions RAD Controls

http://slidepdf.com/reader/full/instructions-rad-controls 1/6

RadControls for ASP.NET Ajax

Source Code Build Instructions

RequirementsBuilding RadControls for ASP.NET Ajax from source requires the .NET 4. frame!or" #do!nload$.

Building a .NET %. &ersion of the controls additionall' requires ASP.NET Ajax (. #do!nload$.

To de)ug the controls 'ou need *isual Studio %( #or *isual Studio %( Ex+ress$ installed.

IMPORTANT NOTE, The su++lied solution is in *isual Studio %( format. *isual Studio %- or % cannot

)e used to )uild and de)ug RadControls for ASP.NET Ajax.

Contents of the source code packageThe source code of RadControls for ASP.NET Ajax is distri)uted in the form of a /0P archi&e. Proceed )'

extracting it in a folder of 'our choice.

1or the +ur+ose of this tutorial !e !ill assume that the archi&e content is extracted at

C:\RadControlsAjaxSource. This is ho! the folder should loo" li"e,

C,2RadControlsAjaxSource

Teleri".3e).esign

Teleri".3e).50

Teleri".3e).50.S"ins

0nstructions.doc

RadControls.sln

0nside 'ou !ill find the controls source code6 a *isual Studio solution file and these instructions. The code is

s+lit in three +rojects 7 the controls #Teleri".3e).50$6 their s"ins #Teleri".3e).50.S"ins$6 and the *isual Studio

design8time su++ort code #Teleri".3e).esign$.

Debugging RadControls for ASP.NET Aa!To de)ug RadControls for ASP.NET Ajax follo! these ste+s,

(. 9+en the RadControls.sln solution

%. *isual Studio might dis+la' a !arning as the solution contains custom )uild tas"s. 0f 'ou see the dialog

)ello!6 choose the :;oad +roject normall'< o+tion to +roceed,

=. 9+en the Configuration manager !indo! #from the Build menu choose :Configuration >anager<$ and

select the configuration for 'our a++lication. 1or a .NET 4. a++6 choose :e)ug8NET4<? for .NET =.-

+rojects choose :e)ug8NET=-<? for .NET %. +rojects choose :e)ug<. The configuration manager

should loo" li"e this,

0>P9RTANT, o not change the target frame!or" +ro+ert' of the Teleri".3e).50 or

Teleri".3e).esign or Teleri".3e).50.S"ins +rojects directl' #from the +roject +ro+erties$. 9nl' change

the frame!or" &ersion using the solution configuration and the configuration manager dialog.

4. Add a ne! or existing A@A8ena)led 3e) Site to the solution.

-. Add a reference to the Telerik.We.!esi"n +roject in 'our 3e) Site. This !ill automaticall' add a

reference to Teleri".3e).50 and Teleri".3e).50.S"ins as !ell.

. Re)uild the solution and de)ug

"uilding Release #ersion of RadControls for ASP.NET Aa!ou can )uild release &ersions of RadControls RadControls for ASP.NET Ajax directl' from *isual Studio.

Alternati&el'6 'ou can )uild them )' using >SBuild !hich is a standard +art of the .NET 1rame!or".

"uilding from $isual Studio %&'&

(. 9+en the RadControls.sln solution

%. Acce+t the securit' !arning as descri)ed a)o&e if it is dis+la'ed.

=. Set the solution configuration to :Release8NET4< for .NET 4. or :Release8NET=-< for .NET =.- as

descri)ed a)o&e.

4. Re)uild the solution

-. The assem)lies !ill )e located at C:\RadControlsAjaxSource\ Telerik.We.!esi"n\in

. ou can start using Teleri".3e).50.dll and Teleri".3e).50.S"ins.dll. The designer assem)l'

#Teleri".3e).esign.dll$ should )e de+lo'ed in DAC first.

"uilding (ith )S"uild

(. 9+en the command +rom+t and change the director' to C:\RadControlsAjaxSource,

cd C:\RadControlsAjaxSource

%. Re)uild the solution !ith configuration :Release8NET4< for .NET 4. or :Release8NET=-< for .NET =.-

%SYSTEMROOT%\Microsoft.NET\Frae!or"\#$..&&'(\MS)uild RadControls.sln

*+: onfi,uration-. elease/NET$%. *tar,et:Re0uild *#er0osit1:inial

=. The assem)lies !ill )e located at C:\RadControlsAjaxSource\ Telerik.We.!esi"n\in

4. ou can start using Teleri".3e).50.dll and Teleri".3e).50.S"ins.dll. The designer assem)l'

#Teleri".3e).esign.dll$ should )e de+lo'ed in DAC first.

*sing a different SN+ fileB' default the source code is +ac"aged !ith a sam+le SN file !hich is different from the one used to )uild the

+roduction &ersion of the assem)lies. To use 'our o!n SN file +lease follo! these ste+s,

(. Re+lace C:\RadControlsAjaxSource\Telerik.We.#I\Telerik.We.snk !ith 'our SN file.

%. Re+lace C:\RadControlsAjaxSource\Telerik.We.!esi"n\Telerik.We.snk !ith 'our SN file.

=. Re+lace C:\RadControlsAjaxSource\Telerik.We.#I.Skins\Telerik.We.snk !ith 'our SN file.

4. No! 'ou need to re+lace the +u)lic "e' )lo) and to"en of the original SN file !ith 'ours.

-. Start *isual Studio command +rom+t and change the current director' to

C,2RadControlsAjaxSource2Teleri".3e).50,

cd C:\RadControlsAjaxSource\Teleri".2e0.34\

. Extract the +u)lic "e' from the SN file )' running,sn /+ Teleri".2e0.sn" +u0lic."e1

F. No! dis+la' the +u)lic "e' and to"en,

sn /t+ +u0lic."e1

. Co+' the +u)lic "e'

G. 9+en C:\RadControlsAjaxSource\Telerik.We.#I\Pro$erties\Asse%l&In'o.cs and find the

follo!ing line,

5asse0l1: 4nternals6isi0leTo7Teleri".2e0.8esi,n9

u0lic;e1-<$$=($><<$?<?&$'&'$''d@

f$?@$=?'e0ea=&c0<>dfc(d&?>(e>?$c=0(<eaa0((=?=dd0@aa$0(0>='(f@$?@'d(0?@<0

(&c=(f&0=>a@$fe'f@<ead&eafc>c(<=ff$?@>e&0c$(($d'&>f>@@>=(='<?ec0(<=a?&>?(

>=d(d'(&'(=@e&=<c''a($$'&(a0a'&?ded(cfe=$=&a=d<ae=d&=f(@(fd('??=00'<&&=$0&eaa<=@?0'f&?d<$0&B

(. Re+lace the Pu)lice' attri)ute !ith the &alue co+ied from the +re&ious ste+. ee+ in mind the SN tool

generates the +u)lic "e' in a multiline format 7 'ou need to remo&e the ne!lines )eforehand.

((. Co+' the +u)lic "e' to"en from the +re&ious screen #the SN 8t+ out+ut$

(%. 9+en C:\RadControlsAjaxSource\Telerik.We.#I\!esi"nerIn'o.cs

(=. Re+lace :%Gac(aG=ec=dG%< #!ithout quotes$ !ith the ne! +u)lic "e' to"en returned )' the SN tool.

Notes(. RadControls 'or ASP.NET A(A) source *ersion, the &ersion of the assem)l' 'ou )uild from the

source !ill not include the frame!or" suffix 'ou see in the official assem)l'. 1or exam+le6 if the official

Teleri" assem)l' for .NET 4. is %((.(.4(=.+,6 the assem)l' 'ou )uild from the source for this release

!ill )e &ersion %((.(.4(=., #. instead of .4$. 0f 'ou !ant to ha&e the suffix so 'our custom &ersion is

the same as the official one6 'ou !ill need to modif' the follo!ing four files,

C:\RadControlsAjaxSource\Telerik.We.#I\!esi"nerIn'o.cs

C:\RadControlsAjaxSource\Telerik.We.#I\Pro$erties\Asse%l&In'o.cs

C:\RadControlsAjaxSource\Telerik.We.!esi"n\Pro$erties\Asse%l&In'o.cs

C:\RadControlsAjaxSource\Telerik.We.#I.Skins\Pro$erties\Asse%l&In'o.cs

Change the %((.(.4(=. to %((.(.4(=.4 #if 'ou are targeting .NET 4.$ or %((.(.4(=.=- #if 'ou +lan

to )uild a .NET =.- &ersion$

%. !eu""in" and (a*aScri$t 'iles added to t-e Scri$tMana"er control, 0f 'ou are de)ugging a !e)a++lication !ith a Teleri".3e).50 assem)l' )uilt in a de)ug configuration from the source and 'ou ha&eadded the control scri+ts ex+licitl' in the RadScri+t>anager scri+ts collectionli"e this,

teleri":RadScri+tMana,er 48-RadScri+tMana,er< runat-ser#erDScri+tsD

as+:Scri+tReference Asse0l1-Teleri".2e0.34 Nae-Teleri".2e0.34.Coon.Core.js *Das+:Scri+tReference Asse0l1-Teleri".2e0.34 Nae-Teleri".2e0.34.Coon.juer1.js *Das+:Scri+tReference Asse0l1-Teleri".2e0.34

Nae-Teleri".2e0.34.Coon.juer1lu,ins.js *Das+:Scri+tReference Asse0l1-Teleri".2e0.34

Nae-Teleri".2e0.34.Coon.o+u+.o+u+Scri+ts.js *D*Scri+tsD*teleri":RadScri+tMana,erD

0n this case 'ou might recei&e a @a&aScri+t error a)out missing t'+es !hen 'ou o+en the +age in a)ro!ser. This ha++ens )ecause in de)ug configurations6 the RadControls !ill not com)ine their@a&aScri+t resources and the scri+ts 'ou ha&e added as Scri+tReference elements in the

Scri+t>anager do not contain all the needed code. Tr' remo&ing the Scri+tReference elements for theTeleri".3e).50 assem)l' and let the RadScri+t>anager #or the normal ASP.NET A@A Scri+t>anagercontrol$ disco&er and load the scri+ts on its o!n.

Instructions RAD Controls

Documents