DocsBRValidatorFramework 1.0.0

DocsBRValidator

Primeiramente, obrigado pelo interesse em utilizar este pacote!

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

PACOTE PARA COMPATIBILIDADE COM VERSÕES ANTIGAS DO .NET

Para utilizar a versão atual do pacote, 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!