کنترل XML ASP.NET
تعریف و استفاده
کنترل XML برای نمایش مستند XML یا نتایج تبدیل XSL استفاده می‌شود.
ویژگی‌ها
با تنظیم یکی از این سه ویژگی Document، DocumentContent یا DocumentSource برای مشخص کردن مستندی که باید نمایش داده شود. این سه ویژگی نمونه‌های مختلفی از مستندات XML را نشان می‌دهند. با تنظیم ویژگی مناسب، می‌توانید مستند System.Xml.XmlDocument، رشته XML یا فایل XML را نمایش دهید.
با تنظیم یکی از این دو ویژگی Transform، TransformSource، می‌توانید یک جدول سبک تبدیل XSL (XSLT) مشخص را انتخاب کنید، که در قبل از نوشتن مستند XML به جریان خروجی فرمت داده می‌شود. این دو ویژگی نمونه‌های مختلفی از جدول سبک تبدیل XSL برای فرمت‌دهی مستند XML را نشان می‌دهند. با تنظیم ویژگی مناسب، می‌توانید مستند XML را با استفاده از شیء System.Xml.Xsl.XslCompiledTransform یا فایل جدول سبک تبدیل XSL فرمت‌دهی کنید. اگر جدول سبک تبدیل XSL مشخص نشده باشد، مستند XML با استفاده از فرمت پیش‌فرض نمایش داده می‌شود.
Xml کلاس همچنین ویژگی TransformArgumentList را فراهم می‌کند، که این ویژگی به شما امکان می‌دهد تا یک جدول سبک تبدیل XSL با پارامترهای اختیاری ارائه دهید. این پارامترها می‌توانند پارامترهای تبدیل XSL (XSLT) یا اشیای گسترش باشند.
| ویژگی‌ها | توضیح | .NET |
|---|---|---|
| Document | استفاده از آن توصیه نمی‌شود. مستند XML را با استفاده از obiekt System.Xml.XmlDocument مشخص می‌کند. | 1.0 |
| DocumentContent | زبان XML را مشخص می‌کند. | 1.0 |
| DocumentSource | مسیر مستند XML را که در کنترل XML نمایش داده می‌شود مشخص می‌کند. | 1.0 |
| runat | این کنترل را کنترل سرور می‌کند. باید به "server" تنظیم شود. | 1.0 |
| Transform | از obiekt System.Xml.Xsl.XslTransform برای فرمت کردن مستند XML استفاده کنید. | 1.0 |
| TransformArgumentList | لیست انتخابی پارامترهایی که به پالینه‌ها منتقل می‌شوند و در تبدیل زبان پالینه‌های گسترش یافته (XSLT) استفاده می‌شوند را شامل می‌شود. | |
| TransformSource | مسیر فایل تبدیل XSL را مشخص می‌کند. | |
| XPathNavigator | مدل ماوس برای جستجو و ویرایش داده‌های XML مرتبط با کنترل XML استفاده می‌شود. |
ویژگی‌های استاندارد کنترل
AppRelativeTemplateSourceDirectory, BindingContainer, ClientID, Controls EnableTheming, EnableViewState, ID, NamingContainer, Page, Parent, Site TemplateControl, TemplateSourceDirectory, UniqueID, Visible
برای توضیح کامل، لطفاً بهویژگی‌های استاندارد کنترل.
مثال
- XML
- این مثال نشان می‌دهد که چگونه می‌توان از کنترل XML برای نمایش نتایج تبدیل XSL استفاده کرد.
