UINames.Net

Uinames.net

Gerador de nome aleatório para o .Net-Framework usando a API pública e gratuita do uinames.com. Esta biblioteca muito pequena e básica foi escrita no VB.NET, principalmente para estudar razões.

Uso

Aulas e enumes

O modelo consiste nas seguintes classes e enumes que definem seu modelo básico:

1. Nome (classe)

A representação básica do nome retirada do uinames.com.

1.1 membros

1.1.1 Nome: String

O primeiro nome de uma pessoa.

1.1.2 Sobrenome: String

O sobrenome de uma pessoa.

1.1.3 Gênero: String

O sexo de uma pessoa.

1.1.4 Região: String

O nome da região de que uma pessoa está vindo.

2. Gênero (enum)

O uinames.com não fornece outros sexos que feminino ou masculino. Outros sexos serão representados como "não especificados" nesta biblioteca. Isso não deve ser desrespeitoso para quem se identifica como qualquer outro gênero além da representação binária convencional.

2.1 valores

• Não especificado
• Fêmea
• Macho

Métodos

Esta pequena biblioteca expõe apenas dois métodos ao público:

1. GetName(gender: Gender (optional, default: Gender.NotSpecified), region (optional, default: null): System.Globalization.RegionInfo, minLength (optional, nullable, default: null): Integer, maxLength (optional, nullable, default: null): Integer): Name

Este método retorna um único nome da API.

Se um gênero for especificado, o nome será de uma pessoa do gênero especificado, caso contrário, será aleatório.

Se a região for especificada, o nome será de uma pessoa proveniente da região especificada, caso contrário, será aleatória.

Se o comprimento do minlevo for especificado, o nome da pessoa será pelo menos o tempo que o número fornecido, caso contrário, seu comprimento minumum será zero.

Se o máximo for especificado, o nome da pessoa será no máximo que o número fornecido, caso contrário, seu comprimento máximo será ilimitado.

2. GetNames(amount: Integer, gender: Gender (optional, default: Gender.NotSpecified), region (optional, default: null): System.Globalization.RegionInfo, minLength (optional, nullable, default: null): Integer, maxLength (optional, nullable, default: null): Integer): IEnumerable

Este método retorna um enumerável de um determinado comprimento de nomes da API.

O parâmetro de quantidade especifica o número de nomes a serem criados. Se a quantidade for menor que 2 ou superior a 500, uma exceção será lançada. Se o usuário quiser que um único nome seja gerado, o uso do método getName será recomendado. O limite superior é fornecido pela própria API.

Se um gênero for especificado, os nomes serão de pessoas do gênero fornecido, caso contrário, elas serão aleatórias.

Se a região for especificada, os nomes serão uma das pessoas provenientes da região especificada; caso contrário, elas serão aleatórias.

Se o comprimento do minlevo for especificado, os nomes das pessoas terão pelo menos o tempo que o número fornecido, caso contrário, o comprimento minumum será zero.

Se o máximo for especificado, os nomes das pessoas serão no máximo que o número fornecido, caso contrário, seu comprimento máximo será ilimitado.

Observações

A API limita as solicitações dos usuários a 7 solicitações por minuto. Uma única solicitação é limitada a 500 nomes, portanto a API permite solicitar 3.500 nomes aleatórios por minuto.