كيفية إجراء تسلسل كائن إلى XML باستخدام Visual C #


للحصول على إصدار Microsoft Visual Basic.NET من هذه المقالة، راجع 315703 .

تشير هذه المقالة إلى مكتبة فئات Microsoft.NET Framework مساحات الأسماء التالية:

  • System.Xml
  • System.Xml.Serialization

في هذه المهمة

ملخص


توضح هذه المقالة خطوة بخطوة كيفية إجراء تسلسل كائن إلى XML باستخدام Visual C#. هذا الأسلوب مفيد لاستمرار حالة الكائن. هذا الأسلوب مفيد أيضا لنسخ كائن بإلغاء تسلسل XML إلى كائن جديد.

العودة إلى أعلى
 

متطلبات

توضح القائمة التالية الأجهزة الموصى بها برامج البنية الأساسية للشبكة وحزم الخدمات المطلوبة:

  • Microsoft Visual Studio

تفترض هذه المقالة أنك معتاد على المواضيع التالية:

  • الإلمام العام باستخدام XML
  • الإلمام العام باستخدام # Visual C
العودة إلى أعلى

إنشاء تسلسل XML

التسلسل هو عملية أخذ حالة الكائن واستمرار بطريقة ما. يتضمن Microsoft.NET Framework فعالة الكائنات التي يمكن إجراء تسلسل لأي كائن إلى XML. توفر مساحة الاسم System.Xml.Serialization هذه الإمكانية.

اتبع هذه الخطوات لإنشاء تطبيق وحدة تحكم الذي يقوم بإنشاء كائن، وتسلسل حالته إلى XML ثم:

  1. في Visual C#، قم بإنشاء مشروع "تطبيق وحدة تحكم" جديد.
  2. من القائمة مشروع ، انقر فوق إضافة فئة لإضافة فئة جديدة إلى المشروع.
  3. في مربع الحوار إضافة عنصر جديد ، تغيير اسم الفئة إلى clsPerson.
  4. انقر فوق إضافة. يتم إنشاء فئة جديدة.

    ملاحظة: في Visual Studio.NET 2003، انقر فوق فتح.
  5. أضف التعليمات البرمجية التالية بعد العبارة clsPerson "الفئة العامة"
     public   string FirstName; public   string MI; public   string LastName;
  6. التبديل إلى إطار التعليمات البرمجية Program.cs في Visual Studio أو Class1.cs في Visual Studio.NET 2003.
  7. في الأسلوب الرئيسي باطلة، تعريف وانشاء مثيل لفئة clsPerson :
    clsPerson p = new clsPerson();
  8. تعيين خصائص كائن clsPerson :
    p.FirstName = "Jeff";p.MI = "A";p.LastName = "Price";
  9. مساحة الاسم Xml.Serialization يحتوي على فئة XmlSerializer تسلسل كائن إلى XML. عندما تقوم بإنشاء مثيل XmlSerializer، يمكنك تمرير نوع الفئة التي تريد إجراء تسلسل إلى الدالة الإنشائية الخاصة بها:
    System.Xml.Serialization.XmlSerializer x = new System.Xml.Serialization.XmlSerializer(p.GetType());
  10. يتم استخدام أسلوب التسلسل لتسلسل كائن إلى XML. تسلسل محملة فوق طاقتها وإرسال الإخراج إلى كائن الدفقأو TextWriter XMLWriter . في هذا المثال، يمكنك إرسال الإخراج إلى وحدة التحكم:
    x.Serialize(Console.Out,p);Console.WriteLine();Console.ReadLine();
العودة إلى أعلى

إتمام سرد التعليمات البرمجية

using System;public class clsPerson{  public  string FirstName;  public  string MI;  public  string LastName;}class class1{    static void Main(string[] args)   {      clsPerson p=new clsPerson();      p.FirstName = "Jeff";      p.MI = "A";      p.LastName = "Price";      System.Xml.Serialization.XmlSerializer x = new System.Xml.Serialization.XmlSerializer(p.GetType());      x.Serialize(Console.Out, p);      Console.WriteLine();      Console.ReadLine();   }}    
العودة إلى أعلى

التحقق من الصحة

للتحقق من أن يعمل المشروع الخاص بك، اضغط CTRL + F5 لتشغيل المشروع. يتم إنشاء كائن clsPerson ونشر مع القيم التي قمت بإدخالها. إجراء تسلسل هذه الحالة إلى XML. يعرض إطار وحدة التحكم التالية:
<?xml version="1.0" encoding="IBM437"?> <clsPerson xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3 .org/2001/XMLSchema"><FirstName>Jeff</FirstName> <MI>A</MI><LastName>Price</LastName></clsPerson>
العودة إلى أعلى

استكشاف أخطاء وإصلاحها

يقوم كائن Xml.Serialization.XmlSerializer التسلسل سطحية فقط. إذا كنت تريد إجراء تسلسل المتغيرات الخاصة الكائنات التابعة أو كائن، يجب استخدام تسلسل عميق.

العودة إلى أعلى

المراجع


لمزيد من المعلومات، قم بزيارة موقع شبكة مطوري Microsoft (MSDN) التالي على الويب:العودة إلى أعلى