You are on page 1of 4

Estándares para la creación de Accesos a Datos de las Entidades en Visual Basic .Net.

1) Las entidades estarán complementadas por una Clase Publica para realizar las consultas de los datos y los procesos de almacenamiento, actualización y eliminación. Dicha clase tendrá el nombre de la entidad a la que representa, precedida por las letras “AD” (Ejemplo: nombre la entidad ETbl_Contribuyente, nombre del acceso a datos ADETbl_Contribuyente) Código de ejemplo: Public Class ADETbl_Cont_Juridico End Class 2) La clase de acceso a datos contendrá las siguiente variables: a) Una nueva instancia de la clase Conexión, en donde nombre será el mismo nombre de la clases, precedida por la letra “i” Código de ejemplo: Dim iConexion As New Conexión b) Una variable tipo SqlDataReader, en donde nombre será “lector”. Código de ejemplo: Dim lector As Common.DbDataReader c) Una nueva instancia de la clase de la entidad, en donde nombre será el mismo nombre de la clase, precedida por la letra “i”. Código de ejemplo: Dim iETbl_Contribuyente As New ETbl_Contribuyente d) Una nueva instancia de listado del tipo de la entidad utilizando el tipo BindingList, en donde nombre será “lista”. Código de ejemplo: Dim lista As New BindingList(OF ETbl_Contribuyente) e) Una variable tipo String para crear las condiciones de los filtros, en donde nombre será “condicion”. Código de ejemplo: Dim condicion As String Variables opciones: f) Una nueva instancia de los accesos a datos dependiendo del número de relaciones que cuente la entidad, en donde nombre será el mismo nombre de las clases de acceso a datos, precedida por la letra “i”. Código de ejemplo: Dim iADETbl_Cont_Natural As New ADETbl_Cont_Natural) 3) La clase contendrá las siguientes funciones: a) Lisado: esta función se utilizara para llenar la variable “lista”, la cual recibirá parámetros opcionales que servirán para crear condiciones que formaran parte de la cláusula Where, las cuales deben devolver varios registros, los parámetros opcionales deben llevar “Nothing” como valor por defecto. El valor devuelto por la función será tipo BindingList del mismo tipo de la entidad retornada con la variable “lista”.

cod_contribuyente) . _ Optional ByVal UnicoActualizar As Boolean = False) _ As ETbl_Contribuyente iETbl_Contribuyente = New ETbl_Contribuyente Select Case True Case UnicoInsertar condicion = String.Format("tip_contribuyente = '{0}' AND cod_cont_migrado = '{1}' " & _ "cod_contribuyente != '{2}'". cod_cont_migrado) Case UnicoActualizar condicion = String. cod_cont_migrado.ToInt32(lector("cod_contribuyente")).iETbl_Cont_Juridico = iADETbl_Cont_Juridico. _ Convert.Código de ejemplo: Public Function Listado _ (Optional ByVal tip_contribuyente As String = Nothing) _ As BindingList(Of ETbl_Contribuyente) Select Case True Case Not tip_contribuyente = Nothing condicion = String. los parámetros opcionales deben llevar “Nothing” como valor por defecto. ambas servirá para verificar si existe el registro.Buscar(cod_contribuyente:=.Close() Catch ex As Exception End Try Return lista End Function b) Buscar: esta función se utilizara para devolver un ítem de la entidad. la cual recibirá parámetros opcionales que servirán para crear condiciones que formaran parte de la cláusula Where. strCampos:="*". en donde la primera lo realizará al momento de ingresar un nuevo registro existe.Buscar(cod_contribuyente:=.Format("tip_contribuyente = '{0}'". y la segunda al momento de actualizar. La función contendrá dos parámetros opcionales “ UnicoInsertar” y “UnicoActualizar” ubicados de último. _ strWhere:=condicion) While lector. al no encontrar un registro la función deberá devolver “Nothing”.cod_contribuyente). _ tip_contribuyente.Read iETbl_Contribuyente = New _ ETbl_Contribuyente(Convert.Format("cod_contribuyente = '{0}'".ToString(lector("tip_contribuyente")). cod_contribuyente) Case Not cod_contribuyente = Nothing condicion = String. las cuales deben devolver un único registro.Format("tip_contribuyente = '{0}' AND cod_cont_migrado = '{1}'". sin embargo. _ .Add(iETbl_Contribuyente) End While Try lector. _ Convert. _ Optional ByVal tip_contribuyente As String = Nothing.ToString(lector("cod_cont_migrado"))) _ With { .Consultar(strTabla:="dbo. _ tip_contribuyente.tbl_contribuyente". Código de ejemplo: Public Function Buscar(Optional ByVal cod_contribuyente As Integer = Nothing.cod_contribuyente) } lista. El valor devuelto por la función será mismo tipo de la entidad. _ Convert. tip_contribuyente) Case Else condicion = "" End Select lector = iConexion.ToBoolean(lector("con_est_deuda")). _ Optional ByVal UnicoInsertar As Boolean = False.iETbl_Cont_Natural = iADETbl_Cont_Natural. _ Optional ByVal cod_cont_migrado As String = Nothing.

Código de ejemplo: Public Function Insertar(ByVal item As ETbl_Contribuyente) As Integer Return iConexion.Close() Catch ex As Exception End Try Return iETbl_Contribuyente End Function c) Insertar: esta función se utilizará para almacenar un registro a la tabla.con_est_deuda & "'.Insertar(strTabla:="dbo." & _ "'" & item.ToBoolean(lector("con_est_deuda")).Buscar(cod_contribuyente:=. _ strWhere:=condicion) If lector. Código de ejemplo: . _ strValores:="'" & item.ToInt32(lector("cod_contribuyente")). _ Convert.tbl_contribuyente". _ strSet:="id_producto='" & item.Actualizar(strTabla:="dbo. "cod_presupuestario='" & item. recibirá un parámetro llamado “ítem” del mismo tipo de la entidad . _ .iETbl_Cont_Juridico = iADETbl_Cont_Juridico. recibirá un parámetro llamado “ítem” del mismo tipo de la entidad .cod_cont_migrado & "'".Buscar(cod_contribuyente:=. _ & "'") e) Eliminar: esta función se utilizará para borrar un registro a la tabla.tbl_contribuyente".tbl_contribuyente". cod_cont_migrado") End Function d) Actualizar: esta función se utilizará para editar un registro a la tabla. Código de ejemplo: Public Function Actualizar(ByVal item As ETbl_Contribuyente) As Integer Return iConexion. _ Convert." & _ "'" & item. recibirá un parámetro llamado “ítem” del mismo tipo de la entidad .tip_contribuyente & "'. strCampos:="*". _ strCampos:="tip_contribuyente. con_est_deuda.Case Else Return Nothing End Select lector = iConexion.cod_contribuyente) } Else Return Nothing End If Try lector.cod_contribuyente End Function & _ " & _ "'".cod_contribuyente).ToString(lector("cod_cont_migrado"))) _ With { .tip_contribuyente & "'. " "id_tip_uni_medida='" & item.con_est_deuda & "'. _ Convert.iETbl_Cont_Natural = iADETbl_Cont_Natural.ToString(lector("tip_contribuyente")).Consultar(strTabla:="dbo.cod_cont_migrado & strWhere:="cod_contribuyente='" & item.Read Then iETbl_Contribuyente = New _ ETbl_Contribuyente(Convert.

tbl_contribuyente". _ strWhere:="cod_contribuyente ='" & item.Public Function Eliminar(ByVal item As ETbl_Contribuyente) As Integer Return iConexion.Eliminar(strTabla:="dbo.cod_contribuyente & "'") End Function .