HighbornBD 1.0.3

HIGHBORN BANCO DE DADOS

Este nuget é um tipo de banco de dados com algumas funções que eu uso em meus programas.

Ele foi todo criado por mim em VB.net. Como eu entendo muito mais de Visual Basic do que C#,

F# ou ASP podem ter algumas falhas nos códigos mencionados abaixo, mas os em VB sempre

estarão corretos, entretanto, o que eu entender vou dar um caminho.

Classe Tabela(Atividades)

Para usa-lo siga as instruções:

Criando

O primeiro passo para o uso da biblioteca é criar uma variável do tipo "Tabela"

Visual Basic

    Public Tabela As New Tabela

C#

    public new Tabela Tabela;

Posteriormente você pode definir um valor padrão pra ela da seguinte forma:

Vamos usar de exemplo essa tabela:

Lembrando que as linhas podem ter tags(que por enquanto não fazem nada, mas vão fazer no futuro)

Visual Basic

    Tabela.Padrão = "Coluna 1||||Coluna2>>>>Item 1||||Sub 1>>>>Item 2||||Sub 2<<<<Tag linha 1||||Tag linha 2"

C#

    Tabela.Padrão = "Coluna 1||||Coluna2>>>>Item 1||||Sub 1>>>>Item 2||||Sub 2<<<<Tag linha 1||||Tag linha 2";

Com o padrão definido ou não você pode carregar o arquivo da tabela, caso o arquivo não exista, ele cria automaticamente, porém ele exige uma pasta chamada "HBD" no diretório do executável. Caso possua um padrão, ele irá criar a tabela com o padrão, caso contrário ele criará uma tabela vazia.

Visual Basic

    Tabela.CarregarTabela("Tabela")

C#

    Tabela.CarregarTabela("Tabela");

Desta forma a tabela vai ser carregada do arquivo salvo ou criada caso não exista com o padrão atual.

O caminho desse arquivo é o caminho do executável/HBD/a string que você colocar no único parâmetro.HBD

Caso você queira aplicá-la em uma ListView, com o nome, por exemplo, de ListView1, pode usar o seguinte comando:

Visual Basic

    ListView1 = Tabela.ConverteLV(ListView1)

C#

    ListView1 = Tabela.ConverteLV(ListView1);

Precisará executá-lo todas as vezes que atualizar a tabela também.

Colunas

Você pode criar colunas da seguinte forma:

Visual Basic

    Tabela.NovaColuna(NomedaColuna)

C#

    Tabela.NovaColuna(NomedaColuna);

Pode criar colunas sem nomes também, mas pode ser confuso pro user.

Removendo colunas:

Visual Basic

    Tabela.RemoveColuna(Endereço)

C#

    Tabela.RemoveColuna(Endereço);

Endereço também é opcional, caso não o coloque ele vai remover a coluna mais a direita da tabela.

Para achar o endereço de uma coluna existem duas formas:

1. Contar manualmente da esquerda pra direita, sendo que a primeira coluna é contada como 0.
2. Utilizar o comando EncontreColuna, da seguinte forma:

Visual Basic

    Tabela.EncontreColuna(NomedaColuna, True)

C#

    Tabela.EncontreColuna(NomedaColuna, True);

Sendo que o primeiro parâmetro é uma string com o nome dado a coluna na hora de cria-la e o segundo é se contém no nome, por exemplo, caso criássemos uma tabela como a padrão, e quiséssemos encontrar a primeira coluna que contém a palavra "Coluna" nela, usaríamos da seguinte forma:

Visual Basic

    Tabela.EncontreColuna("Coluna", true)

Retorna: 0

Caso colocássemos false no segundo parâmetro ele procuraria uma coluna com o nome exato "Coluna", e como não existe na tabela ele retornaria o valor -1, dessa forma:

Visual Basic

    Tabela.EncontreColuna("Coluna", false)

Retorna: -1

-1 significa um erro ou não encontrado.

Itens

Escrevendo itens

Para escrever um item utilize o seguinte comando:

Visual Basic

    Tabela.EscreveProximo(TextodoItem, 0)

O primeiro parâmetro é o texto que será exibido no item, enquanto o segundo, que é opcional, é a linha que ele será escrito, começando do 0. A linha é opcional já que se não colocar ele irá adicionar a ultima linha.

Também pode colocar mais de um item de uma vez das seguintes formas:

1. Utilizando strings:

Visual Basic

    Tabela.EscreveProximo(Valor1, Valor2, Valor3 ..., 0)

Cada um dos valores escritos é um item adicionado e o ultimo parâmetro é a linha, que é opcional. Isso é valido até 20 itens de uma vez, caso precise de mais use a segunda opção.

2. Utilizando uma lista de strings:

Visual Basic:

    Tabela.EscreveProximo(ListadeStrings, 0)

Cada um dos itens da lista vão ser escritos na mesma linha, o ultimo parâmetro é a linha, que é opcional.

Ao escrever itens você pode extrapolar a quantidade de colunas, o item estará em uma coluna que ainda não existe, mas ao cria-la ele será exibido.

Você também pode escrever em uma coluna

Caso queira usar o nome da coluna ao invés de escrever até chegar nela.

Visual Basic

    Tabela.EscrevenaColuna(NomedaColuna, TextodoItem, true)

O Ultimo parâmetro é se contém na coluna ou não, funciona exatamente da mesma forma que no comando "EncontreColuna", já mencionado em cima. Caso o item já exista ele irá editar. O comando sempre será executado na ultima linha.

Editando item criado

Visual Basic

    Tabela.EscreveItem(NovoTexto, EndereçodaLinha, EndereçodaColuna)

Coletando valor de um item

Visual Basic

    Dim TextodoItem As String = Tabela.Item(EndereçodaLinha, EndereçodaColuna)

Removendo itens

Você pode tanto remover um item especifico quanto remover um item com um texto especifico da ultima linha.

Removendo item com texto especifico da ultima linha

Visual Basic

    Tabela.RemoveItem(TextoaSerRemovido)

Removendo item por coordenada

Visual Basic

    Tabela.RemoveItem(EndereçodaLinha, EndereçodaColuna)

Removendo por endereço

Visual Basic

    Tabela.RemoveItem(EndereçodaColuna)

Pesquisas

Você também pode pesquisar dentre os itens criados pra conseguir as coordenadas deles.

Pesquisando um item

Visual Basic

    Dim coordenada = Tabela.Encontre(TextodoItem, False)

Este retornará um objeto de coordenada contendo a linha e a coluna do item, o ultimo parâmetro é o contém e funciona exatamente da mesma forma que pesquisando colunas. Caso haja mais de um item, ele informará a coordenada do primeiro que achar da esquerda pra direita e de cima pra baixo.

Pesquisando vários itens

Visual Basic

    Dim coordenadas = Tabela.EncontreAlguns(TextodoItem, False)

Este retornará uma lista de objetos de coordenada, cada um deles possui a linha e a coluna dos itens encontrados. O ultimo parâmetro é o contém e funciona exatamente da mesma forma que pesquisando colunas.

Linhas

Você pode adicionar uma linha da seguinte forma:

Visual Basic

    Tabela.ProximaLinha()

Ele irá adicionar mais uma linha no final da tabela.

Removendo linhas:

Visual Basic

    Tabela.RemoveLinha(EndereçodaLinha)

O endereço da linha é completamente opcional, já que se não colocado a ultima será removida.

Os comandos não acabaram, mas não cabem aqui.

Para instruções de uso acesse: https://highbornbd.000webhostapp.com/