UINames.Net

Uinames.net

Случайный генератор имен для .net-Framework с использованием публичного и бесплатного API с uinames.com. Эта очень маленькая и базовая библиотека была написана в VB.NET, в основном по изучению причин.

Использование

Классы и перечисления

Модель состоит из следующих классов и перечисления, определяющих ее базовую модель:

1. Имя (класс)

Основное представление имени, взятое с uinames.com.

1.1 Члены

1.1.1 Имя: строка

Имя человека.

1.1.2 Фамилия: строка

Фамилия человека.

1.1.3 Пол: строка

Пол человека.

1.1.4 Региона: строка

Название региона, от которого приходит человек.

2. Пол (перечисление)

Uinames.com не предоставляет другие полов, чем женщина или мужчина. Другие полов будут представлены как «не указанные» в этой библиотеке. Это не должно быть неуважительным по отношению к любому, кто идентифицирует себя как любой другой пол, чем обычное бинарное представление.

2.1 Значения

• Не указан
• Женский
• Мужской

Методы

Эта небольшая библиотека раскрывает только два метода для общественности:

1. GetName (Пол: пол (необязательно, по умолчанию: gender.notspecified), область (необязательно, по умолчанию: NULL): System.Globalization.RegionInfo, MinLength (необязательно, нулевая, дефолт: NULL): Integer, MaxLength (необязательно, Nullable, Default: Null): integer): имя.

Этот метод возвращает одно имя из API.

Если указан пол, имя будет одним из человек данного пола, в противном случае оно будет случайным.

Если регион указан, имя будет одним из человек, поступающих из данного региона, в противном случае оно будет случайным.

Если указана в Minlength, имя человека будет, по крайней мере, до тех пор, пока данное число, в противном случае его длина рушина будет равна нулю.

Если указана максимальная длина, имя человека будет не больше всего, пока данное число, в противном случае его максимальная длина будет не ограничена.

2. GetNames (сумма: целое число, пол: пол (необязательно, по умолчанию: гендер.

Этот метод возвращает перечисление из заданной длины имен из API.

Параметр суммы указывает количество имен, которые будут созданы. Если сумма меньше 2 или более 500, будет брошено исключение. Если пользователь хочет сгенерировать одно имя, рекомендуется использование метода GetName. Верхняя граница обеспечивается самим API.

Если указан пол, имена будут лиц из данного пола, в противном случае они будут случайными.

Если регион указан, имена будут одним из лиц, поступающих из данного региона, в противном случае они будут случайными.

Если указана в Minlength, имена лиц будут по крайней мере до тех пор, пока данное число, в противном случае их длина крошки будет равна нулю.

Если указана максимальная длина, имена лиц будут не больше всего, пока данное число, в противном случае их максимальная длина будет не ограничена.

Замечания

API ограничивает запросы пользователей 7 запросами в минуту. Один запрос ограничен 500 именами, поэтому API позволяет запрашивать 3500 случайных имен в минуту.