نظرة عامة حول منشئ البيانات الامتداد

يمكنك استخدام Visual Studio Premiumأو Visual Studio Ultimateإلى إنشاء بيانات ذات معنى للاختبار. باستخدام مولدات البيانات المضمنة، يمكنك توليد بيانات rوom، توليد البيانات من المصادر البيانات موجود، و التحكم في العديد من أوجه توليد البيانات. إذا كان الأداء الوظيفي لمولدات المضمنة هو غير كافية، يمكنك إنشاء مولدات بيانات المخصصة. إلى إنشاء مولدات بيانات مخصصة، يمكنك استخدام الفئات في Microsoft.Data.Schema.Tools.DataGeneratorمساحة الاسم.

منشئ البيانات الامتداد API

التوافق مع البرامج الخارجية API توفر الفئات التي يمكن أن يرث المطورين. في الإضافة إلى فئات، السمات في cludes API التي يمكنك تطبيقها على الفئات المشتقة الخاصة بك. بتطبيق السمات، تقليل مقدار تعليمات برمجية التي هو المطلوبة في مولدات المخصصة للحالات عام.

يمكنك استخدام واجهة برمجة تطبيقات التوافق مع البرامج الخارجية في ما يلي ثلاث طرق إلى إنشاء cusإلىm generaإلىrs بيانات:

القابلية للتوسعة	الوصف	صعوبة	المثال
مصرحة التوافق مع البرامج الخارجية	يورث Generatorفئة. إضافة مخصص خصائص إدخال والإخراج باستخدام InputAttributeو OutputAttributeالسمات.	سهلة	عدد صحيح المضمنة منشئ بيانات
عادي التوافق مع البرامج الخارجية	يورث Generatorفئة. إضافة مخصص خصائص إدخال والإخراج باستخدام InputAttributeو OutputAttributeالسمات. يمنع واحد أو $ $ $ $ المزيد Generatorوظائف (على سبيل المثال، OnGenerateNextValuesو OnInitialize).	متوسط هذا الأسلوب المستحسن معظم الوقت.	الإرشادات التفصيلية: قم بإنشاء مخصص منشئ البيانات الإرشادات التفصيلية: قم بإنشاء مخصص منشئ البيانات لقيد تحقق
الأساس القابلية للتوسعة	إنشاء الفئة التي تطبق IGenerator واجهة. تطبيق الجميع الطرق التي يتم مطلوب بمولد الخاص بك. إنشاء مخصص المصمم لمولد الذي يطبق IDesigner. تطبيق الجميع وظائف مطلوبة بواسطة مصمم الخاص بك.	صعوبة	لا يوجد

الأساس القابلية للتوسعة

الأساس هو واجهة برمجة تطبيقات القابلية للتوسعة الآلية التي مشغل إنشاء بيانات والمصممين لبيانات إنشاء خطط التفاعل. تم تصميم هذا API إلى تحقيق الأهداف التالية:

• الشدة-إلى الترويج لتنفيذ ما متناسقة وقوة معا وقت التصميم ووقت التشغيل المشغلات.

• المرونة — إلى دعم معقدة مولدات مثل بيانات مرتبطة مولد.

trade-إيقاف تصميم هو ضمني في إمكانية التوسعة API أنه أكثر تعقيداً من واجهة برمجة تطبيقات التوسعة مصرحة ذات المستوى أعلى.

تسجيل مخصص بيانات مولدات

قبل استخدام المخصص الخاص بك منشئ بيانات، يجب تسجيل تشغيل جهاز الكمبيوتر الخاص بك. إذا كنت تقدم عرض توضيحي لجهاز generaإلىr بيانات cusإلىm إلى الآخرين إلى تستخدم، يجب أن يتم تسجيل generaإلىr تشغيل أجهزة الكمبيوتر الخاصة بهم.

يمكنك التسجيل مخصص مولدات البيانات بالطرق التالية:

Method	الاذونات المطلوبة	المثال
قم بتسجيل مولد في المجلد ملحقات.	قوة مستخدم أو أعلى	كيفية القيام بما يلي: لتسجيل و إدارة ميزة ملحقات الإرشادات التفصيلية: قم بإنشاء مخصص منشئ البيانات
إنشاء مشروع نشر إلى generaإلىr في التسجيل.	المسئول	لا يوجد

مولدات بيانات والتوزيعات مصمم

يمكنك إنشاء مخصص مولدات بيانات و مخصص المصممين لتلك مولدات. يمكنك أيضا إنشاء مخصص توزيعات لمولدات البيانات الرقمية و مخصص المصممين لهذه التوزيعات.

• مخصص إنتاج مولدات بيانات اختبار عشوائية البيانات طبقاً لمجموعة من القواعد التي تحددها. يمكنك استخدام المصمم بشكل افتراضي مع تلك مولدات، أو يمكنك إنشاء مصمم مخصصة لهم بوراثة من DefaultGeneratorDesigner. على سبيل المثال، تعبير عادي منشئ بيانات عبارة مولد مضمنة، ولكنه يستخدم مصمم مخصصة بحيث يمكن القيام بالتحقق من الصحة المخصصة لإدخال مستخدم أثناء وقت التصميم.

• باستخدام مصمم مولد مخصصة، يمكنك يخصص الخصائص كيفية إدخال والإخراج يتم استردادها من مستخدم، ويتم تعيين الافتراضي القيم، وتقوم بتعيين سلوك التحقق من صحة.

• باستخدام توزيع مخصصة، يمكنك التحكم في توزيع الرقمية القيم التي منشئ البيانات ينشئ.

• مخصص مصممي توزيع تتحكم بسلوك وقت التصميم مخصص التوزيع. يتضمن هذا سلوك الحصول على أسماء خصائص إدخال للتوزيع، بتعيين الافتراضي قيم خصائص إدخال، والتحقق من صحة قيم خصائص إدخال للتوزيع.

بيانات مولدات و تعريب

مولدات بيانات التي تم تضمينها في Visual Studio Premiumو Visual Studio Ultimateتكون مترجمة لأن Visual Studioيأتي إصدارات لغة متعددة. ربما ليس لديك إلى ترجمة الخاص بك مخصص مولدات بيانات. إذا كان يجب عليك إنشاء منشئ البيانات سوف يتم ترجمتها، يجب إنشاء مصمم مخصصة. يمكنك أيضا يمنع GetInputsأسلوب إلى ترجمة أسماء خاصية إدخال.

ملاحظة

إذا كان ذلك ممكناً، يجب أن يورث من DefaultGeneratorDesignerالفئة، لا يتم تطبيق IDesignerالواجهة، إلى تجنب العمل الإضافي.

منشئ بيانات المثيلات

مخصص مولدات بيانات يمكن المشاركة في بيانات. نطاق البيانات المشتركة هو منشئ النوع وقاعدة بيانات الجدول. يحتوي كل نوع مولد قاموس مثيل فريد لكل جدول في قاعدة بيانات. على سبيل المثال، مخصص منشئ البيانات لجدول المسمى العملاء حق الوصول إلى قاموس مشترك. يمكنك وضع أي معلومات في القاموس و يجعله مشتركًا تلك المعلومات. القاموس هو يضمن أن يكون نفس المثيل لكل نوع مولد والجدول. على سبيل المثال، يمكنك إنشاء مخصص منشئ البيانات وطلب القاموس من GeneratorInit. ثم يمكنك التحقق من ما إذا كان يحتوي على القاموس المشتركة معلومات. إذا كان ذلك، يمكنك استخدام المعلومات إلى إنشاء بيانات. يمكنك أيضا إنشاء المعلومات المشتركة التي غير ذلك يمكن استخدام مثيلات مولد الخاص بك.

ملاحظة

مولد المثيلات هو تقنية متقدمة. يمكنك استخدام المثيلات مولد لإنشاء مخصص منشئ البيانات تحقق مقابض القيود عبر أعمدة — على سبيل المثال، كانت أكبر من عمود آخر قيد تحقق من صحة يتطلب ذلك عمود واحد.

عملية إنشاء بيانات

إنشاء بيانات تحدث في المراحل التالية:

تحدد مصمم نوع	تصميم الوقت	هذه المرحلة يتطلب النوع منشئ بيانات كإدخال. ثم يمكن للمشغل الاستعلام GeneratorAttributeإلى استرداد نوع المصمم. معظم الوقت، GeneratorAttributeهو موروثة من فئة Base، يحدد المصمم الافتراضية.
إنشاء مثيل ويهيّئ مصمم	تصميم الوقت	المصمم هو إنشاء مثيل. المصمم هو تهيئة قبل استدعاء Initializeونوع منشئ كعلي وسيطة.
استرداد واصفات إدخال	تصميم الوقت	InputDescriptorهو التي تم استردادها من المصمم. يقوم المصمم بشكل افتراضي هذا باسترداد الجميع خصائص منشئ بيانات التي يتم وضع علامة InputAttribute.
تعيين الافتراضي قيم	تصميم الوقت	الافتراضي يتم تعيين قيم.
يحصل منشئ إخراج وصف	تصميم الوقت	OutputDescriptorهو التي تم استردادها من المصمم. المصمم بشكل افتراضي باستخدام الخصائص التي تم وضع علامة مع OutputAttributeإلى إنشاء وصف التي تظهر في عمود إخراج Generaإلىr من الإطار تفاصيل العمود.
إنشاء مثيل من مولد	تشغيل الوقت	الدالة الإنشائية بيانات يتم إنشاء مثيل باستخدام المنشئ الافتراضي.
التعيين الإدخالات مولد	تشغيل الوقت	يتم تعيين الجميع قيم إدخال في منشئ بيانات من واصفات إدخال التي تم استردادها من المصمم.
التحقق من صحة مولد	تشغيل الوقت	ValidateInputsأسلوب هو تسمى. في حالة فشل عملية التحقق من صحة، المولد سيتم طرح InputValidationException‏‏ استثناء. أي استثناء غير استثناء التحقق من صحة بيانات هو معاملتها على أنها خطأ لا يمكن إصلاحه.
يهيّئ مولد	تشغيل الوقت	Initializeأسلوب هو تسمى. تمكن هذه الخطوة generaإلىr البيانات إلى القيام بأي إعداد اللازمة قبل حدوث توليد البيانات، كتحديد سلسلة اتصال قاعدة بيانات الهدف أو seeding generaإلىr رقم عشوائي. وهذا مرحلة يحدث مرة واحدة قبل حدوث الجيل بيانات.
قم بتشغيل "إنشاء بيانات	تشغيل الوقت	خلال هذه المرحلة، يتم إنشاء نتائج جديدة عن طريق استدعاء GenerateNextValuesأسلوب. يمكن استرداد نتائج باستخدام GetOutputValueأسلوب. Th هو مفاتيح استرداد أسلوب scalar القيمة من منشئ المطابق للإخراج التي هو التي تم تمريرها إلى مولد كإدخال. تتكرر هذه المرحلة من خلال نتائج حتى يتم إنشاء الجميع نتائج التي تريدها.
التنظيف	تشغيل الوقت	بعد الجميع بيانات الجيل اكتمال، Disposeتسمى إلى تنظيف generaإلىr.

راجع أيضًا:

المهام

كيفية القيام بما يلي: إنشاء مخصص بيانات مولدات

الإرشادات التفصيلية: قم بإنشاء مخصص منشئ البيانات

المرجع

Microsoft.Data.Schema.DataGenerator

المبادئ

قم بإنشاء بيانات اختبار خاصة بمخصص منشئ البيانات