DocsBRValidatorFramework 1.1.0

DocsBRValidator

Primeiramente, obrigado pelo interesse em utilizar este pacote!

O DocsBRValidatorFramework foi criado a partir do projeto principal DocsBRValidator para fins de compatibilidade com versões do .NET Framework.

Para a versão atual do pacote, utilizar o DocsBRValidator

Caso queira consultar uma documentação mais completa, basta clicar aqui!.

Mas então, como usar o DocsBRValidator?

Após instalar o pacote em seu projeto, a utilização dele é bastante simples, vamos lá.

Validando um CPF

Para validar um número de CPF, por exemplo, basta importar o DocumentValidator na classe em que vai utilizar:

using DocumentValidator;

Após isso, utilizaremos o CpfValidation.Validate() informando o CPF a ser validado, como no singelo exemplo abaixo:

using System;
using DocumentValidator;

namespace ValidatorTest
{
    class Program
    {
        static void Main(string[] args)
        {
            if (CpfValidation.Validate("012.123.123-00"))
                Console.WriteLine("CPF Válido!");
            else
                Console.WriteLine("CPF Inválido!");
        }
    }
}

E em quais formatos posso enviar o CPF?

O CPF, assim como todos os demais documentos, podem ser enviados com ou sem máscara.

Não importa se o documento informado, como por exemplo o CPF, está no formato 012.123.123-00, 01212312300, 01.2123-12300, etc... a validação vai funcionar corretamente.

E para validar outros documentos?

A validação dos demais tipos de documentos suportados ocorre semelhante a do CPF.

Para validar um Titulo de Eleitor, por exemplo, utilizaremos TituloEleitorValidation.Validate(), passando o numero do título, com ou sem máscara como parâmetro. Ex: TituloEleitorValidation.Validate("038361610124").

IMPORTANTE! Existe apenas uma diferença na validação de Inscrição Estadual

Devido a cada estado ter autonomia para a criação de regras de validação, se faz necessário o envio da UF juntamente com o número da inscrição.

Para validar uma Inscrição Estadual, por exemplo, utilizaremos InscricaoEstadualValidation.Validate(), passando o numero da inscrição, com ou sem máscara, e o código da UF como parâmetros. Ex: InscricaoEstadualValidation.Validate("715.626.867.315", "SP").

(*)Para inscrições de produtor rural no estado de SP, é necessário adicionar ao início da inscrição, a letra 'R', como por exemplo: InscricaoEstadualValidation.Validate("R71562686731", "SP").

Retornos esperados

No momento, não existe possibilidade de retorno com mensagem de erro personalizável (mas terá!).

O retorno destas validações é do tipo boolean, retornando true quando o documento estiver correto e false, caso contrário.

Validações já inclusas

Até o momento, o DocsBrValidator conta com as seguintes validações:

(**) Para a validação de Inscrição estadual, devem ser enviados dois parâmetros do tipo string, um com a inscrição estadual e outro com o código da UF ("SP", "BA", "SC", etc...)

Todas as demais validações acima recebem uma string como parâmetro, contendo o documento com máscara ou não.

Espero que disfrute deste pacote e lembre-se: Todo o feedback construtivo é válido!

Obrigado!