.Net Reflectr v5.0: Manual de usuari Fecha: Referencia: EJIE S.A. Mediterráne, 3 Tel. 945 01 73 00* Fax. 945 01 73 01 01010 Vitria-Gasteiz Psta-kutxatila / Apartad: 809 01080 Vitria-Gasteiz www.ejie.es Este dcument es prpiedad de EJIE, S.A. y su cntenid es cnfidencial. Este dcument n puede ser reprducid, en su ttalidad parcialmente, ni mstrad a trs, ni utilizad para trs prpósits que ls que han riginad su entrega, sin el previ permis escrit de EJIE, S.A.. En el cas de ser entregad en virtud de un cntrat, su utilización estará limitada a l expresamente autrizad en dich cntrat. EJIE, S.A. n pdrá ser cnsiderada respnsable de eventuales errres u misines en la edición del dcument.
Cntrl de dcumentación Títul de dcument:.net Reflectr v5.0 Códig: Versión: 1.0 Fecha: Resumen de cambis: Primera versión. Históric de versines Cambis prducids desde la última versión Cntrl de difusión Respnsable: Ander Martínez Aprbad pr: Ander Martínez Firma: Fecha: Distribución: Referencias de archiv Autr: Cnsultría de áreas de cncimient Nmbre archiv: Net Reflectr. Manual rápid de usuari v5.0.dc Lcalización:.Net Reflectr. Manual de usuari 2/33
Cntenid Capítul/sección Página 1 Intrducción 4 2 Cncepts básics 4 3 Funcines elementales 4 3.1 Inici de la aplicación 4 3.2 Funcinamient de.net Reflectr 4 4 Enlaces de referencia 26 5 Utilidad Práctica 26 6 Anex 1: Ejempl 27 6.1 Reslución 27.Net Reflectr. Manual de usuari 3/33
1 Intrducción El presente dcument describe cuales sn las tareas que se pueden ejecutar en la expltación de la herramienta.net Reflectr. 2 Cncepts básics Net Reflectr es una herramienta que explra las clases, métds y prpiedades, pudiend analizar su códig intermedi (MSIL). Descmpila y genera el códig fuente riginal en un de ls siguientes lenguajes: IL C# Visual Basic Delphi MC++ Chrme Para una crrecta peratividad del aplicativ, se requiere que el puest cliente dispnga de la versión 1.1 de.net Framewrk para su crrect funcinamient. 3 Funcines elementales 3.1 Inici de la aplicación Se accederá a la carpeta en la que el.net Reflectr esté instalad bien sbre el acces direct existente en el escritri para ejecutar el aplicativ. 3.2 Funcinamient de.net Reflectr Al ejecutar el archiv Reflectr.exe, hay que elegir entre una de las tres versines de.net Framewrk, cm se puede ver en la imagen inferir. Una vez se seleccine una pción y pulsand en k se abrirá el Reflectr.exe cn la versión del Framewrk seleccinada..net Reflectr. Manual de usuari 4/33
Al ejecutar una segunda vez el prgrama, cerrand previamente la ventana de la aplicación, n vuelve a aparecer la ventana anterir ya que se genera un archiv Reflectr.cfg, que cntiene las direccines de las dlls que aparecen pr defect en el prgrama en la versión de.net Framewrk seleccinada anterirmente. El prgrama cnsta de un menú, una barra de herramientas, las dlls (assembly) generadas pr defect pr el prgrama y en la parte inferir la descripción de la dll cualquier tr element seleccinad en la parte superir, dnde aparece: Lcatin: Dirección física dnde está ubicada la dll. Name: Nmbre de la dll junt cn la versión. Type: Tip de la dll..net Reflectr. Manual de usuari 5/33
Pulsand ds veces sbre una dll (assembly) de la lista, teniend cm ejempl la imagen superir, pulsand en el símbl +, se muestra l siguiente pr este rden: Namespaces Clases, interfaces, enumeracines Funcines, prcedimients, variables Dentr de cada clase, se muestra Base types, Derived types además de las funcines, variables glbales, prcedimients que cmpnen la clase. También aparece una carpeta cn tds ls resurces de la dll. Mediante el menú superir el del btón derech una vez seleccinad un de ls elements anterirmente expuests, se accede a las diferentes pcines, cm sn, ver el códig fuente, la dcumentación, analizar el element, pcines que se detallarán en ls punts siguientes..net Reflectr. Manual de usuari 6/33
En la imagen superir, pr ejempl, se muestra en el frame derech el códig fuente de la pción seleccinada en el izquierd. Una vez seleccinada la pción que se desea realizar basta cn pulsar en el frame izquierd distints elements para que aparezca el códig fuente de cada un de ells. Hay elements que n tienen determinadas pcines, pr l que el frame derech aparecerá vací si previamente se había mstrad el códig fuente de tr element que sí la tenía, si est últim n es así n se pdrá mstrar ya que la pción estará deshabilitada tant en el menú superir, en la barra de herramientas cm en el del btón derech. Est es cmún para tdas las pcines. Al pulsar dble clic sbre un element que psee el símbl + pr delante se abre mstrand sus subelements y si tiene el símbl se cierra cultándls, en el cas de que n tenga ni un ni tr, en la parte del frame derech se mstrará su códig fuente, independientemente de la pción pulsada anterirmente. Menú superir El menú superir cnsta de ls siguientes elements: File, al seleccinarl se abre un menú desplegable cn ls siguientes elements. Open, Agrega una dll al prgrama mediante la búsqueda del archiv en la siguiente ventana..net Reflectr. Manual de usuari 7/33
Open cache, abre la siguiente ventana dnde aparece tdas las dll almacenadas en la memria caché. Se agrega al prgrama seleccinad la dll y pulsand en el btón pen escribiend su nmbre en el camp de text de la parte superir de la lista. Open List, abre la siguiente ventana, inicialmente aparece la lista default, pulsand en el btón add, se crea una nueva lista. Al pulsar en select se abre la ventana para elegir la versión de.net framewrk. Una vez esté ya creada la lista, la próxima vez que se acceda a este menú, únicamente pulsand sbre la lista se accede a las dlls per en la versión de Framewrk seleccinada anterirmente. Cn el btón Remve se brra la lista seleccinada..net Reflectr. Manual de usuari 8/33
Clse, elimina la dll del prgrama, para ell aparece una ventana cn tdas las dlls agregadas al prgrama, entnces se seleccina la dll que se quiere eliminar y se pulsa en unlad. View, al seleccinarl se abre un menú desplegable cn ls siguientes elements. Dcumentatin, se muestra la dcumentación de la clase en el frame derech. En este cas n está dispnible..net Reflectr. Manual de usuari 9/33
También puede darse el cas de querer mstrar la dcumentación en elements que n pseen dicha pción, entnces aparecerá vací si previamente se había mstrad la dcumentación de tr element que sí la tenía, si est últim n es así el menú dcumentatin estará deshabilitad. Pulsand clic derech sbre la dcumentación generada en el frame derech aparecen las siguientes pcines cm se puede ver en la imagen anterir: Cpy: cpia la dcumentación. Print Preview: Vista de impresión preliminar de la dcumentación, cm aparece en la siguiente imagen. Print: Imprime la dcumentación..net Reflectr. Manual de usuari 10/33
Pulsand cn el btón derech sbre un element se accede a esta pción de igual frma que mediante el menú principal. Bkmarks, muestra en la parte derecha del prgrama las clases, funcines, prcedimients y variables glbales que previamente se han agregad al Bkmarks. Para agregar ls elements a la lista Bkmarks, se pulsa clik derech sbre un de ells en el frame izquierd y se seleccina Tgle Bkmark..Net Reflectr. Manual de usuari 11/33
Al hacer dble clic sbre un element de la lista de bkmark se accede directamente a ese element en la parte izquierda del prgrama. Para eliminar ese element de la lista se vuelve a pulsar en el menú derech Tgle Bkmark, después de seleccinar el element en el frame izquierd del prgrama. También, seleccinand un element de la lista de Bkmarks y pulsand clic derech y Remve Bkmark, cm se muestra en la siguiente imagen. En el menú que aparece al mstrar clic derech sbre un element del bkmark aparte de Remve Bkmark aparece Cpy que cpia el nmbre del element seleccinad. Search, aparece una caja de text en la parte superir dnde se puede escribir el nmbre del element a buscar, debaj una lista dnde se muestra tds ls elements independientemente del que tengas seleccinad en el frame izquierd. Al.Net Reflectr. Manual de usuari 12/33
lad de la caja de text hay tres btnes para realizar tres tips diferentes de búsqueda, éstas sn: Pr tip: seleccinand el btón que aparece resaltad cn el círcul en clr rj en la imagen inferir. Pr Member: seleccinand el btón que aparece resaltad cn el círcul en clr rj en la imagen inferir. Pr Caracteres: seleccinand el btón que aparece resaltad cn el círcul en clr rj en la imagen inferir..net Reflectr. Manual de usuari 13/33
Refresh, refresca el frame izquierd del prgrama. Back, muestra el element seleccinad anterir al actual. Frward, una vez se pulse en el menú back, se habilitará este menú para regresar al element que se había seleccinad antes de pulsar en back. Add-ins, muesta la siguiente ventana. Optins, muestra las pcines de cnfiguración del prgrama. Tls, al seleccinarl se abre un menú desplegable cn ls siguientes elements: Disassembler, al pulsar en el menú se muestra el element seleccinad.net Reflectr. Manual de usuari 14/33
descmpilad, es decir, el códig fuente en la parte derecha. La primera vez que se quiere descmpilar un element aparece el siguiente mensaje, indicand que n se puede reslver autmáticamente, y que hay que seleccinar el archiv assemby manualmente, que aparece en el camp de text pr defect, pulsand k. Una vez pulsad aparece el códig fuente del element seleccinad. Mediante el cmb de la barra de herramientas se puede seleccinar el lenguaje en el que se desea que aparezca el códig fuente. En este cas el códig aparece en el lenguaje C#. Al clcar el ratón en la parte del códig cn clr verde aparece una pequeña descripción de la variable, parámetr, métd u bjet en cuestión. En el cas de ls bjets, métds, al pulsar sbre ells se muestran en el frame izquierd, pudiend saber de este md su prcedencia. Hay elements que n pueden ser descmpilads cm es el cas del namespace Ibiltari. El prgrama l indica mstrand un mensaje, imagen inferir, dnde se puede leer, que el namespace tiene demasiads elements para ser descmpilads y que se reabra el element seleccinad para mstrar su cntenid:.net Reflectr. Manual de usuari 15/33
Y en trs aparece el nmbre del assembly al que hace referencia. Pulsand clic derech sbre el códig fuente aparecen las siguientes pcines cm se puede ver en la imagen siguiente: Cpy: cpia el códig fuente.net Reflectr. Manual de usuari 16/33
Print Preview: Vista de impresión preliminar del códig fuente, cm aparece en la siguiente imagen. Print: imprime el códig fuente. Analyzer, al pulsar en esta pción de menú se muestra el análisis del element seleccinad, dividid en: Depends n: muestra ls elements que depende del seleccinad..net Reflectr. Manual de usuari 17/33
Used by: muestra ls elements que sn usads pr el seleccinad. Al pulsar clic derech sbre un element de la lista del análisis, aparece las siguientes pcines cm se puede ver en la siguiente imagen: Cpy: Aunque seleccines n un element de la lista se cpia td el análisis. G t member: Muestra en el frame izquierd el element seleccinad en el derech. Cpy, Cpia el nmbre del element seleccinad del frame izquierd. Search Ggle, busca el element seleccinad en el frame izquierd en ggle de la siguiente frma:.net Reflectr. Manual de usuari 18/33
También puede currir que n encuentre el element que se desea buscar. Search MSDN, busca infrmación sbre el element seleccinad en el manual MSDN de la siguiente frma..net Reflectr. Manual de usuari 19/33
En cas de n estar permitida esta pción sbre un element ésta aparecerá deshabilitada tant en el menú superir cm en el del btón derech. Help, la ayuda se divide en: Send feedback, aparece un frmulari para enviar un crre electrónic. Check fr updates, a partir de esta pción de menú se puede acceder a la última versión del prgrama para descargarla. En este cas aparece un mensaje indicand que la versión del prgrama que esty utilizand es la última..net Reflectr. Manual de usuari 20/33
Abut.Net Reflectr, prprcina infrmación sbre el prgrama, su versión, la versión del.net framewrk utilizada y el enlace a la página web del prgrama http://www.aist.cm /reder/dtnet/. Menú del btón derech Barra de herramientas En cas de n estar permitida esta pción sbre un element ésta aparecerá deshabilitada tant en el menú superir cm en el del btón derech., muestra el element anterir al seleccinad actualmente, si es la primera vez que se seleccina un element éste aparecerá deshabilitad., una vez se pulse en el btón anterir, se habilitará este menú para regresar al element que se había seleccinad anterirmente., abre la siguiente ventana para buscar la dll (assembly) que se desea agregar al prgrama..net Reflectr. Manual de usuari 21/33
, actualiza el prgrama, al pulsar este btón muestra la dcumentación del element seleccinad del mism md que pulsand en el menú superir View Dcumentatin., muestra una lista cn ls elements que previamente se han agregad al bkmarks de la siguiente manera, seleccinand el element y cn el btón derech pulsand en tgle bkmark., realiza la búsqueda de elements., abre la ventana de prpiedades., al abrir el deplegable aparecen ls lenguajes pr ls que se puede.net Reflectr. Manual de usuari 22/33
descmpilar el element. Ésts sn: IL C# Visual Basic Delphi MC++ Chrme, abre el siguiente frmulari para enviar un crre electrónic. Menú del btón derech Al pulsar sbre un element cn el btón derech del ratón aparecerán las pcines que se pueden realizar sbre el element seleccinad. Estas pcines aparecen explicadas más detalladamente en el apartad del menú superir. Éstas pueden variar dependiend del element. En el cas de una dll (assembly) las pcines sn las siguientes: Back, muestra el element anterirmente seleccinad. Frward, permanecerá deshabiliatada hasta que n se pulse en back, y muestra el últim element seleccinad antes de pulsar en back. Cpy, cpia el nmbre del element. Dissambler, muestra en el frame derech el códig fuente del element. Analyzerm, se muestra en el frame derech el análisis del element seleccinad. G t Entry Pint, que pr defect aparece deshabilitada..net Reflectr. Manual de usuari 23/33
Clse, elimina de la lista la dll (assembly) seleccinada. Al seleccinar una clase se muestra en el menú derech 5 pcines más. Tgle Bkmark, cm ya se ha explicad antes, el element se añade al Bkmark, lista para acceder directamente al element. Dcumentatin, muestra en el frame izquierd la dcumentación del element. Search MSDN, busca infrmación sbre el element seleccinad en el manual MSDN. Shw Inherited Members, muestra ls miembrs heredads. G t Base Type, muestra la clase base de la seleccinada..net Reflectr. Manual de usuari 24/33
En el cas de seleccinar una prpiedad prperty, la diferencia cn respect al menú anterir es que n aparece la pción Shw Inhereted Members, y la última pción sería G t Prperty type, que al pulsarl muestra la tip de la prpiedad..net Reflectr. Manual de usuari 25/33
Al seleccinar un namespace aparecen las siguientes pcines, explicadas ya anterirmente. Back Frward Cpy Disassembler Analyzer Search MSDN 4 Enlaces de referencia Página para descargar el prgrama http://www.aist.cm/reder/dtnet/ Manual de ayuda http://msdn.micrsft.cm/msdnmag/issues/04/07/musthavetls/default.aspx http://alexbrisen.blgspt.cm/2006/03/qu-hace-net-reflectr.html 5 Utilidad Práctica Se trata de una herramienta que permitirá descmpilar y generar el códig fuente riginal de las clases generadas. Permitiend de esta frma la validación del códig desplegad en ls distints entrns, asegurándns así la realización de un crrect despliegue..net Reflectr. Manual de usuari 26/33
6 Anex 1: Ejempl El ejempl plantead decmpila ls ensamblads de la slución NCverCalcul (NCverCalcul.exe y NCverCalculadra.dll), bteniend así el códig fuente que generó dichs ensamblads. 6.1 Reslución SI es la primera vez que se ejecuta Reflectr n aparecerá, en el directri dnde se encuentra el ejecutable Reflectr.exe, el archiv de cnfiguración Reflectr.cfg. En tal cas, en el mment de abrir la aplicación, ejecutand el archiv Reflectr.exe, se ns mstrará una ventana para seleccinar la versión del framewrk que se desea utilizar, cm muestra la siguiente imagen:.net Reflectr. Manual de usuari 27/33
Para este ejempl seleccinarems la versión.net Framewrk 2.0.50727. Y se pdrá bservar en la siguiente imagen la ventana principal de la aplicación: Es el mment de abrir el ensamblad ensamblads a decmpilar. Para ell se hará us de la pción de menú File > Open y accederems a la lcalización de dichs ensamblads (NCverCalcul.exe y NCverCalculadra.dll):.Net Reflectr. Manual de usuari 28/33
La siguiente imagen muestra ambs ensamblads una vez abierts pr la aplicación. Se pdrá ir desplegand cada un de ests ensamblads para btener tds ls elements que ls integran y bservar el códig fuente decmpilad de cada un de ells: Deberems seleccinar la herramienta Disassemble para pder bservar el códig fuente decmpilad (pción de menú Tls > Disassembl): Tendrems la pción de seleccinar el lenguaje utilizad para btener el códig fuente. Se pdrá elegir entre ls lenguajes que aparecen en el desplegable de la siguiente imagen (IL, C#, Visual Basic. Delphi, MC++, Chrme):.Net Reflectr. Manual de usuari 29/33
La siguiente imagen muestra el códig decmpilad del element Frm1 en el lenguaje seleccinad (C#). Se puede bservar que n se muestran las instruccines relativas a cada un de ls métds implementads:.net Reflectr. Manual de usuari 30/33
Para ell habrá que hacer us del enlace Expands Methds (ventana Disassembler) que ns mstrará cmpletamente el códig fuente del archiv decmpilad: Otr punt interesante es cncer que al cerrar la herramienta se creará un archiv de cnfiguración Reflectr.cfg cn las pcines previamente seleccinadas cm el lenguaje activ y la versión del framewrk seleccinad..net Reflectr. Manual de usuari 31/33
El cntenid de dich archiv de cnfiguración puede bservarse en la siguiente imagen: La próxima vez que se haga us de la herramienta n aparecerá la ventana de selección del framewrk a utilizar debid a la existencia de este archiv de cnfiguración. En cas de desear pder seleccinar el framewrk habrá que eliminar dich archiv de cnfiguración..net Reflectr. Manual de usuari 32/33