Class StdBSRegistos

Serviços de manipulação de registos de uma tabela.

Inheritance

System.Object

StdBSRegistos

Implements

IStdBSRegistos

Inherited Members

System.Object.ToString()

System.Object.Equals(System.Object)

System.Object.Equals(System.Object, System.Object)

System.Object.ReferenceEquals(System.Object, System.Object)

System.Object.GetHashCode()

System.Object.GetType()

System.Object.MemberwiseClone()

Namespace: StdPlatBS100

Assembly: StdPlatBS100.dll

Syntax

[ComVisible(true)]
[Guid("A7DFFB25-FFC0-48C7-82B6-1131FD8F2979")]
[ClassInterface(ClassInterfaceType.None)]
public class StdBSRegistos : IStdBSRegistos

Methods

Actualiza(String, StdBERegistoUtil)

Actualização de um registo na base de dados.

Declaration

public void Actualiza(string Tabela, StdBERegistoUtil Registo)

Parameters

Type	Name	Description
System.String	Tabela	Nome da tabela.
StdBERegistoUtil	Registo	Definição do registo.

ActualizaValorAtributo(String, StdBECamposChave, String, Object)

Actualização do valor de um atríbuto de uma tabela na base de dados.

Declaration

public void ActualizaValorAtributo(string Tabela, StdBECamposChave Chave, string Atributo, object Valor)

Parameters

Type	Name	Description
System.String	Tabela	Nome da tabela.
StdBECamposChave	Chave	Chave do registo.
System.String	Atributo	Nome do atríbuto.
System.Object	Valor	Novo valor.

ActualizaValorAtributos(String, StdBECamposChave, StdBECampos)

Actualização do valor de vários atríbutos de uma tabela na base de dados.

Declaration

public void ActualizaValorAtributos(string Tabela, StdBECamposChave Chave, StdBECampos Atributos)

Parameters

Type	Name	Description
System.String	Tabela	Nome da tabela.
StdBECamposChave	Chave	Chave do registo.
StdBECampos	Atributos	Colecção de atríbutos a actualizar (nome e novo valor).

Consulta(String)

Execução de uma query de consulta (SELECT) a partir da base de dados.

Declaration

public StdBELista Consulta(string Query)

Parameters

Type	Name	Description
System.String	Query

Returns

Type	Description
StdBELista

ConsultaAvancada(String, StdBETipos.EnumLocalizacaoCursor, StdBETipos.EnumTipoCursor, StdBETipos.EnumLockCursor)

Execução de uma query de consulta (SELECT) a partir da base de dados, com definição de opções avançadas do cursor.

Declaration

public StdBELista ConsultaAvancada(string Query, StdBETipos.EnumLocalizacaoCursor LocalizacaoCursor = (StdBETipos.EnumLocalizacaoCursor)-1, StdBETipos.EnumTipoCursor TipoCursor = (StdBETipos.EnumTipoCursor)-1, StdBETipos.EnumLockCursor LockCursor = (StdBETipos.EnumLockCursor)-1)

Parameters

Type	Name	Description
System.String	Query
StdBETipos.EnumLocalizacaoCursor	LocalizacaoCursor
StdBETipos.EnumTipoCursor	TipoCursor
StdBETipos.EnumLockCursor	LockCursor

Returns

Type	Description
StdBELista

ConsultaDataSet(String)

Execução de uma query de consulta (SELECT), ou um conjunto de queries de consulta.

Declaration

public DataSet ConsultaDataSet(string Query)

Parameters

Type	Name	Description
System.String	Query	Instrução SELECT a executar.

Returns

Type	Description
System.Data.DataSet	Um data set, com uma tabela para cada consulta.

Remarks

Este método não suporta instruções UPDATE ou DELETE.

ConsultaDataTable(String)

Execução de uma query de consulta (SELECT).

Declaration

public DataTable ConsultaDataTable(string Query)

Parameters

Type	Name	Description
System.String	Query	Instrução SELECT a executar.

Returns

Type	Description
System.Data.DataTable

Remarks

Este método não suporta instruções UPDATE ou DELETE.

ConsultaDataTable(String, IReadOnlyList<SqlParameter>)

Execução de uma query de consulta (SELECT), com parâmetros SQL.

Declaration

public DataTable ConsultaDataTable(string Query, IReadOnlyList<SqlParameter> parameters)

Parameters

Type	Name	Description
System.String	Query
System.Collections.Generic.IReadOnlyList<System.Data.SqlClient.SqlParameter>	parameters

Returns

Type	Description
System.Data.DataTable

ConsultaReader(String)

Execução de uma query de consulta (SELECT) a partir da base de dados.

Declaration

public StdBELista ConsultaReader(string strQuery)

Parameters

Type	Name	Description
System.String	strQuery

Returns

Type	Description
StdBELista

ConsultaSP(String, StdBECampos)

Este método devolve uma lista de registos (StdBELista) resultado da execução de uma stored procedure na base de dados.

Declaration

public StdBELista ConsultaSP(string strNomeSP, StdBECampos objParametros)

Parameters

Type	Name	Description
System.String	strNomeSP	Nome da stored procedure a executar.
StdBECampos	objParametros	Parâmetros da stored procedure.

Returns

Type	Description
StdBELista

ConsultaSPDataTable(String, StdBECampos)

Este método devolve uma lista de registos (DataTable) resultado da execução de uma stored procedure na base de dados.

Declaration

public DataTable ConsultaSPDataTable(string strNomeSP, StdBECampos objParametros)

Parameters

Type	Name	Description
System.String	strNomeSP	Nome da stored procedure a executar.
StdBECampos	objParametros	Parâmetros da stored procedure.

Returns

Type	Description
System.Data.DataTable

DaTipoCampo(Int32)

Devolve o tipo de um campo da base de dados (tradução do tipo ADO para o tipo de dados PRIMAVERA).

Declaration

public StdBETipos.EnumTipoCampo DaTipoCampo(int TipoAdo)

Parameters

Type	Name	Description
System.Int32	TipoAdo	Tipo de dados como definido pelo ADO.

Returns

Type	Description
StdBETipos.EnumTipoCampo

DaTipoCampo(String)

Devolve o tipo de um campo da base de dados (tradução do tipo ADO para o tipo de dados PRIMAVERA).

Declaration

public StdBETipos.EnumTipoCampo DaTipoCampo(string strTipoADO)

Parameters

Type	Name	Description
System.String	strTipoADO	Tipo de dados como definido pelo ADO.

Returns

Type	Description
StdBETipos.EnumTipoCampo

DaValorAtributo(String, StdBECamposChave, String, Boolean)

Devolve o valor de um atríbuto de um registo de uma tabela sem bloqueio.

Declaration

public object DaValorAtributo(string Tabela, StdBECamposChave Chave, string Atributo, bool blnWithNoLock = true)

Parameters

Type	Name	Description
System.String	Tabela	Nome da tabela.
StdBECamposChave	Chave	Chave do registo.
System.String	Atributo	Nome do atríbuto.
System.Boolean	blnWithNoLock

Returns

Type	Description
System.Object

DaValorAtributos(String, StdBECamposChave, String[], String[], Boolean)

Devolve uma colecção com o valor de vários atríbutos de um registo de uma tabela sem bloqueio.

Declaration

public StdBECampos DaValorAtributos(string Tabela, StdBECamposChave Chave, string[] AtributosLogicos, string[] AtributosFisicos, bool blnWithNoLock = true)

Parameters

Type	Name	Description
System.String	Tabela	Nome da tabela.
StdBECamposChave	Chave	Chave do registo.
System.String[]	AtributosLogicos	Nomes lógicos (como definidos no BE) dos atríbutos a obter.
System.String[]	AtributosFisicos	Nomes físicos (como definidos na base de dados) dos atríbutos a obter.
System.Boolean	blnWithNoLock

Returns

Type	Description
StdBECampos

DaValorUnico(String)

Devolve o primeiro valor do primeiro registo.

Declaration

public object DaValorUnico(string strQuery)

Parameters

Type	Name	Description
System.String	strQuery	Query a executar.

Returns

Type	Description
System.Object

Edita(String, StdBECamposChave)

Edição de um registo de uma tabela.

Declaration

public StdBERegistoUtil Edita(string Tabela, StdBECamposChave Chave)

Parameters

Type	Name	Description
System.String	Tabela	Nome da tabela.
StdBECamposChave	Chave	Chave do registo.

Returns

Type	Description
StdBERegistoUtil

ExecutaComando(DbCommand)

Executes the comand.

Declaration

public int ExecutaComando(DbCommand objCommand)

Parameters

Type	Name	Description
System.Data.Common.DbCommand	objCommand	The object command.

Returns

Type	Description
System.Int32

ExecutaComando(String)

Executes the comand.

Declaration

public int ExecutaComando(string strQuery)

Parameters

Type	Name	Description
System.String	strQuery	The string query.

Returns

Type	Description
System.Int32

ExecutaComando(String, IReadOnlyList<SqlParameter>)

Executes the comand.

Declaration

public int ExecutaComando(string strQuery, IReadOnlyList<SqlParameter> parameters)

Parameters

Type	Name	Description
System.String	strQuery	The string query.
System.Collections.Generic.IReadOnlyList<System.Data.SqlClient.SqlParameter>	parameters	The query parameters

Returns

Type	Description
System.Int32

Existe(String, StdBECamposChave)

Verifica se um determinado registo existe numa tabela.

Declaration

public bool Existe(string Tabela, StdBECamposChave Chave)

Parameters

Type	Name	Description
System.String	Tabela	Nome da tabela.
StdBECamposChave	Chave	Chave do registo.

Returns

Type	Description
System.Boolean

ExisteWhere(String, String)

Check if where clause exists.

Declaration

public bool ExisteWhere(string strTabela, string strClausulaWhere)

Parameters

Type	Name	Description
System.String	strTabela	The string tabela.
System.String	strClausulaWhere	The string clausula where.

Returns

Type	Description
System.Boolean

Finalize()

Declaration

protected void Finalize()

InsereRegistosBulk(String, DataTable)

Permite a inserção em bloco de registos numa tabela

Declaration

public void InsereRegistosBulk(string strTabela, DataTable Registos)

Parameters

Type	Name	Description
System.String	strTabela	Tabela destino dos registos.
System.Data.DataTable	Registos	DataTable com os reegistos a inserir.

NumeroRegistos(String)

Devolve o número de registos existentes numa tabela.

Declaration

public int NumeroRegistos(string Tabela)

Parameters

Type	Name	Description
System.String	Tabela	Nome da tabela.

Returns

Type	Description
System.Int32

RegistoEmUso(String, String, String, String)

Verifica se um registo está a ser utilizado por outro utilizador.

Declaration

public bool RegistoEmUso(string strTabela, string strCampo, string strValorCampo, string strQuery)

Parameters

Type	Name	Description
System.String	strTabela	Nome da tabela.
System.String	strCampo	Campo a verificar.
System.String	strValorCampo	Valor do campo.
System.String	strQuery	Query.

Returns

Type	Description
System.Boolean	True se estiverem em uso.

RegistoEmUsoEx(String, StdBECampos)

Verifica se um registo está a ser utilizado por outro utilizador.

Declaration

public bool RegistoEmUsoEx(string strTabela, StdBECampos objCampos)

Parameters

Type	Name	Description
System.String	strTabela	Nome da tabela.
StdBECampos	objCampos	Definiçaõ dos campos a verificar.

Returns

Type	Description
System.Boolean	True se estiverem em uso.

Remove(String, StdBECamposChave)

Remove um registo de uma tabela.

Declaration

public void Remove(string Tabela, StdBECamposChave Chave)

Parameters

Type	Name	Description
System.String	Tabela	Nome da tabela.
StdBECamposChave	Chave	Chave do registo.

VerificaIntegridadeRef(String, String, Object, Int32)

Verifica a integridade de uma query.

Declaration

public bool VerificaIntegridadeRef(string strTabela, string strCampo, object vntValorCampo, int intTpCampo)

Parameters

Type	Name	Description
System.String	strTabela	Nome da tabela.
System.String	strCampo	Nome do campo.
System.Object	vntValorCampo	Valor do campo.
System.Int32	intTpCampo	Tipo do campo.

Returns

Type	Description
System.Boolean

VerificaIntegridadeRef(String, String, Object, Int32, ref String)

Verifica a integridade de uma query.

Declaration

public bool VerificaIntegridadeRef(string strTabela, string strCampo, object vntValorCampo, int intTpCampo, ref string strFiltro)

Parameters

Type	Name	Description
System.String	strTabela	Nome da tabela.
System.String	strCampo	Nome do campo.
System.Object	vntValorCampo	Valor do campo.
System.Int32	intTpCampo	Tipo do campo.
System.String	strFiltro	Filtro a aplicar à query.

Returns

Type	Description
System.Boolean

Implements

IStdBSRegistos