Практическое руководство. Создание пользовательских генераторов данных

Пользовательские генераторы данных — это компоненты, которые функция генерации данных может использовать для создания данных в планах создания данных. Хотя функция генерации данных предоставляет несколько предустановленных генераторов, возможно, нужно будет создать пользовательские генераторы, удовлетворяющие особым нуждам.

В этом разделе описывается создание пользовательского генератора данных с помощью обычной расширяемости. В большинстве случаев рекомендуется использовать метод обычной расширяемости. Можно также использовать другие методы создания пользовательских генераторов данных, включая декларативную расширяемость, агрегатную расширяемость и базовую расширяемость. Дополнительные сведения см. в разделе Общие сведения о расширении генераторов данных.

Создание пользовательского генератора данных

1. Создайте проект библиотеки классов.

2. В обозревателе решений щелкните правой кнопкой мыши проект и выберите команду Добавить ссылку.

   Откроется диалоговое окно Добавление ссылки.

3. Перейдите на вкладку .NET. В списке Имя компонента щелкните Microsoft.Data.Schema, а затем нажмите кнопку ОК.

4. (Необязательно, только Visual Basic.) В обозревателя решений нажмите кнопку Показать все файлы и разверните узел Ссылки, чтобы проверить новую ссылку.

5. В верхней части окна Код перед объявлением класса добавьте следующую строку кода:

   Microsoft.Data.Schema.Tools.DataGenerator
   

   Microsoft.Data.Schema.Tools.DataGenerator;
   

6. Переименуйте класс Class1, присвоив ему желаемое имя.

   Предупреждение

   По умолчанию присвоенное классу имя отобразится в списке в столбце Генератор в окне Сведения о столбцах.Следует задать имя, не конфликтующее с именем стандартного генератора или другого пользовательского генератора.Дополнительные сведения см. в разделе Вопросы, связанные с применением пользовательских генераторов данных.

   Public Class YourGeneratorName
   
   End Class
   

   public class YourGeneratorName
   {
   }
   

7. Укажите, что класс наследует Generator, как показано в следующем примере:

   Public Class YourGeneratorName
       Inherits Generator
   
   End Class
   

   public class YourGeneratorName: Generator
   {
   }
   

8. (Необязательно.) Добавьте GeneratorStylesAttribute в объявление класса.

   Важно!

   Если нужно, чтобы пользовательский генератор был используемым по умолчанию для типа столбца, он должен создавать уникальные значения и необходимо добавить к классу атрибут GeneratorStylesAttribute.Дополнительные сведения см. в разделе Практическое руководство. Изменение генератора по умолчанию для типа столбца.

   <GeneratorStyles(DesignerStyles:=GeneratorDesignerStyles.CanProduceUniqueValues)> _
   Public Class TestGenerator
       Inherits Generator
   
   End Class
   

   [GeneratorStyles(DesignerStyles = GeneratorDesignerStyles.CanProduceUniqueValues)]
   public class TestGenerator:Generator
   {
   }
   

9. (Необязательно) Добавьте GeneratorAttribute в объявление класса.

   Предупреждение

   Этот атрибут следует добавлять в объявление класса, только чтобы задать тип настраиваемого конструктора для пользовательского генератора данных.Если задавать пользовательский тип конструктора не требуется, можно опустить этот атрибут. Тогда автоматически будет использоваться конструктор по умолчанию.

   <Generator(GetType(CustomDesignerType))> _
   Public Class TestGenerator
       Inherits Generator
   
   End Class
   

   [Generator(typeof(CustomDesignerType))]
   public class TestGenerator:Generator
   {
   }
   

10. Добавьте минимум одно выходное свойство. Дополнительные сведения см. в разделе Практическое руководство. Добавление выходных свойств в генератор данных.

11. При необходимости добавьте входные свойства. Дополнительные сведения см. в разделе Практическое руководство. Добавление входных свойств в генератор данных.

12. Реализуйте метод OnGenerateNextValues для создания подходящих значений для каждого выходного свойства. Дополнительные сведения см. в разделе Пошаговое руководство. Создание пользовательского генератора данных.

13. Подпишите сборку строгим именем. Дополнительные сведения см. в разделе Пошаговое руководство. Создание пользовательского генератора данных.

14. Выполните построение решения.

15. Зарегистрируйте новый генератор в Visual Studio. Дополнительные сведения см. в разделах Практическое руководство. Регистрация и управление расширениями функций и Пошаговое руководство. Создание пользовательского генератора данных.

См. также

Задачи

Пошаговое руководство. Создание пользовательского генератора данных

Основные понятия

Создание специализированных тестовых данных с помощью пользовательского генератора данных