This article was translated by machine. To view in the article in English, select the English check box. You can also display the English text in a popup window by moving the mouse pointer over the text.
الترجمة
الأصلي
This documentation is archived and is not being maintained.

WebPartManager.ExportWebPart أسلوب

Visual Studio 2010

Creates an XML وصف ملف that يحتوي على الولاية و خاصية بيانات for a عنصر تحكم الخادم.

مساحة الاسم:  System.Web.UI.WebControls.WebParts
التجميع:  System.Web (في System.Web.dll)

public virtual void ExportWebPart(
	WebPart webPart,
	XmlWriter writer
)

المعلمات

webPart
النوع: System.Web.UI.WebControls.WebParts.WebPart
The عنصر تحكم من which بيانات will be exported.
writer
النوع: System.Xml.XmlWriter
An XmlWriter that writes the exported بيانات من webPart إلى an XML وصف ملف.

استثناء:شرط
ArgumentNullException

webPart هو null.

-أو-

writer هو null.

ArgumentException

webPart ليس contained في the مجموعة of عناصر التحكم مشار إليها في Controls.

-أو-

The ExportMode خاصية of webPart هو التعيين إلى a القيمة of None, which means that يصدّر هو معطّل for webPart.

The ExportWebPart أسلوب assembles متنوع الولاية و خاصية بيانات من webPart في an ملف XML. The بيانات يتضمن معلومات حول the عنصر تحكم itself, including its تجميع, الولاية بيانات, و خاصية بيانات. The مستخدم who initiates the يصدّر can حفظ the ملف XML إلى قرص تشغيل the محلي الكمبيوتر أو the شبكة. يمكن للمستخدمين الآخرين استيراد الملف وصف ثم إلى صفحة غير ذلك أو موقع ويب، ثم قم بتطبيق بيانات الحالة والخاصية إلى مثيل آخر من webPart. This provides a fast و convenient mechanism for users إلى يجعله مشتركًا و reuse their إعدادات تشغيل الخادم عناصر التحكم, و it also provides developers مع a means إلى عنصر تحكم the المظهر و سلوك of exported و imported عناصر التحكم.

خصائص تشغيل webPart are not exported بواسطة الافتراضي. إلى تمكين يصدّر of a خاصية, you must mark it مع the [Personalizable] سمة في the المصدر تعليمات برمجية. You can also optionally mark an exportable خاصية كـ containing sensitive بيانات, بواسطة إعداد the isSensitive معلمة of the [Personalizable] سمة إلى true. بشكل افتراضي، isSensitive يكون false. Developers can التعيين the معلمة إلى true إلى indicate that the بيانات هو sensitive.

إلى تمكين webPart إلى be exported, a developer sets its ExportMode قيمة الخاصية إلى either All (which يتضمن الجميع personalizable و sensitive خصائص), أو إلى NonSensitiveData, which exports everything except for sensitive خصائص.

ملاحظة هامةهام

Allowing users إلى يصدّر بيانات من عناصر التحكم, و إلى استيراد بيانات في غير ذلك عناصر التحكم, entails some الأمان risks. Developers should استخدم the approach discussed above إلى يحمي sensitive بيانات, و if they want إلى avoid the خطر of exposing بيانات altogether, they should not تمكين يصدّر تشغيل webPart at الجميع. For تفاصيل تشغيل ويب Parts الأمان issues, see تأمين صفحات أجزاء ويب.

نظام التشغيل Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, الإصدار x64 من نظام التشغيل Windows XP Professional, Windows XP Starter Edition, Windows Server 2008, نظام التشغيل Windows Server 2003, نظام التشغيل Windows Server 2000 المزود بحزمة الخدمة SP4, نظام التشغيل Windows Millennium Edition, نظام التشغيل Windows 98

لا يدعم .NET Framework و .NET Compact Framework كافة الإصدارات الخاصة بكل نظام أساسي. للحصول على قائمة بالإصدارات المدعمة، راجع متطلبات النظام إطار عمل .NET.

.NET Framework

مدعوم في: 4, 3.5, 3.0, 2.0
إظهار: