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.

XmlDataSource الفئة

Visual Studio 2010

استخدام خاصية لتحديد نوع عنصر في عنصر تحكم.

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

[ToolboxBitmapAttribute(typeof(XmlDataSource))]
public class XmlDataSource : HierarchicalDataSourceControl, 
	IDataSource, IListSource
<asp:XmlDataSource />

في هذا الموضوع:

مقدمة

استخدام XmlDataSourceعنصر تحكم لحجز مكان تشغيل صفحة ويب لعرض نص. XmlDataSource عنصر التحكم هو مشابهة عنصر التحكم، فيما عدا لا تسمح بالتحكم بتطبيق النمط على نص dهوplayed. عنصر تحكم XmlDataSource عادةً ما يتم استخدامه لعرض بيانات XML هيلكلية في وحدات سيناريو للقراءة فقط . يمكنك برمجياً عنصر تحكم نص المعروض في عنصر تحكم بتعيين XmlDataSourceخاصية.HierarchicalDataSourceControl ل المزيد من المعلومات حول الأمان، راجع XmlDataSource، IDataSource، و .

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

يوضح المثال التالي كيفية استخدام XmlDataSourceعنصر تحكم لعرض نص ثابت. يستخدم المثال التالي طراز تعليمات برمجية أحادية و قد لا تعمل بشكل صحيح في حالة نسخ مباشرة في التعليمات برمجية-خلف ملف. Note that if you need to store information such as XPath property in view state, you can enable encryption to protect the contents by setting ViewStateEncryptionMode on the @ Page directive.

بإعلام XmlDataSourceعنصر تحكم التي تم تحليلها عنصر HTML أو XML وقم بإضافة هذا العنصر إلى من عنصر تحكم.

يوضح المثال تعليمات برمجية التالي كيفية استخدام خاصية لتحديد نوع عنصر في عنصر تحكم.

مثال التعليمة البرمجية التالية يوضح كيفية يمنع XmlDataSourceالتحكم في أسلوب في خادم مخصص دوماً تعيين DataFileخاصية للكائن الموزعة الخاصية، إذا الكائن الموزعة هو ، فارغ otherwهوe. قم بإنشاء Dataكائن لمثيل الحالي عنصر تحكم. مثال التعليمة البرمجية التالية يوضح كيفية يمنع الأسلوب في خادم مخصص عنصر تحكم حيث تقوم دوماً بإرجاع مثيل فئة الكائن. الحصول أو تعيين القيمة قائمة تعداد الذي يحدد كيفية المحتوى في TransformFileعنصر التحكم هو تقديم.Transform

الترتيب الذي يتم فيه تاريخ الإنشاء عناصر في عنصر التحكم هو dهوplayed بالإضافة إلى نوع العنصر.

عنصر تحكم XmlDataSource يتم إستخدامه بشكل شائع في سيناريوهات البيانات للقراءة فقط حيث يقوم عنصر تحكم ربط البيانات بعرض بيانات XML. استخدام XmlDataSourceخاصية لتحديد كيفية المحتويات عنصر تحكم يجب تقديمها. To edit the XML data, call the GetXmlDocument method to retrieve an XmlDataDocument object that is an in-memory representation of the XML data. You can use the object model exposed by the XmlDataDocument and XmlNode objects it contains or use an XPath filtering expression to manipulate data in the document. يتم تمت إزالته عناصر لغة توصيف غير معتمد من المحتويات عنصر تحكم.Save

إذا XmlDataSourceعنصر التحكم هو تقديمها تشغيل مستعرض يدعم تنسيق HTML أو XHTML، محتويات عنصر التحكم هي لا يمكن ‏‏تاريخ التعديلها.

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

  • لا يوجد تحويل XSLT يمكن تحديده في Transform أو خصائص TransformFile.

  • أسلوب Save لا يعالج عمليات الحفظ المتزامنة بواسطة طلبات مختلفة. على سبيل المثال، إذا XmlDataSourceخاصية عنصر تحكم يحتوي على علامة، هو إرسالها إلى الجميع المستعرضات والأجهزة ما إذا كان هو المعتمدة أو عدم. على سبيل المثال، إذا Saveخاصية عنصر تحكم يحتوي على علامة، فإنه هو تحويلها إلى وإرسالها إلى جهاز أو مستعرض.

يوضح المثال تعليمات برمجية التالي كيفية استخدام الخاصية لعرض زر جديد في عنصر تحكم يسمح للمستخدم بإضافة سجل جديد إلى البيانات المصدر.

في هذه الحالة، أي عناصر لغة ترميز لم يتم تقديم خاصية غير معتمدة في اللغة المستهدفة ترميز عنصر تحكم. على سبيل المثال، إذا كان XmlDataSourceتحتوي خاصية على المحتوى Transform، TransformFileو TransformArgumentListتتم تمت إزالته علامات، والنص "اختبار" هو إرسالها إلى الجهاز أو مستعرض. يرسل عنصر تحكم الخادم المحتوى إلى المتوفر XPathالكائن، الذي يقوم بكتابة المحتوى سيتم عرضها تشغيل العميل.

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

مثال التعليمة البرمجية التالية يوضح كيفية يمنع XmlDataSourceالأسلوب في عنصر تحكم ملقم مخصص لذلك خاصة النص هو dهوplayed دائماً قبل XslTransform. الحصول أو تعيين التسمية التوضيحية المعروضة في XslTransformعنصر تحكم.XslCompiledTransform

استخدامها داخليا بواسطة فئة.

By default, the XmlDataSource control loads all the XML data in the XML file identified by the DataFile property or found inline in the Data property, but you can filter the data using an XPath expression. استخدام XPathخاصية لتحديد التسمية التوضيحية المعروضة في عنصر تحكم.

التخزين المؤقت

وهذا يسمح لك بتغيير برمجياً تسمية توضيحية في وقت التشغيل.XmlDataSource التسمية التوضيحية هو HTML-الذي تم فك ترميزه استناداً إلى كيفية تعيين القيمة لترتيب هو خاصية. إذا قمت بتعيين قيمة من خلال إحدى سمات القيمة التحكم هو HTML في فك ترميز قبله هو dهوplayed. The XmlDataSource automatically caches data when the EnableCaching property is set to true, and the CacheDuration property is set to the number of seconds that the cache stores data before the cache is invalidated. على الرغم من ذلك، إذا قمت بتعيين ترتيب هو الخصائص برمجياً أو بوضع نص بين الفتح والإغلاق علامات لعنصر تحكم التسمية التوضيحية هو HTML فك ترميزها.CacheExpirationPolicy

Binds the القيمة of a العميل-side HTTP ملف تعريف ارتباط إلى a معلمة كائن.

على سبيل المثال، XmlDataSourceهو عرض ك "أ & nbsp; ب".

يمثل التحكم بمصدر البيانات البيانات في قاعدة بيانات علائقية SQL إلى عناصر تحكم حدود البيانات.

الوصف

الفرز

يوضح المثال التالي كيفية استخدام XmlDataSourceالخصائص برمجياً تغيير التسمية التوضيحية المعروضة في عنصر تحكم.

تصفية

تعيين تركيز إدخال لعنصر تحكم; XPathإسناد أسلوب التحكم هو غير معتمدة تشغيل عنصر التحكم.

ترحيل الصفحات

يوضح المثال التالي كيفية استخدام XmlDataSourceالخصائص برمجياً تغيير التسمية التوضيحية المعروضة في عنصر تحكم.

التحديثات

XmlDataDocument كان يطلق تشغيل Save.

الحذف

XmlDataDocument كان يطلق تشغيل Save.

إذا كانت قاعدة بيانات التي هو المقترنة باعتماد إجراءات المخزنة، يمكنك تعيين خاصية إلى اسم إجراء المخزن.

XmlDataDocument كان يطلق تشغيل Save.

التخزين المؤقت

CacheDuration عنصر تحكم يتجاوز CacheExpirationPolicyأسلوب فئة. الأساسيةAbsolute

قم بحجز موقع تشغيل الويب صفحة لتعرض نص ثابت.

XmlDataSource أسلوب يطرح التحكم دائماً إستثناء للإشارة إلى أن أسلوب هو غير معتمدة تشغيل عنصر التحكم. The XmlDataSource control retrieves a single named XmlDataSourceView object when used with a data-bound control that displays tabular data. المصادر بيانات XMLGetViewNames When used with a data-bound control that displays hierarchical data, the XmlDataSource control retrieves an XmlHierarchicalDataSourceView for any unique hierarchical path passed to the GetHierarchicalView method.

بناء جملة مصرحة

<asp:XmlDataSource
    CacheDuration="string|Infinite"
    CacheExpirationPolicy="Absolute|Sliding"
    CacheKeyDependency="string"
    DataFile="string"
    EnableCaching="True|False"
    EnableTheming="True|False"
    EnableViewState="True|False"
    ID="string"
    OnDataBinding="DataBinding event handler"
    OnDisposed="Disposed event handler"
    OnInit="Init event handler"
    OnLoad="Load event handler"
    OnPreRender="PreRender event handler"
    OnTransforming="Transforming event handler"
    OnUnload="Unload event handler"
    runat="server"
    SkinID="string"
    TransformArgumentList="string"
    TransformFile="string"
    Visible="True|False"
    XPath="string"
>
    <Data>string</Data>
    <Transform>string</Transform>
</asp:XmlDataSource>

هذا مقطع يحتوي على الثاني بالتعليمات البرمجية الأمثلة. The first code example demonstrates how to use an XmlDataSource control with a TreeView control to display XML data from the sample XML file. The second example demonstrates how to use an XmlDataSource control with a templated Repeater control to display XML data.

XmlDataSource عنصر التحكم هو عنصر تحكم مصدر بيانات XML البيانات للبيانات يوفر-مرتبط عناصر التحكم.TreeView XmlDataSource عنصر تحكم يمكن أن يستخدم عنصر تحكم s بيانات منضم لعرض التسلسل الهرمي وجدول بيانات.DataFile


<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
      <asp:xmldatasource
        id="XmlDataSource1"
        runat="server"
        datafile="books.xml" />

      <!- TreeView uses hierachical data, so the
          XmlDataSource uses an XmlHierarchicalDataSourceView
          when a TreeView is bound to it. -->

      <asp:TreeView
        id="TreeView1"
        runat="server"
        datasourceid="XmlDataSource1">
        <databindings>
          <asp:treenodebinding datamember="book" textfield="title"/>
        </databindings>
      </asp:TreeView>

    </form>
  </body>
</html>


لأن عنصر تحكم يمتد فئة، ويعمل مع بيانات ذات هرمى.

<books>
   <computerbooks>
     <book title="Secrets of Silicon Valley" author="Sheryl Hunter"/>
     <book title="Straight Talk About Computers" author="Dean Straight"/>
     <book title="You Can Combat Computer Stress!" author="Marjorie Green"/>                
   </computerbooks>
   <cookbooks>
     <book title="Silicon Valley Gastronomic Treats" author="Innes del Castill"/>
   </cookbooks>
</books>

XmlDataSource عنصر تحكم يطبق أيضا Repeaterالواجهة ويعمل باستخدام جدولي، أو النمط القائمة، والبيانات. ولأغراض الأمان، أي من Repeaterعنصر تحكم يتم تخزين خصائصه في حالة العرض.XmlDataSource For more information about XPath and XPathSelect data-binding syntax, see the XPathBinder class.


<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>Order</title>
</head>
<body>
    <form id="form1" runat="server">
      <asp:XmlDataSource
        runat="server"
        id="XmlDataSource1"
        XPath="orders/order"
        DataFile="order.xml" />

      <asp:Repeater ID="Repeater1"
        runat="server"
        DataSourceID="XmlDataSource1">
        <ItemTemplate>
            <h2>Order</h2>
            <table>
              <tr>
                <td>Customer</td>
                <td><%#XPath("customer/@id")%></td>
                <td><%#XPath("customername/firstn")%></td>
                <td><%#XPath("customername/lastn")%></td>
              </tr>
              <tr>
                <td>Ship To</td>
                <td><%#XPath("shipaddress/address1")%></font></td>
                <td><%#XPath("shipaddress/city")%></td>
                <td><%#XPath("shipaddress/state")%>,
                    <%#XPath("shipaddress/zip")%></td>
              </tr>
            </table>
            <h3>Order Summary</h3>
            <asp:Repeater ID="Repeater2"
                 DataSource='<%#XPathSelect("summary/item")%>'
                 runat="server">
                <ItemTemplate>
                     <b><%#XPath("@dept")%></b> -
                         <%#XPath(".")%><br />
                </ItemTemplate>
            </asp:Repeater>
            <hr />
        </ItemTemplate>
    </asp:Repeater>

  </form>
  </body>
</html>


لأن عنصر تحكم يمتد فئة، ويعمل مع بيانات ذات هرمى.

<?xml version="1.0" encoding="iso-8859-1"?>
 <orders>
   <order>
     <customer id="12345" />
     <customername>
         <firstn>John</firstn>
         <lastn>Smith</lastn>
     </customername>
     <transaction id="12345" />
     <shipaddress>
         <address1>1234 Tenth Avenue</address1>
         <city>Bellevue</city>
         <state>Washington</state>
         <zip>98001</zip>
     </shipaddress>
     <summary>
         <item dept="tools">screwdriver</item>
         <item dept="tools">hammer</item>
         <item dept="plumbing">fixture</item>
     </summary>
   </order>
</orders>

يتم تأمين العملية الجزئية لأي عضو عمومي ثابت (مشترك في Visual Basic) من هذا النوع. لن يتم ضمان تأمين العملية الجزئية لأي عضو مثيل.

نظام التشغيل 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
إظهار: