ReportViewer C#
ReportViewer C#
Hola a todos:
El siguiente articulo pretende mostrar la manera de crear un reporte local usando ReportViewer y
Local Report o Rdlc enlazando su origen datos (DataSource) a una fuente proveniente de una Lista
Genrica de propiedades. Como se que esto puede resultar un tema demasiado complicado
cuando no se tiene experiencia en el manejo de reportes tratare de que el articulo sea lo mas
descriptivo posible y para ello me apoyare en la mayor cantidad de imgenes posibles, traten de
realizar el ejemplo siguiendo el tutorial, si un paso no les queda claro sintanse con toda confianza
de hacer las consultas necesarias, al final del articulo tendrn el link de descarga del proyecto de
ejemplo.
Los datos los enviaremos desde un formulario simulando ser los datos de una Factura comercial,
que contiene Datos del cliente y los artculos adquiridos.
Bien, comencemos creando un Formulario y arrastrando los controles necesarios hasta obtener un
formulario como este:
Ahora, crearemos las clases contenedoras de las entidades, recuerde que una entidad esta
Establezca el Nombre del conjunto de datos y haga click sobre el botn Nuevo:
Seleccione la clase EFactura, recuerde que esta clase contiene las propiedades para el
encabezado de la factura y haga Click sobre el botn Finalizar (Si no hubiera generado el proyecto
estas clases no estaran visibles, as que si no las ve por favor cierre la ventana y genere la
solucin):
Observe que ya tiene una fuente de datos seleccionada, solo haga Click en el botn Aceptar:
Siga los mismos pasos para agregar la fuente de datos para el detalle del reporte solo que ahora
seleccionara la clase EArticulo, al final tendr un resultado como el siguiente:
Un punto muy importante en este paso es tener presente el Ancho o alto del reporte dependiendo
que tipo de orientacin se haya elegido, en este caso el ancho es lo que interesa, considere que
tiene un ancho mximo de 21.59 cm. a este espacio le restara el valor total de los mrgenes que
son 2.0 cm en total ya que configuro un margen de 0.5 cm, dando un espacio de trabajo real
disponible de 19.59 cm., si en el diseo de nuestro reporte nos pasamos de este espacio
disponible nuestro reporte en lugar de mostrarnos una hoja nos mostrar ara dos, normalmente la
segunda hoja sin o con pocos datos.
Bien, continuemos
Agregue un encabezado de reporte, men Informe > Agregar encabezado de pagina
Active el cuadro de herramientas, men Ver > Cuadro de herramientas:
Arrastre tantos Cuadros de texto como se requieran, recuerde que nuestros datos provienen de
una clase, entonces por cada campo-propiedad de la clase tiene que crear un control Cuadro de
texto para poder visualizar el datoesto de crear un control por cada propiedades de la clase
origen es nicamente para este reporte, en realidad usted puede elegir que datos mostrar y cuales
no.
Configurar control cuadro de texto:
Click derecho sobre el control cuadro de texto que deseemos configurar:
Recuerde que establecer un nombre a los controles que vayamos utilizando es de vital importancia
porque ser en base a este como los identificaremos, en proyectos pequeos tal vez no tenga
problemas si deja los nombres asignados por default pero, en proyectos grandes esta mala
practica nos provocara constantes dolores de cabeza, entonces, nunca olvide ponerle un nombre a
los controles. Considere que el nombre debe de identificar fcilmente al control al que hace
referencia y al dato que contendr o al cual estar relacionado, en este caso txtFactura es muy
descriptivo, ya que se entiende que es un control textBox o cuadro de texto y que contendr el
numero de factura.
Para definir el origen del dato que mostrara el control cuadro de texto despliegue el ComboBox
Valor, vera que este estar cargado con las propiedades de las clases las cuales definimos como
fuente de datos, no le ser difcil identificar a que clase pertenece cada una ya que al final podra
ver el nombre que le puso al origen de datos.
Desactivar la casilla Permitir aumentar el alto puede resultar muy importante para conservar un
buen diseo, tener activada esta casilla permite que el control cambie de tamao en tiempo de
ejecucin adecundose al tamao del valor que contiene, modificando con esto el diseo hasta el
punto de generar hojas innecesarias.
En este ejemplo el campo Factura ser del tipo numrico por lo cual para conservar un formato de
numero correcto, tendr que configurar el lenguaje que utilizara el campo, para mi ubicacin
(Mxico) la configuracin de lenguaje ser es-Mex, para configurar esta propiedad:
Seleccione el control cuadro de texto > Presione F4:
Si no hiciera esto, un formato numrico podra no mostrarse correctamente por ejemplo la cantidad
Mil doscientos cincuenta y seis con cincuenta y seis decimales en Mxico ser 1,256.56 pero en
Espaa se escribira de esta manera 1.256,56. Esta configuracin debemos de hacerla aun si en la
De nuevo, recuerde que nombrar correctamente a cada control que agregamos es de vital
importancia:
Ahora, arrastre dos controles Cuadro de texto al informe, y vaya a las propiedades para configurar
el valor a mostrar:
Haga lo mismo para el segundo control agregado, veamos como va nuestro diseo del informe:
Para el detalle del informe, agregue un Tabla arrastrndola desde el cuadro de herramientas, vaya
a las propiedades de la tabla recin agregada, ubique la propiedad DataSetName par establecer el
origen de datos y seleccione Detalle, recuerde que ese fue el nombre que establecimos al origen
de datos:
Agregue las columnas que falten para completar el cuerpo del informe, para ello haga Click
derecho sobre la tabla, Insertar columna, Izquierda o derecha.
Despus establezca el valor que mostrara cada columna, para ello tiene dos opciones, seleccionar
el valor desde el icono que vera en la esquina superior derecha de cada celda o ir a propiedades
del cuadro de texto tal cual como lo hizo anteriormente:
Establezca el tamao de fuente, borde, tipo de dato, lenguaje a utilizar (recuerde lo comentado
anteriormente sobre el formato de numero/moneda)
Como va nuestro diseo de informe?
Si tienen un resultado como este, pueden dar su tarea por terminada en cuanto al diseo del
informe si aun no lo logran, todo es cuestin que revisen como configurar un control TextBox o
cuadro de texto como gusten llamarlo y ponerse a ver Alineacin, tipo de fuente, borde, relleno,
etc
Hasta aqu daremos por terminado nuestro diseo, ahora vayamos a:
Establecer una Lista Genrica como DataSource de un local report:
Ubique el Formulario contenedor del ReportViewer llamado FacturaRpt, seleccione el icono
superior derecho del reportViewer > Seleccione el local report que utilizaremos (el nico que
hemos diseado)
Una vez echo lo anterior, genere el evento Load del Formulario, para ello puede hacer doble click
sobre la barra de titulo o seleccionar el form y presionar la tecla de funcin F4, esto abrir la caja
de propiedades, en la parte superior podr ver un icono con forma de rayo de color amarillo, haga
click sobre el para ver los eventos que implementa el control, despus ubique el Evento que le
interese implementar en este caso nos interesa el evento Load.
Copie y pegue el siguiente cdigo:
Cdigo C#:
using System;
using System.Collections.Generic;
using System.Windows.Forms;
using Microsoft.Reporting.WinForms;
namespace ReportViewerInvoiceReport_CSharp
{
public partial class FacturaRpt : Form
{
//
//Cree dos listas una para el Encabezado y otra para el detalle
//
public List<EFactura> Invoice = new List<EFactura>();
public List<EArticulo> Detail = new List<EArticulo>();
//
//Cree las propiedades publicas Titulo y Empresa
//
public string Titulo { get; set; }
public string Empresa { get; set; }
public FacturaRpt()
{
InitializeComponent();
}
private void FacturaRpt_Load(object sender, EventArgs e)
{
//Limpiemos el DataSource del informe
reportViewer1.LocalReport.DataSources.Clear();
//
//Establezcamos los parmetros que enviaremos al reporte
//recuerde que son dos para el titulo del reporte y para el
nombre de la empresa
//
ReportParameter[] parameters = new ReportParameter[2];
parameters[0] = new ReportParameter("parameterTitulo",
Titulo);
parameters[1] = new ReportParameter("parameterEmpresa",
Empresa);
//
'
'Establezcamos la lista como Datasource del informe
'
ReportViewer1.LocalReport.DataSources.Add(New
ReportDataSource("Encabezado", Invoice))
ReportViewer1.LocalReport.DataSources.Add(New
ReportDataSource("Detalle", Detail))
'
'Enviemos la lista de parametros
'
ReportViewer1.LocalReport.SetParameters(parameters)
'
'Hagamos un refresh al reportViewer
'
ReportViewer1.RefreshReport()
End Sub
End Class
Hagamos lo ultimo que falta, enviar los datos desde el formulario principal:
Genere el Evento load del Formulario principal,
Despus de generado el evento trate de seguir estas lneas de cdigo, escriba linea por linea si
copia y pega ser mas complicado que comprenda (suponiendo que su experiencia en desarrollo
no es amplia):
Cdigo C#:
using
using
using
using
System;
System.Collections.Generic;
System.Linq;
System.Windows.Forms;
namespace ReportViewerInvoiceReport_CSharp
{
public partial class Form1 : Form
{
public Form1()
{
InitializeComponent();
}
/// <summary>
/// Funcion encargada de llenar el control DataGridView
/// <autor>Jos Luis Garca Bautista</autor>
/// </summary>
/// <returns>Una lista generica de la clase artculo</returns>
private static List<EArticulo> FillDgv()
{
//
//Cree una lista generica de la entidad EArticulo
//
List<EArticulo> listaArticulos = new List<EArticulo>();
//
//Instancie la clase EArticulo para agregar datos a la lista
//
EArticulo item = new EArticulo
{
//Establezca valores a cada una de
las propiedades
Numero = 1,
Upc = "7501020405680",
Descripcion = "Descripcin del
artculo 1",
Piezas = 6,
Precio = new decimal(12.50),
Importe = (decimal)(6 * 12.5),
};
//
//Agregamos el Item a la lista
//
listaArticulos.Add(item);
EArticulo item1 = new EArticulo
{
Numero = 2,
Upc = "7501040805610",
Descripcion = "Descripcin del
artculo 2",
Piezas = 3,
Precio = new decimal(22.50),
Importe = (decimal)(3 * 22.5),
};
listaArticulos.Add(item1);
EArticulo item2 = new EArticulo
{
Numero = 3,
Upc = "0412200805610",
Descripcion = "Descripcin del artculo 3",
Piezas = 20,
Precio = new decimal(52.80),
Importe = (decimal)(20 * 52.80),
};
listaArticulos.Add(item2);
return listaArticulos;
}
private void Form1_Load(object sender, EventArgs e)
{
//
//La funcion GenerateNumber() se utiliza unicamente para
generar un Nmero
//aleatorio que simulara ser el numerod e factura
txtnumero.Text = GenerateNumber().ToString();
//Establecemos la propiedad AutoGenerateColumns en False para
evitar que se agreguen
//nuevas columnas a la derecha de las que creamos en tiempo
de diseo.
//
dgvdetalle.AutoGenerateColumns = false;
//
//Establecemos el DataSource del control DataGridView
//
dgvdetalle.DataSource = FillDgv();
//
//Mapeamos las propiedades de la clase devuelta por la
Funcion FillDgv()
invoice.FechaFacturacion = dtpfecha.Value.Date;
invoice.Subtotal = Convert.ToDecimal(txtsubtotal.Text);
invoice.Iva = Convert.ToDecimal(txtiva.Text);
invoice.Total = Convert.ToDecimal(txttotal.Text);
//Recorremos los Rows existentes actualmente en el control
DataGridView
//para asignar los datos a las propiedades
foreach (DataGridViewRow row in dgvdetalle.Rows)
{
EArticulo article = new EArticulo();
//
//Vamos tomando los valores de las celdas del row que
estamos
//recorriendo actualmente y asignamos su valor a la
propiedad de la clase intanciada
//
article.Numero =
Convert.ToInt32(row.Cells["columnNumero"].Value);
article.Upc =
Convert.ToString(row.Cells["columnUpc"].Value);
article.Descripcion =
Convert.ToString(row.Cells["columnDescripcion"].Value);
article.Piezas =
Convert.ToDecimal(row.Cells["columnPiezas"].Value);
article.Precio =
Convert.ToDecimal(row.Cells["columnPrecio"].Value);
article.Importe =
Convert.ToDecimal(row.Cells["columnImporte"].Value);
//
//Vamos agregando el Item a la lista del detalle
//
invoice.Detail.Add(article);
}
//
//Creamos una instancia del Formulario que contiene nuestro
//ReportViewer
//
FacturaRpt frm = new FacturaRpt();
//
//Usamos las propiedades publicas del formulario, aqui es
donde enviamos el valor
//que se mostrara en los parametros creados en el
LocalReport, para este ejemplo
'
dgvdetalle.AutoGenerateColumns = False
'
'Establecemos el DataSource del control DataGridView
'
dgvdetalle.DataSource = FillDgv()
'
'Mapeamos las propiedades de la clase devuelta por la Funcion
FillDgv()
'recuerde que esta funcion devuelve una lista del tipo EArticulo
'
dgvdetalle.Columns("columnNumero").DataPropertyName = "Numero"
dgvdetalle.Columns("columnUpc").DataPropertyName = "Upc"
dgvdetalle.Columns("columnDescripcion").DataPropertyName =
"Descripcion"
dgvdetalle.Columns("columnPiezas").DataPropertyName = "Piezas"
dgvdetalle.Columns("columnPrecio").DataPropertyName = "Precio"
dgvdetalle.Columns("columnImporte").DataPropertyName = "Importe"
'
'Hacemos las sumatorias usando un mtodo de extensin de Linq
'
Dim sum As Decimal = FillDgv().Sum(Function(x) x.Importe)
Dim iva As Decimal = (Math.Round(((sum / 116) * 16), 2))
Dim subtotal As Decimal = Math.Round(sum - iva, 2)
txttotal.Text = Convert.ToString(Math.Round(sum, 2))
txtiva.Text = Convert.ToString(iva)
txtsubtotal.Text = Convert.ToString(subtotal)
End Sub
Private Shared Function GenerateNumber() As Integer
Dim rdm As New Random()
Return rdm.[Next]()
End Function
Private Sub InvoiceGenerate()
'
'Hacemos una instancia de la clase EFactura para
'llenarla con los valores contenidos en los controles del
Formulario
Dim invoice As New EFactura()
invoice.Numero = Convert.ToInt32(txtnumero.Text)
invoice.Nombre = txtnombre.Text
invoice.Rfc = txtrfc.Text
invoice.Direccion = txtdireccion.Text
invoice.FechaFacturacion = dtpfecha.Value.[Date]
invoice.Subtotal = Convert.ToDecimal(txtsubtotal.Text)
invoice.Iva = Convert.ToDecimal(txtiva.Text)
invoice.Total = Convert.ToDecimal(txttotal.Text)
'Recorremos los Rows existentes actualmente en el control
DataGridView
'para asignar los datos a las propiedades
For Each row As DataGridViewRow In dgvdetalle.Rows
Dim article As New EArticulo()
'
'Vamos tomando los valores de las celdas del row que estamos
'recorriendo actualmente y asignamos su valor a la propiedad
de la clase intanciada
'
article.Numero =
Convert.ToInt32(row.Cells("columnNumero").Value)
article.Upc = Convert.ToString(row.Cells("columnUpc").Value)
article.Descripcion =
Convert.ToString(row.Cells("columnDescripcion").Value)
article.Piezas =
Convert.ToDecimal(row.Cells("columnPiezas").Value)
article.Precio =
Convert.ToDecimal(row.Cells("columnPrecio").Value)
article.Importe =
Convert.ToDecimal(row.Cells("columnImporte").Value)
'
'Vamos agregando el Item a la lista del detalle
'
invoice.Detail.Add(article)
Next
'
'Creamos una instancia del Formulario que contiene nuestro
'ReportViewer
'
Dim frm As New FacturaRpt()
'
'Usamos las propiedades publicas del formulario, aqui es donde
enviamos el valor
'que se mostrara en los parametros creados en el LocalReport,
para este ejemplo
'estamos Seteando los valores directamente pero usted puede usar
algun control
'
frm.Titulo = "Este es un ejemplo de Factura"
frm.Empresa = "Este es un ejemplo del Nombre de la Empresa"
'
'Recuerde que invoice es una Lista Generica declarada en
FacturaRtp, es una lista
'porque el origen de datos del LocalReport unicamente permite ser
enlazado a objetos que
'implementen IEnumerable.
'
'Usamos el metod Add porque Invoice es una lista e invoice es una
entidad simple
frm.Invoice.Add(invoice)
'
'Enviamos el detalle de la Factura, como Detail es una lista e
invoide.Details tambien
'es un lista del tipo EArticulo bastara con igualarla
'
frm.Detail = invoice.Detail
frm.Show()
End Sub
Private Sub btnImprimir_Click(sender As System.Object, e As
System.EventArgs) Handles btnImprimir.Click
InvoiceGenerate()
End Sub
End Class
Ahora solo queda probar nuestra aplicacin:
Llenamos los datos:
Presione el botn Imprimir, si sigui al pie de la letra el Articulo tendr un reporte como este:
Observe, en el reporte el Formato numrico y Mdena, al igual que no tenemos hojas de mas sin
datos
Ahora, exporte el reporte a Pdf y observe que los mrgenes estn dentro del limite, sin generar
hojas de mas, ni salirse de los mrgenes:
Bueno, hemos llegado al final de este tutorial, en un entrega posterior abordaremos las imgenes
en Reportes Locales y utilizaremos una Bd como fuente de datos para nuestro reporte.
Saludos desde Monterrey, Nuevo Len Mxico!
Ejemplo C#
Ejemplo Vb.Net
Nota: El proyecto fue desarrollado en Vs2010 Ultmate usando Framework 4.0
Programacin en 3 capas
Hola a todos:
Despus de tantos meses de tener abandonado el Blog por fin hoy se libera un espacio en mi
agenda, tiempo que he decidido compartir con todos y cada uno de ustedes.
En este articulo hablare y tratare de explicar con los detalles mas mnimos que es la arquitectura 3
capas, cuales son sus ventajas, como empezar un proyecto 3 capas, cuales son las diferencias
entre cada una de ellas, como comunicarlas y como crear un proyecto con la arquitectura 3 capas
utilizando Visual Studio 2012.
Antes de comenzar a leer este articulo recuerde que: El objetivo no es otro mas que el de orientar
a los Parvulos .Net sobre la arquitectura de software 3 capas, todo lo escrito en este articulo no es
ensayado, no es revisado por nadie mas, por lo cual podra contener errores gramaticales y
sintcticos, el articulo y sus conceptos no pretenden ser la verdad absoluta del tema, sintase en
confianza de dejar sus comentarios y opiniones en la seccin de comentarios al final del mismo y si
lo considera prudente enveme un correo electrnico por medio del formulario de contacto y por
ultimo si el articulo le es de utilidad por favor considere dejar un comentario de agradecimiento.
Requisitos: Visual Studio 2012, Framework 4.0, el proveedor de datos SqlCompact 4.0 instalado en
su equipo y muchas ganas de aprender.
Como siempre recomiendo encarecidamente que antes de descargar los proyectos de ejemplo
(que les pondr al final de articulo), traten de hacerlo ustedes mismos siguiendo paso a paso todo
lo que se mencionara aqu, si tienen dudas en uno en especifico no duden en contactarme.
Dicho todo lo anterior, comencemos
ejectelo, analice el cdigo, observe como para realizar una misma funcionalidad en dos lugares
diferentes tuvimos que escribir casi las mismas lneas de cdigo.
A partir de aqu en adelante estaremos trabajando con el proyecto descargado, aplicndole la
Arquitectura 3 capas para demostrar como esta Arquitectura de Diseo nos ayuda a:
Separar responsabilidades, cada capa tiene una funcin especifica y no interviene con la
de las dems.
Reutilizar cdigo
La separacin de roles en tres capas, hace mas fcil reemplazar o modificar a una, sin
afectar a los mdulos restantes
Capacidad de migrar nuestro motor de Base de Datos sin grandes impactos al resto del
proyecto.
Poder cambiar el Front de nuestra aplicacin sin afectar a la lgica de nuestra aplicacin ni
a la Base de datos
Bien como ya hemos mencionado La Arquitectura de diseo 3 capas, consiste en dividir el diseo
del software en sus tres principales componentes:
1.
La Interfaz o UI (User interface): Esta Capa es la encargada de interactuar con el
usuario, es decir, son aquellas ventanas, mensajes, cuadros de dilogos o paginas web
(en el caso del desarrollo web), que el usuario final utiliza para comunicarse con la
aplicacin, por medio de esta capa el usuario solicita que se ejecuten las tareas
proporcionando parmetros de entrada. Esta capa se comunica con la capa de Lgica de
Negocio, enviando y solicitando informacin y con la capa de Entidades usando sus
objetos.
2.
La lgica de negocio o Business Logic: Se encarga de implementar, como su
nombre lo dice, la lgica del negocio, es decir, todo lo que el Software debe de considerar
antes de realizar una accin o el proceso que debe de seguir despus de realizar una
accin. Por ejemplo: Antes de solicitar a la capa de Datos la insercin de un grupo de
registros en una tabla, valida que vayan todos los campos mandatorios dentro de esa
solicitud si esta condicin no se cumple entonces rechaza la insercin e informa del
usuario del status de su solicitud, solicitar a la base de datos que valide la presencia de un
registro antes de insertar el siguiente, validar los tipos de datos, etc. esos ejemplos por
mencionar los mas bsicos y generales. Esta capa recibe de la Capa de Presentacin las
solicitudes, valida que las condiciones que establece el negocio se cumplan antes de
realizar dicha accin o de hacer la respectiva solicitud a la Capa de Acceso a Datos
3.
El acceso a Datos o Data Access: Esta capa es la encargada de la comunicacin
con la base de datos, en esta capa descansaran todas nuestras acciones CRUD (Create,
Read, Update y Delete), ser la nica que sabr que motor de base de datos se esta
utilizando pero le ser completamente desconocido el front, es decir, jams sabr si
nuestra aplicacin es una aplicacin web o desktop. Se encarga de recibir las peticiones de
la Capa de Lgica de Negocio, ejecutar dichas acciones y devolver el resultado a la misma
capa.
4.
Capa de Entidades o Entity Layer: Aunque aparentemente es una cuarta capa
realmente no lo es, esta capa se encarga de contener todos aquellos objetos (clases) que
representan al negocio, y esta es la nica que puede ser instanciada en las 3 capas
anteriores, es decir, solo ella puede tener comunicacin con el resto pero su funcin se
Hasta aqu, hemos visto la teora de lo que representa la Arquitectura 3 Capas, pero
Como es que debo representar la Arquitectura 3 Capas en un proyecto de Visual Studio?
Para haya es a donde vamos.
1. Abra el Visual Studio 2012 y cree un proyecto Vaco y nmbrelo CSharp-3Capas-Primer
Entrega
2. Dirjase al Explorador de soluciones y haga click derecho sobre el proyecto que acabamos de
crear:
4. Seleccione, Instalado > Visual C# > Windows > Aplicacin de Windows Forms > En el
campo Nombre escriba, Tienda-Presentacion y presione el botn Aceptar.
Observe que cuando creamos el proyecto principal en automtico se creo un proyecto vaco,
eliminemos ese proyecto para dejar la siguiente estructura:
Ahora ya tenemos nuestra estructura completa, observe que creamos 4 proyectos dentro del
principal (que lo iniciamos como proyecto vaco), recuerde que el proyecto de Entidades en este
caso Tienda-Entidades no es una capa, mas bien, complementa a la capa de Lgica de Negocio.
Continuemos con nuestro diseo
Capa de Entidades
Recuerde que en esta capa estarn alojados los objetos (clases) con los cuales estaremos
trabajando, con estos objetos estaremos persistiendo las tablas de la base de datos que
utilizaremos.
La base de datos que usaremos contiene una sola tabla llamada Producto la cual contiene 5
campos (Id int, Descripcin nvarchar, Marca nvarchar, Precio nvarchar), por lo cual la Capa de
Entidades contendr un Objeto llamado Producto con 5 propiedades publicas cada uno de ellos
respetando el tipo de dato con el cual esta declarado en la base de datos.
Para declarar nuestra Entidad Producto:
1. Agregue una clase al proyecto Tienda-Entidades y llmela EProducto (La letra E es por
convecin, es decir, todos los objetos de nuestra capa de Entidades llevaran la letra E al principio
para que desde donde las lleguemos a utilizar sepamos que ese Objeto es una Entidad evitando
con esto confusiones con otros objetos), dentro agregue las siguientes lneas de cdigo:
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
namespace Tienda_Entidades
{
public class EProducto
{
public int Id { get; set; }
public string Descripcion { get; set; }
public string Marca { get; set; }
public decimal Precio { get; set; }
}
}
Si tuviramos mas tablas en nuestra base de datos tendramos que crear la misma cantidad de
objetos en nuestra capa de Entidades y dentro contendran la misma cantidad de propiedades
como campos tiene la tabla siempre respetando el tipo de dato con lo que estos campos estn
declarados.
no porque lo vaya a utilizar sino que nuestro software cada vez que arranque buscara este archivo
en el directorio desde donde se este ejecutando la aplicacin, para efectos de prueba ser en la
carpeta ..bin\debug pero cuando nuestro proyecto este instalado, el archivo quedara desplegado
justo en la carpeta raz de nuestra instalacin junto con el .exe por tal motivo deber de estar en
el mismo proyecto que esta marcado como proyecto de inicio.
Para agregar un archivo de configuraciones siga estos pasos:
- Click derecho sobre el proyecto Tienda-AccesoDatos > Agregar > Nuevo elemento
</configuration>
Observen que el DataSource apunta a la carpeta que acabamos de crear en la unidad C Data
Source=C:\Proyecto-3Capas\Database1.sdf", esta cadena en proyetos reales normalmente
apuntara a un servidor de datos, pero para fines ilustrativos, este directorio nos servir muy bien.
Volvamos a nuestra Capa de Datos
4. Agreguemos las referencias a las libreras System.Configuration para esto, Click sobre nuestra
capa de datos (proyecto Tienda-AccesoDatos) > Agregar Referencia
Observe como se a creado un nuevo elemento en nuestra carpeta de Referencias del proyecto
Tienda-AccesoDatos
9. Inserte una clase nueva llamada ProductoDal de donde Dal vendr de Data Access Layer,
dentro de la clase que acaba de crear tiene que declarar el espacio de
nombres System.Configuration, System.Data.SqlServerCe y del proyecto de Entidades, adems
tiene que declarar la clase como publica (para que la Capa de Lgica de Negocio pueda tener
acceso a ella)
Ya tenemos el puente de comunicacin entre nuestras Entidades y nuestra Capa de Datos. Solo
resta comenzar a codificar las acciones que querramos hacer con nuestra tabla Producto, recuerde
que el objeto ProductoDalnicamente tiene como responsabilidad trabajar con todo aquello
relacionado con Producto, as que comencemos haciendo la codificacin para Insertar, Traer todos
los registros existentes en nuestra tabla Producto, Traer, Actualizar y Eliminar por Id.
Para hacer esta tarea mas sencilla le proporcionare el cdigo que deber de poner en la clase
ProductoDal, pero, trate de escribir el cdigo para vaya analizando la estructura del mismo.
using
using
using
using
using
System;
System.Collections.Generic;
System.Linq;
System.Text;
System.Threading.Tasks;
cmd.Parameters.AddWithValue("@precio",
producto.Precio);
cmd.ExecuteNonQuery();
}
}
}
/// <summary>
/// Devuelve una lista de Productos ordenados por el campo Id de
manera Ascendente
/// </summary>
/// <returns>Lista de productos</returns>
/// <autor>Jos Luis Garca Bautista</autor>
public List<EProducto> GetAll()
{
//Declaramos una lista del objeto EProducto la cual ser la
encargada de
//regresar una coleccin de los elementos que se obtengan de
la BD
//
//La lista substituye a DataTable utilizado en el proyecto de
ejemplo
List<EProducto> productos = new List<EProducto>();
using (SqlCeConnection cnx = new
SqlCeConnection(ConfigurationManager.ConnectionStrings["cnnString"].ToStr
ing()))
{
cnx.Open();
const string sqlQuery = "SELECT * FROM Producto ORDER BY
Id ASC";
using (SqlCeCommand cmd = new SqlCeCommand(sqlQuery,
cnx))
{
SqlCeDataReader dataReader = cmd.ExecuteReader();
//
//Preguntamos si el DataReader fue devuelto con datos
while (dataReader.Read())
{
//
//Instanciamos al objeto Eproducto para llenar
sus propiedades
EProducto producto = new EProducto
{
Id =
Convert.ToInt32(dataReader["Id"]),
Descripcion =
Convert.ToString(dataReader["Descripcion"]),
Marca =
Convert.ToString(dataReader["Marca"]),
Precio =
Convert.ToDecimal(dataReader["Precio"])
};
//
//Insertamos el objeto Producto dentro de la
lista Productos
productos.Add(producto);
}
}
}
return productos;
}
/// <summary>
/// Devuelve un Objeto Producto
/// </summary>
/// <param name="idProducto">Id del producto a buscar</param>
/// <returns>Un registro con los valores del Producto</returns>
/// <autor>Jos Luis Garca Bautista</autor>
public EProducto GetByid(int idProducto)
{
using (SqlCeConnection cnx = new
SqlCeConnection(ConfigurationManager.ConnectionStrings["cnnString"].ToStr
ing()))
{
cnx.Open();
const string sqlGetById = "SELECT * FROM Producto WHERE
Id = @id";
using (SqlCeCommand cmd = new SqlCeCommand(sqlGetById,
cnx))
{
//
//Utilizamos el valor del parmetro idProducto para
enviarlo al parmetro declarado en la consulta
//de seleccin SQL
cmd.Parameters.AddWithValue("@id", idProducto);
SqlCeDataReader dataReader = cmd.ExecuteReader();
if (dataReader.Read())
{
EProducto producto = new EProducto
{
Id = Convert.ToInt32(dataReader["Id"]),
Descripcion =
Convert.ToString(dataReader["Descripcion"]),
Marca =
Convert.ToString(dataReader["Marca"]),
Precio =
Convert.ToDecimal(dataReader["Precio"])
};
return producto;
}
}
}
return null;
}
/// <summary>
/// Actualiza el Producto correspondiente al Id proporcionado
/// </summary>
/// <param name="producto">Valores utilizados para hacer el
Update al registro</param>
/// <autor>Jos Luis Garca Bautista</autor>
public void Update(EProducto producto)
{
using (SqlCeConnection cnx = new
SqlCeConnection(ConfigurationManager.ConnectionStrings["cnnString"].ToStr
ing()))
{
cnx.Open();
const string sqlQuery =
"UPDATE Producto SET Descripcion = @descripcion,
Marca = @marca, Precio = @precio WHERE Id = @id";
using (SqlCeCommand cmd = new SqlCeCommand(sqlQuery,
cnx))
{
cmd.Parameters.AddWithValue("@descripcion",
producto.Descripcion);
cmd.Parameters.AddWithValue("@marca",
producto.Marca);
cmd.Parameters.AddWithValue("@precio",
producto.Precio);
cmd.Parameters.AddWithValue("@id", producto.Id);
cmd.ExecuteNonQuery();
}
}
}
/// <summary>
/// Elimina un registro coincidente con el Id Proporcionado
/// </summary>
/// <param name="idproducto">Id del registro a Eliminar</param>
/// <autor>Jos Luis Garca Bautista</autor>
public void Delete(int idproducto)
{
using (SqlCeConnection cnx = new
SqlCeConnection(ConfigurationManager.ConnectionStrings["cnnString"].ToStr
ing()))
{
cnx.Open();
const string sqlQuery = "DELETE FROM Producto WHERE Id =
@id";
using (SqlCeCommand cmd = new SqlCeCommand(sqlQuery,
cnx))
{
cmd.Parameters.AddWithValue("@id", idproducto);
cmd.ExecuteNonQuery();
}
}
}
}
}
Observe como desde nuestros diferentes Mtodos y funciones estamos haciendo uso del
objeto EProductodeclarado en la capa de EntidadesObserve tambin como nuestra
clase ProductosDal no valida que el valor de las propiedades de EProducto contengan datos o
sean del tipo de dato correcto porque ese es trabajo de?La Capa de Lgica de Negocio
9. Agregue una nueva clase y llmela ProductoBol, haga los using de las referencias que
acabamos de crear, establezca el nivel de acceso como public y copie la siguiente estructura de
cdigo:
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
//
//Hacemos las importaciones del espacio de nombres de los dos proyectos
que referenciamos
//observe como esta capa solo referencio a Tienda-AccessData y no a
Tienda-Presentacion
//observe tambin como aqu no es requerida la referencia a
System.Data.SqlServerCe
using Tienda_AccesoDatos;
using Tienda_Entidades;
namespace Tienda_LogicaNegocio
{
public class ProductoBol
{
//Instanciamos nuestra clase ProductoDal para poder utilizar sus
miembros
private ProductoDal _productoDal = new ProductoDal();
//
//El uso de la clase StringBuilder nos ayudara a devolver los
mensajes de las validaciones
public readonly StringBuilder stringBuilder = new StringBuilder();
//
//Creamos nuestro mtodo para Insertar un nuevo Producto, observe
como este mtodo tampoco valida los el contenido
//de las propiedades, sino que manda a llamar a una Funcin que
tiene como tarea nica hacer esta validacin
//
public void Registrar(EProducto producto)
{
if(ValidarProducto(producto))
{
if (_productoDal.GetByid(producto.Id) == null)
{
_productoDal.Insert(producto);
}
else
_productoDal.Update(producto);
}
}
public List<EProducto> Todos()
{
return _productoDal.GetAll();
}
public EProducto TraerPorId(int idProduct)
{
stringBuilder.Clear();
if (idProduct == 0) stringBuilder.Append("Por favor
proporcione un valor de Id valido");
if(stringBuilder.Length == 0)
{
return _productoDal.GetByid(idProduct);
}
return null;
}
public void Eliminar(int idProduct)
{
stringBuilder.Clear();
if (idProduct == 0) stringBuilder.Append("Por favor
proporcione un valor de Id valido");
if (stringBuilder.Length == 0)
{
_productoDal.Delete(idProduct);
}
}
private bool ValidarProducto(EProducto producto)
{
stringBuilder.Clear();
if (string.IsNullOrEmpty(producto.Descripcion))
stringBuilder.Append("El campo Descripcin es obligatorio");
if (string.IsNullOrEmpty(producto.Marca))
stringBuilder.Append(Environment.NewLine + "El campo Marca es
obligatorio");
if (producto.Precio <= 0)
stringBuilder.Append(Environment.NewLine + "El campo Precio es
obligatorio");
return stringBuilder.Length == 0;
}
}
}
Analice cada uno de los mtodos y funciones que creamos en nuestro primer objeto de nuestra
capa de Negocio, observe:
La capa de negocio cumple otras tareas y no solo la de ser un puente entre nuestra Capa
de Datos y nuestra Capa de Presentacin
Como es que estamos usando nicamente objetos y no controles, recuerde que esta capa
tampoco sabe que tipo de proyecto es el que la estar usando.
11. En el formulario que tenemos por default llamado Form1 disee una interfaz como la
siguiente:
12. Observe las siguientes lneas de cdigo, genere los eventos involucrados y copie el cdigo de
ejemplo:
using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using System.Windows.Forms;
//
//Hacemos las importaciones del espacio de nombres de los dos proyectos
que referenciamos
//observe como esta capa solo referencio a Tienda-LogicNegocio y a
Tienda-Entidades
//observe como no se referencia a la clase de acceso a Datos
using Tienda_LogicaNegocio;
using Tienda_Entidades;
namespace Tienda_Presentacion
{
public partial class Form1 : Form
{
//
//
//Creamos las instancias de la clase Eproducto y ProductoBol
private EProducto _producto;
private readonly ProductoBol _productoBol = new ProductoBol();
public Form1()
{
InitializeComponent();
}
//
//Creamos los mtodos generales llenando y leyendo objetos
//
private void Guardar()
{
try
{
if (_producto == null) _producto = new EProducto();
_producto.Id = Convert.ToInt32(txtId.Text);
_producto.Descripcion = txtDescripcion.Text;
_producto.Marca = txtMarca.Text;
_producto.Precio = Convert.ToDecimal(txtPrecio.Text);
_productoBol.Registrar(_producto);
if (_productoBol.stringBuilder.Length != 0)
{
MessageBox.Show(_productoBol.stringBuilder.ToString(), "Para
continuar:");
}
else
{
MessageBox.Show("Producto registrado/actualizado con
xito");
TraerTodos();
}
}
catch (Exception ex)
{
MessageBox.Show(string.Format("Error: {0}", ex.Message),
"Error inesperado");
}
}
private void TraerTodos()
{
List<EProducto> productos = _productoBol.Todos();
if (productos.Count > 0)
{
dgvDatos.AutoGenerateColumns = false;
dgvDatos.DataSource = productos;
dgvDatos.Columns["columnId"].DataPropertyName = "Id";
dgvDatos.Columns["columnDescripcion"].DataPropertyName =
"Descripcion";
dgvDatos.Columns["columnMarca"].DataPropertyName =
"Marca";
dgvDatos.Columns["columnPrecio"].DataPropertyName =
"Precio";
}
else
MessageBox.Show("No existen producto Registrado");
}
private void TraerPorId(int id)
{
try
{
_producto = _productoBol.TraerPorId(id);
if (_producto != null)
{
txtId.Text = Convert.ToString(_producto.Id);
txtDescripcion.Text = _producto.Descripcion;
txtMarca.Text = _producto.Marca;
txtPrecio.Text = Convert.ToString(_producto.Precio);
}
else
MessageBox.Show("El Producto solicitado no existe");
}
catch (Exception ex)
{
MessageBox.Show(string.Format("Error: {0}", ex.Message),
"Error inesperado");
}
}
private void Eliminar(int id)
{
try
{
_productoBol.Eliminar(id);
MessageBox.Show("Producto eliminado satisfactoriamente");
TraerTodos();
}
catch (Exception ex)
{
MessageBox.Show(string.Format("Error: {0}", ex.Message),
"Error inesperado");
}
}
//
//
//Usamos nuestros metodos y funciones generales, observe como no
hemos repetido codigo en ningun lado
//haciendo con esto que nuestras tareas de actualizacion sean mas
sencillas para nosotros o para
//al asignado en realizarlas...
private void btnAgregar_Click(object sender, EventArgs e)
{
Guardar();
}
private void txtId_KeyDown(object sender, KeyEventArgs e)
{
Aqu termina nuestro articulo sobre Arquitectura 3 Capas, espero haya sido de su agrado y que la
explicacin haya sido lo bastante clara, en caso de que tenga alguna duda por favor deje su
pregunta en la seccin de comentarios o escrbame por medio del formulario de contacto.
Escribir este articulo me llevo mas de 4 horas, dejar un comentario de agradecimiento le tomara 5
minutos.
Saludos desde Monterrey, Nuevo Len Mxico!
Ejemplo C#
Ejemplo Vb.Net
Programacin en 3 capas
Hola a todos:
Despus de tantos meses de tener abandonado el Blog por fin hoy se libera un espacio en mi
agenda, tiempo que he decidido compartir con todos y cada uno de ustedes.
En este articulo hablare y tratare de explicar con los detalles mas mnimos que es la arquitectura 3
capas, cuales son sus ventajas, como empezar un proyecto 3 capas, cuales son las diferencias
entre cada una de ellas, como comunicarlas y como crear un proyecto con la arquitectura 3 capas
utilizando Visual Studio 2012.
Antes de comenzar a leer este articulo recuerde que: El objetivo no es otro mas que el de orientar
a los Parvulos .Net sobre la arquitectura de software 3 capas, todo lo escrito en este articulo no es
ensayado, no es revisado por nadie mas, por lo cual podra contener errores gramaticales y
sintcticos, el articulo y sus conceptos no pretenden ser la verdad absoluta del tema, sintase en
confianza de dejar sus comentarios y opiniones en la seccin de comentarios al final del mismo y si
lo considera prudente enveme un correo electrnico por medio del formulario de contacto y por
ultimo si el articulo le es de utilidad por favor considere dejar un comentario de agradecimiento.
Requisitos: Visual Studio 2012, Framework 4.0, el proveedor de datos SqlCompact 4.0 instalado en
su equipo y muchas ganas de aprender.
Como siempre recomiendo encarecidamente que antes de descargar los proyectos de ejemplo
(que les pondr al final de articulo), traten de hacerlo ustedes mismos siguiendo paso a paso todo
lo que se mencionara aqu, si tienen dudas en uno en especifico no duden en contactarme.
Dicho todo lo anterior, comencemos
funciones para cada uno de los formularios, importar todas las referencias del motor de base de
datos en cada uno de los formularios, cambiar cdigo aqu y all (porque tiene copias del mismo
cdigo en muchos lugares), escribir la lgica de validacin de campos dentro del evento, corregir
los bugs que pudieran presentarse y no se diga de implementarles mejoras al software, etc., No?
entonces no se preocupe este es un buen manual de como evitarse muchos dolores de cabeza en
diseo de su arquitectura a seguir.
Para que se de una mejor idea de que hablo, por favor descargue este proyecto de ejemplo,
ejectelo, analice el cdigo, observe como para realizar una misma funcionalidad en dos lugares
diferentes tuvimos que escribir casi las mismas lneas de cdigo.
A partir de aqu en adelante estaremos trabajando con el proyecto descargado, aplicndole la
Arquitectura 3 capas para demostrar como esta Arquitectura de Diseo nos ayuda a:
Separar responsabilidades, cada capa tiene una funcin especifica y no interviene con la
de las dems.
Reutilizar cdigo
La separacin de roles en tres capas, hace mas fcil reemplazar o modificar a una, sin
afectar a los mdulos restantes
Capacidad de migrar nuestro motor de Base de Datos sin grandes impactos al resto del
proyecto.
Poder cambiar el Front de nuestra aplicacin sin afectar a la lgica de nuestra aplicacin ni
a la Base de datos
Bien como ya hemos mencionado La Arquitectura de diseo 3 capas, consiste en dividir el diseo
del software en sus tres principales componentes:
1.
La Interfaz o UI (User interface): Esta Capa es la encargada de interactuar con el
usuario, es decir, son aquellas ventanas, mensajes, cuadros de dilogos o paginas web
(en el caso del desarrollo web), que el usuario final utiliza para comunicarse con la
aplicacin, por medio de esta capa el usuario solicita que se ejecuten las tareas
proporcionando parmetros de entrada. Esta capa se comunica con la capa de Lgica de
Negocio, enviando y solicitando informacin y con la capa de Entidades usando sus
objetos.
2.
La lgica de negocio o Business Logic: Se encarga de implementar, como su
nombre lo dice, la lgica del negocio, es decir, todo lo que el Software debe de considerar
antes de realizar una accin o el proceso que debe de seguir despus de realizar una
accin. Por ejemplo: Antes de solicitar a la capa de Datos la insercin de un grupo de
registros en una tabla, valida que vayan todos los campos mandatorios dentro de esa
solicitud si esta condicin no se cumple entonces rechaza la insercin e informa del
usuario del status de su solicitud, solicitar a la base de datos que valide la presencia de un
registro antes de insertar el siguiente, validar los tipos de datos, etc. esos ejemplos por
mencionar los mas bsicos y generales. Esta capa recibe de la Capa de Presentacin las
solicitudes, valida que las condiciones que establece el negocio se cumplan antes de
realizar dicha accin o de hacer la respectiva solicitud a la Capa de Acceso a Datos
3.
El acceso a Datos o Data Access: Esta capa es la encargada de la comunicacin
con la base de datos, en esta capa descansaran todas nuestras acciones CRUD (Create,
Read, Update y Delete), ser la nica que sabr que motor de base de datos se esta
utilizando pero le ser completamente desconocido el front, es decir, jams sabr si
nuestra aplicacin es una aplicacin web o desktop. Se encarga de recibir las peticiones de
la Capa de Lgica de Negocio, ejecutar dichas acciones y devolver el resultado a la misma
capa.
4.
Capa de Entidades o Entity Layer: Aunque aparentemente es una cuarta capa
realmente no lo es, esta capa se encarga de contener todos aquellos objetos (clases) que
representan al negocio, y esta es la nica que puede ser instanciada en las 3 capas
anteriores, es decir, solo ella puede tener comunicacin con el resto pero su funcin se
limita a nicamente ser un puente de transporte de datos. Esta capa complementa a la
Capa de Negocio
Para una mejor compresin de la comunicacin de las 3 capas:
Hasta aqu, hemos visto la teora de lo que representa la Arquitectura 3 Capas, pero
Como es que debo representar la Arquitectura 3 Capas en un proyecto de Visual Studio?
Para haya es a donde vamos.
1. Abra el Visual Studio 2012 y cree un proyecto Vaco y nmbrelo CSharp-3Capas-Primer
Entrega
2. Dirjase al Explorador de soluciones y haga click derecho sobre el proyecto que acabamos de
crear:
4. Seleccione, Instalado > Visual C# > Windows > Aplicacin de Windows Forms > En el
campo Nombre escriba, Tienda-Presentacion y presione el botn Aceptar.
Observe que cuando creamos el proyecto principal en automtico se creo un proyecto vaco,
eliminemos ese proyecto para dejar la siguiente estructura:
Ahora ya tenemos nuestra estructura completa, observe que creamos 4 proyectos dentro del
principal (que lo iniciamos como proyecto vaco), recuerde que el proyecto de Entidades en este
caso Tienda-Entidades no es una capa, mas bien, complementa a la capa de Lgica de Negocio.
Continuemos con nuestro diseo
Capa de Entidades
Recuerde que en esta capa estarn alojados los objetos (clases) con los cuales estaremos
trabajando, con estos objetos estaremos persistiendo las tablas de la base de datos que
utilizaremos.
La base de datos que usaremos contiene una sola tabla llamada Producto la cual contiene 5
campos (Id int, Descripcin nvarchar, Marca nvarchar, Precio nvarchar), por lo cual la Capa de
Entidades contendr un Objeto llamado Producto con 5 propiedades publicas cada uno de ellos
respetando el tipo de dato con el cual esta declarado en la base de datos.
Para declarar nuestra Entidad Producto:
1. Agregue una clase al proyecto Tienda-Entidades y llmela EProducto (La letra E es por
convecin, es decir, todos los objetos de nuestra capa de Entidades llevaran la letra E al principio
para que desde donde las lleguemos a utilizar sepamos que ese Objeto es una Entidad evitando
con esto confusiones con otros objetos), dentro agregue las siguientes lneas de cdigo:
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
namespace Tienda_Entidades
{
public class EProducto
{
public int Id { get; set; }
public string Descripcion { get; set; }
public string Marca { get; set; }
public decimal Precio { get; set; }
}
}
Si tuviramos mas tablas en nuestra base de datos tendramos que crear la misma cantidad de
objetos en nuestra capa de Entidades y dentro contendran la misma cantidad de propiedades
como campos tiene la tabla siempre respetando el tipo de dato con lo que estos campos estn
declarados.
carpeta ..bin\debug pero cuando nuestro proyecto este instalado, el archivo quedara desplegado
justo en la carpeta raz de nuestra instalacin junto con el .exe por tal motivo deber de estar en
el mismo proyecto que esta marcado como proyecto de inicio.
Para agregar un archivo de configuraciones siga estos pasos:
- Click derecho sobre el proyecto Tienda-AccesoDatos > Agregar > Nuevo elemento
Observen que el DataSource apunta a la carpeta que acabamos de crear en la unidad C Data
Source=C:\Proyecto-3Capas\Database1.sdf", esta cadena en proyetos reales normalmente
apuntara a un servidor de datos, pero para fines ilustrativos, este directorio nos servir muy bien.
Volvamos a nuestra Capa de Datos
4. Agreguemos las referencias a las libreras System.Configuration para esto, Click sobre nuestra
capa de datos (proyecto Tienda-AccesoDatos) > Agregar Referencia
Como nuestra capa de Acceso a Datos, debe de tener la capacidad de Insertar, Leer, Actualizar y
Eliminar registros de la tabla Productos, requiere de una comunicacin directa con la capa de
Entidades, para por ejemplo, al momento de que se le solicite la insercin de un Producto en lugar
de enviarle 5 parmetros con los datos del producto se le envi un Objeto y Cual ser este
objeto? nada mas y nada menos que nuestro objeto EProductocreado en la capa de Entidades, de
esta manera ya no trabajaremos con datos sino con objetos llenando, enviando y leyendo
propiedades.
Para lograr la comunicacin entre la Capa de Datos y la Capa de Entidades se requiere de la
referencia de una en la otra, en este caso la referencia de la Capa de Entidades dentro de la Capa
de Datos, para ello:
7. Click derecho sobre nuestro proyecto Tienda-AccesoDatos > Agregar Referencia
Observe como se a creado un nuevo elemento en nuestra carpeta de Referencias del proyecto
Tienda-AccesoDatos
9. Inserte una clase nueva llamada ProductoDal de donde Dal vendr de Data Access Layer,
dentro de la clase que acaba de crear tiene que declarar el espacio de
nombres System.Configuration, System.Data.SqlServerCe y del proyecto de Entidades, adems
tiene que declarar la clase como publica (para que la Capa de Lgica de Negocio pueda tener
acceso a ella)
Ya tenemos el puente de comunicacin entre nuestras Entidades y nuestra Capa de Datos. Solo
resta comenzar a codificar las acciones que querramos hacer con nuestra tabla Producto, recuerde
que el objeto ProductoDalnicamente tiene como responsabilidad trabajar con todo aquello
relacionado con Producto, as que comencemos haciendo la codificacin para Insertar, Traer todos
los registros existentes en nuestra tabla Producto, Traer, Actualizar y Eliminar por Id.
Para hacer esta tarea mas sencilla le proporcionare el cdigo que deber de poner en la clase
ProductoDal, pero, trate de escribir el cdigo para vaya analizando la estructura del mismo.
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
//nuestras importaciones del Espacio de nombres que estaremos utilizando,
//recuerde que estas son las referencias que realizamos hace unos
momentos...
using System.Configuration;
using System.Data.SqlServerCe;
using Tienda_Entidades;
namespace Tienda_AccesoDatos
{
//Definimos el acceso de nuestra clase como public, asegurando con
esto su accesibilidad desde
//otros proyectos.
public class ProductoDal
{
//Primero y siguiendo el orden de las acciones CRUD
//Crearemos un Mtodo que se encarga de insertar un nuevo
Producto es nuestra tabla Producto
/// <summary>
/// Inserta un nuevo Producto en la tabla Producto
/// </summary>
/// <param name="producto">Entidad contenedora de los valores a
insertar</param>
/// <autor>Jos Luis Garca Bautista</autor>
public void Insert(EProducto producto)
{
//Creamos nuestro objeto de conexion usando nuestro archivo
de configuraciones
using (SqlCeConnection cnx = new
SqlCeConnection(ConfigurationManager.ConnectionStrings["cnnString"].ToStr
ing()))
{
cnx.Open();
//Declaramos nuestra consulta de Accin Sql parametrizada
const string sqlQuery =
"INSERT INTO Producto (Descripcion, Marca, Precio)
VALUES (@descripcion, @marca, @precio)";
using (SqlCeCommand cmd = new SqlCeCommand(sqlQuery,
cnx))
{
//El primero de los cambios significativos con
respecto al ejemplo descargado es que aqui...
//ya no leeremos controles sino usaremos las
propiedades del Objeto EProducto de nuestra capa
//de entidades...
cmd.Parameters.AddWithValue("@descripcion",
producto.Descripcion);
cmd.Parameters.AddWithValue("@marca",
producto.Marca);
cmd.Parameters.AddWithValue("@precio",
producto.Precio);
cmd.ExecuteNonQuery();
}
}
}
/// <summary>
/// Devuelve una lista de Productos ordenados por el campo Id de
manera Ascendente
/// </summary>
/// <returns>Lista de productos</returns>
/// <autor>Jos Luis Garca Bautista</autor>
public List<EProducto> GetAll()
{
//Declaramos una lista del objeto EProducto la cual ser la
encargada de
//regresar una coleccin de los elementos que se obtengan de
la BD
//
//La lista substituye a DataTable utilizado en el proyecto de
ejemplo
List<EProducto> productos = new List<EProducto>();
using (SqlCeConnection cnx = new
SqlCeConnection(ConfigurationManager.ConnectionStrings["cnnString"].ToStr
ing()))
{
cnx.Open();
const string sqlQuery = "SELECT * FROM Producto ORDER BY
Id ASC";
using (SqlCeCommand cmd = new SqlCeCommand(sqlQuery,
cnx))
{
SqlCeDataReader dataReader = cmd.ExecuteReader();
//
//Preguntamos si el DataReader fue devuelto con datos
while (dataReader.Read())
{
//
//Instanciamos al objeto Eproducto para llenar
sus propiedades
EProducto producto = new EProducto
{
Id =
Convert.ToInt32(dataReader["Id"]),
Descripcion =
Convert.ToString(dataReader["Descripcion"]),
Marca =
Convert.ToString(dataReader["Marca"]),
Precio =
Convert.ToDecimal(dataReader["Precio"])
};
//
//Insertamos el objeto Producto dentro de la
lista Productos
productos.Add(producto);
}
}
}
return productos;
}
/// <summary>
/// Devuelve un Objeto Producto
/// </summary>
/// <param name="idProducto">Id del producto a buscar</param>
/// <returns>Un registro con los valores del Producto</returns>
/// <autor>Jos Luis Garca Bautista</autor>
public EProducto GetByid(int idProducto)
{
using (SqlCeConnection cnx = new
SqlCeConnection(ConfigurationManager.ConnectionStrings["cnnString"].ToStr
ing()))
{
cnx.Open();
const string sqlGetById = "SELECT * FROM Producto WHERE
Id = @id";
using (SqlCeCommand cmd = new SqlCeCommand(sqlGetById,
cnx))
{
//
//Utilizamos el valor del parmetro idProducto para
enviarlo al parmetro declarado en la consulta
//de seleccin SQL
cmd.Parameters.AddWithValue("@id", idProducto);
SqlCeDataReader dataReader = cmd.ExecuteReader();
if (dataReader.Read())
{
EProducto producto = new EProducto
{
Id = Convert.ToInt32(dataReader["Id"]),
Descripcion =
Convert.ToString(dataReader["Descripcion"]),
Marca =
Convert.ToString(dataReader["Marca"]),
Precio =
Convert.ToDecimal(dataReader["Precio"])
};
return producto;
}
}
}
return null;
}
/// <summary>
/// Actualiza el Producto correspondiente al Id proporcionado
/// </summary>
/// <param name="producto">Valores utilizados para hacer el
Update al registro</param>
/// <autor>Jos Luis Garca Bautista</autor>
public void Update(EProducto producto)
{
using (SqlCeConnection cnx = new
SqlCeConnection(ConfigurationManager.ConnectionStrings["cnnString"].ToStr
ing()))
{
cnx.Open();
const string sqlQuery =
"UPDATE Producto SET Descripcion = @descripcion,
Marca = @marca, Precio = @precio WHERE Id = @id";
using (SqlCeCommand cmd = new SqlCeCommand(sqlQuery,
cnx))
{
cmd.Parameters.AddWithValue("@descripcion",
producto.Descripcion);
cmd.Parameters.AddWithValue("@marca",
producto.Marca);
cmd.Parameters.AddWithValue("@precio",
producto.Precio);
cmd.Parameters.AddWithValue("@id", producto.Id);
cmd.ExecuteNonQuery();
}
}
}
/// <summary>
/// Elimina un registro coincidente con el Id Proporcionado
/// </summary>
/// <param name="idproducto">Id del registro a Eliminar</param>
/// <autor>Jos Luis Garca Bautista</autor>
public void Delete(int idproducto)
{
using (SqlCeConnection cnx = new
SqlCeConnection(ConfigurationManager.ConnectionStrings["cnnString"].ToStr
ing()))
{
cnx.Open();
const string sqlQuery = "DELETE FROM Producto WHERE Id =
@id";
using (SqlCeCommand cmd = new SqlCeCommand(sqlQuery,
cnx))
{
cmd.Parameters.AddWithValue("@id", idproducto);
cmd.ExecuteNonQuery();
}
}
}
}
}
Observe como desde nuestros diferentes Mtodos y funciones estamos haciendo uso del
objeto EProductodeclarado en la capa de EntidadesObserve tambin como nuestra
clase ProductosDal no valida que el valor de las propiedades de EProducto contengan datos o
sean del tipo de dato correcto porque ese es trabajo de?La Capa de Lgica de Negocio
9. Agregue una nueva clase y llmela ProductoBol, haga los using de las referencias que
acabamos de crear, establezca el nivel de acceso como public y copie la siguiente estructura de
cdigo:
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
//
//Hacemos las importaciones del espacio de nombres de los dos proyectos
que referenciamos
//observe como esta capa solo referencio a Tienda-AccessData y no a
Tienda-Presentacion
//observe tambin como aqu no es requerida la referencia a
System.Data.SqlServerCe
using Tienda_AccesoDatos;
using Tienda_Entidades;
namespace Tienda_LogicaNegocio
{
public class ProductoBol
{
//Instanciamos nuestra clase ProductoDal para poder utilizar sus
miembros
private ProductoDal _productoDal = new ProductoDal();
//
//El uso de la clase StringBuilder nos ayudara a devolver los
mensajes de las validaciones
public readonly StringBuilder stringBuilder = new StringBuilder();
//
//Creamos nuestro mtodo para Insertar un nuevo Producto, observe
como este mtodo tampoco valida los el contenido
//de las propiedades, sino que manda a llamar a una Funcin que
tiene como tarea nica hacer esta validacin
//
public void Registrar(EProducto producto)
{
if(ValidarProducto(producto))
{
if (_productoDal.GetByid(producto.Id) == null)
{
_productoDal.Insert(producto);
}
else
_productoDal.Update(producto);
}
}
public List<EProducto> Todos()
{
return _productoDal.GetAll();
}
public EProducto TraerPorId(int idProduct)
{
stringBuilder.Clear();
if (idProduct == 0) stringBuilder.Append("Por favor
proporcione un valor de Id valido");
if(stringBuilder.Length == 0)
{
return _productoDal.GetByid(idProduct);
}
return null;
}
public void Eliminar(int idProduct)
{
stringBuilder.Clear();
if (idProduct == 0) stringBuilder.Append("Por favor
proporcione un valor de Id valido");
if (stringBuilder.Length == 0)
{
_productoDal.Delete(idProduct);
}
}
private bool ValidarProducto(EProducto producto)
{
stringBuilder.Clear();
if (string.IsNullOrEmpty(producto.Descripcion))
stringBuilder.Append("El campo Descripcin es obligatorio");
if (string.IsNullOrEmpty(producto.Marca))
stringBuilder.Append(Environment.NewLine + "El campo Marca es
obligatorio");
if (producto.Precio <= 0)
stringBuilder.Append(Environment.NewLine + "El campo Precio es
obligatorio");
return stringBuilder.Length == 0;
}
}
}
Analice cada uno de los mtodos y funciones que creamos en nuestro primer objeto de nuestra
capa de Negocio, observe:
La capa de negocio cumple otras tareas y no solo la de ser un puente entre nuestra Capa
de Datos y nuestra Capa de Presentacin
Como es que estamos usando nicamente objetos y no controles, recuerde que esta capa
tampoco sabe que tipo de proyecto es el que la estar usando.
11. En el formulario que tenemos por default llamado Form1 disee una interfaz como la
siguiente:
12. Observe las siguientes lneas de cdigo, genere los eventos involucrados y copie el cdigo de
ejemplo:
using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using System.Windows.Forms;
//
//Hacemos las importaciones del espacio de nombres de los dos proyectos
que referenciamos
//observe como esta capa solo referencio a Tienda-LogicNegocio y a
Tienda-Entidades
//observe como no se referencia a la clase de acceso a Datos
using Tienda_LogicaNegocio;
using Tienda_Entidades;
namespace Tienda_Presentacion
{
public partial class Form1 : Form
{
//
//
//Creamos las instancias de la clase Eproducto y ProductoBol
private EProducto _producto;
private readonly ProductoBol _productoBol = new ProductoBol();
public Form1()
{
InitializeComponent();
}
//
//Creamos los mtodos generales llenando y leyendo objetos
//
private void Guardar()
{
try
{
if (_producto == null) _producto = new EProducto();
_producto.Id = Convert.ToInt32(txtId.Text);
_producto.Descripcion = txtDescripcion.Text;
_producto.Marca = txtMarca.Text;
_producto.Precio = Convert.ToDecimal(txtPrecio.Text);
_productoBol.Registrar(_producto);
if (_productoBol.stringBuilder.Length != 0)
{
MessageBox.Show(_productoBol.stringBuilder.ToString(), "Para
continuar:");
}
else
{
MessageBox.Show("Producto registrado/actualizado con
xito");
TraerTodos();
}
}
catch (Exception ex)
{
MessageBox.Show(string.Format("Error: {0}", ex.Message),
"Error inesperado");
}
}
private void TraerTodos()
{
List<EProducto> productos = _productoBol.Todos();
if (productos.Count > 0)
{
dgvDatos.AutoGenerateColumns = false;
dgvDatos.DataSource = productos;
dgvDatos.Columns["columnId"].DataPropertyName = "Id";
dgvDatos.Columns["columnDescripcion"].DataPropertyName =
"Descripcion";
dgvDatos.Columns["columnMarca"].DataPropertyName =
"Marca";
dgvDatos.Columns["columnPrecio"].DataPropertyName =
"Precio";
}
else
MessageBox.Show("No existen producto Registrado");
}
private void TraerPorId(int id)
{
try
{
_producto = _productoBol.TraerPorId(id);
if (_producto != null)
{
txtId.Text = Convert.ToString(_producto.Id);
txtDescripcion.Text = _producto.Descripcion;
txtMarca.Text = _producto.Marca;
txtPrecio.Text = Convert.ToString(_producto.Precio);
}
else
MessageBox.Show("El Producto solicitado no existe");
}
catch (Exception ex)
{
MessageBox.Show(string.Format("Error: {0}", ex.Message),
"Error inesperado");
}
}
private void Eliminar(int id)
{
try
{
_productoBol.Eliminar(id);
MessageBox.Show("Producto eliminado satisfactoriamente");
TraerTodos();
}
catch (Exception ex)
{
MessageBox.Show(string.Format("Error: {0}", ex.Message),
"Error inesperado");
}
}
//
//
//Usamos nuestros metodos y funciones generales, observe como no
hemos repetido codigo en ningun lado
//haciendo con esto que nuestras tareas de actualizacion sean mas
sencillas para nosotros o para
//al asignado en realizarlas...
private void btnAgregar_Click(object sender, EventArgs e)
{
Guardar();
}
private void txtId_KeyDown(object sender, KeyEventArgs e)
{
Aqu termina nuestro articulo sobre Arquitectura 3 Capas, espero haya sido de su agrado y que la
explicacin haya sido lo bastante clara, en caso de que tenga alguna duda por favor deje su
pregunta en la seccin de comentarios o escrbame por medio del formulario de contacto.
Escribir este articulo me llevo mas de 4 horas, dejar un comentario de agradecimiento le tomara 5
minutos.
Saludos desde Monterrey, Nuevo Len Mxico!
Ejemplo C#
Entrando en contexto..
Imagine, que hoy desarrolla un sistema con 20 Formularios, la cual va a instalar en 50 Pcs que
utilizaran para la administracin de su empresa, su conocimiento sobre las ventajas de usar un
archivo de configuracin es nula, as que usted uso lo que muchos programadores llegamos a
utilizar en nuestro inicios, establecer la cadena de conexin en cada mtodo o funcin donde
necesitemos comunicarnos con la Bd, algo como esto:
C#:
using System.Data.SqlClient;
private void btnProbar_Click(object sender, EventArgs e)
{
using(SqlConnection cnx = new SqlConnection("Data Source=LUISESCOBARPC;Initial Catalog=Directorio;Integrated Security=True"))
{
cnx.Open();
MessageBox.Show(cnx.State.ToString());
}
}
Vb.Net:
En esta parte, el asiste nos pregunta el nombre que asignaremos a la cadena de conexin,
podemos dejar el nombre por default o poner el nombre que creamos conveniente, en esta ocasin
dejemos el que nos pone por default mas adelante lo modificaremos:
Despus de realizar todo lo anterior podr ver en el Explorador de soluciones dos nuevos
archivos, que son el archivo de configuracin y un DataSet:
<add
name="connectionString_CSharp.Properties.Settings.DirectorioConnectionStr
ing"
connectionString="Data Source=LUISESCOBAR-PC;Initial
Catalog=Directorio;Integrated Security=True"
providerName="System.Data.SqlClient" />
</connectionStrings>
</configuration>
Veamos que representa cada lnea:
Esta lnea representa el nombre de nuestra cadena de conexin, si recuerda en uno de los pasos
anteriores el asistente le preguntaba el nombre de la cadena de conexin, como dejamos el
nombre por default es este el que aparece como nombre de nuestra cadena:
<add name="connectionString_CSharp.Properties.Settings.DirectorioConnectionString"
Modifiquemos esta lnea con el fin de tener un nombre mas corto (con este nombre ser como
obtendremos el valor de nuestra Cadena):
<add name="cnxString"
La siguiente lnea representa el valor de nuestra cadena de conexin:
connectionString="Data Source=LUISESCOBAR-PC;Initial
Catalog=Directorio;Integrated Security=True"
y por ultimo tendremos el nombre del motor de Base de Datos que estaremos usando:
providerName="System.Data.SqlClient" />
Bien, ya vimos como usar el asistente para definir una cadena de conexinahora vayamos a ver
Insertar un nuevo elemento al proyecto del tipo App.Config
Haga Click derecho sobre el proyecto > Agregar > Nuevo Elemento:
Observe que tenemos un nuevo archivo en el Explorador de soluciones bralo dentro podr ver
una estructura de cdigo como la siguiente:
<?xml version="1.0" encoding="utf-8" ?>
<configuration>
</configuration>
Dentro de la etiqueta <configuration> usted tendr que agregar el nombre de la cadena de
conexin, el valor de la cadena de conexin y el nombre del motor de Base de datos que estar
utilizando, esto ultimo no siempre es necesario ya que depende mucho del motor que estemos
utilizando porque para Bases de datos como Access, SqlCeson necesarios para SqlServer no lo
es.
Al final usted deber de tener un archivo con la siguiente estructura de cdigo Xml:
<?xml version="1.0" encoding="utf-8" ?>
<configuration>
<connectionStrings>
<add name="cnxString"
connectionString="Data Source=LUISESCOBAR-PC;Initial
Catalog=Directorio;Integrated Security=True"
providerName="System.Data.SqlClient" />
</connectionStrings>
</configuration>
Utilizar el archivo de configuracin para obtener la cadena de conexin
Ahora veamos como utilizar la cadena de conexin que acabamos de crear por cualquiera de los
pasos anteriores.
Una vez echo esto, vayamos a la clase donde queramos abrir la conexin e importemos el espacio
de nombres System.Configuration, echo lo anterior estamos listos para utilizar nuestro App.Config.
para C#:
using
using
using
using
System;
System.Windows.Forms;
System.Data.SqlClient;
System.Configuration;
namespace connectionString_CSharp
{
public partial class Form1 : Form
{
public Form1()
{
InitializeComponent();
}
private void btnconectar_Click(object sender, EventArgs e)
{
TestConnection();
}
private void TestConnection()
{
using(SqlConnection cnx = new
SqlConnection(ConfigurationManager.ConnectionStrings["cnxString"].ToStrin
g()))
{
cnx.Open();
MessageBox.Show(cnx.State.ToString());
}
}
}
}
Para Vb.Net:
Imports System.Data.SqlClient
Imports System.Configuration
Public Class Form1
Private Sub btnProbar_Click(sender As System.Object, e As
System.EventArgs) Handles btnProbar.Click
TestConnection()
End Sub
Private Sub TestConnection()
Using cnx As New
SqlConnection(ConfigurationManager.ConnectionStrings("cnxString").ToStrin
g())
cnx.Open()
MessageBox.Show(cnx.State.ToString())
End Using
End Sub
End Class
Bien, cuando compile su proyecto, lo instale y se le presente la necesidad de modificar la cadena
de conexin, simplemente dirjase al directorio de instalacin ubique el archivo de configuracin
(una vez instalado su software la nomenclatura de su archivo
ser NombredelProyecto.Exe.Config), bralo con el notepad, modifique su cadena, guarde los
cambios y sin mas ni mas podr seguir trabajando
Saludos desde Monterrey, Nuevo Len Mxico!
Ejemplo C#
Ejemplo Vb.Net
Nota: El proyecto fue desarrollado en Vs2010 usando una Bd SqlServer 2008 Express y Framework 4.0 Client Profile