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.GetXmlDocument أسلوب

Visual Studio 2010

إذا XmlDataDocumentهو تعيين إلى ، عنصر تحكم مصدر البيانات تقوم بتخزين البيانات في اﻷول عملية استرداد البيانات، ولكن إعادة تعيين إطار الوقت الذي يحتفظ بذاكرة التخزين المؤقت لبناء كل العملية التالية.

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

public XmlDocument GetXmlDocument()

القيمة المُرجعة

النوع: System.Xml.XmlDocument
An XmlDataDocument object that represents the XML specified in the Data property or in the file identified by the DataFile property, with any transformations and XPath queries applied.

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

The following تعليمات برمجية مثال demonstrates how إلى تمكين تخزين مؤقت when using the DataFile عنصر تحكم إلى عرض بيانات contained في an ملف XML. XmlDataSource

NotSupportedException

تخزين مؤقت هو ممكّن when the DataFile خاصية هو التعيين إلى و the هو التعيين إلى the رقم of ثواني that the بيانات هو cached بواسطة the بيانات التحكم بالمصادر.

-أو-

الحصول أو تعيين نهج انتهاء مدة الصلاحية لذاكرة تخزين مؤقت هو مع مدة ذاكرة تخزين مؤقت وصف سلوك التخزين المؤقت لذاكرة تخزين مؤقت التي يستخدمها عنصر تحكم مصدر بيانات.XmlDataSource

-أو-

صف قيم are passed إلى the أسلوب فقط if the خاصية هو التعيين إلى the حقل. إعداد سياسة الافتراضي صلاحية ذاكرة تخزين مؤقت هو XmlDataSource.

HttpException

سلوك ذاكرة تخزين مؤقت هو التحكم فيها من قبل مجموعة من DataFileو الإعدادات.

إذا GetXmlDocumentهو تعيين إلى ، تقوم بتخزين بيانات في عملية استرداد بيانات أول، تحتفظ به في ذاكرة لمقدار الوقت المحدد بواسطة ، وإبطال بعد الوقت له lapsed.

إذا XmlDataDocumentهو تعيين إلى Save، عنصر تحكم مصدر بيانات تقوم بتخزين بيانات في اﻷول عملية استرداد بيانات، ولكن إعادة تعيين نافذة الوقت الذي يحتفظ بذاكرة التخزين المؤقت لبناء كل تشغيل التالية.DataFile ستنتهي صلاحية ذاكرة تخزين مؤقت فقط إذا كان هناك هو لا النشاط لفترة تساوي XmlDataDocumentمنذ آخر بيانات استرداد. لمزيد من المعلومات، راجع أسلوب Save.

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

المفتاح الذي يعرف الجميع كائنات ذاكرة التخزين المؤقت انشئت بواسطة XmlDataSourceعنصر التحكم.TreeView بينما يتم تخزين البيانات مؤقتاً، GetXmlDocumentيقوم باسترداد البيانات من ذاكرة تخزين مؤقت بدلاً من البيانات الأساسية ملف.TreeView Finally, DataBind is called on the TreeView control to refresh the data that it displays.


<%@ Page LANGUAGE="C#" SMARTNAVIGATION="false" %>
<%@ Import Namespace="System.Xml" %>

<script runat="server" >
  void TreeView1_SelectedNodeChanged(Object sender, EventArgs e)
  {
    XmlDocument myXml = new XmlDocument();
    myXml=(XmlDocument)XmlSource.GetXmlDocument();

    String iterator = TreeView1.SelectedNode.DataPath;

    XmlNode myNode = myXml.SelectSingleNode(iterator);

    myNode.InnerText = "ThisIsATest";
    XmlSource.Save();
    TreeView1.DataBind();
    TreeView1.ExpandAll();
  }
</script>

<!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 id="Head1" runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="Form1" runat="server">

      <asp:xmldatasource
        runat="server"
        id="XmlSource"
        xpath="/bookstore/book"
        datafile="Booksort.xml"
        enableviewstate="False"
        enablecaching="False" />

      <asp:treeview
        runat="server"
        id="TreeView1"
        ExpandDepth="3"
        datasourceid="XmlSource"
        maxdatabinddepth="3"
        autogeneratedatabindings="False"
        onselectednodechanged="TreeView1_SelectedNodeChanged" >
        <databindings>
          <asp:treenodebinding datamember="book" valuefield="publicationdate" />
          <asp:treenodebinding datamember="title" valuefield="#InnerText" />
          <asp:treenodebinding datamember="author" valuefield="#InnerText" />
          <asp:treenodebinding datamember="first-name" valuefield="#InnerText" />
          <asp:treenodebinding datamember="last-name" valuefield="#InnerText" />
        </databindings>
      </asp:treeview>
    </form>
  </body>
</html>


يمكنك تعيين XmlDataSourceخاصية لإنشاء تبعية بين الجميع إدخالات ذاكرة التخزين المؤقت التي تم إنشاؤها بواسطة Repeaterعنصر تحكم المفتاح. As with the previous example, the data is manipulated in memory using the XmlDataDocument retrieved by the GetXmlDocument method. Finally, DataBind is called on the TreeView control to refresh the data that it displays.


<%@ Page LANGUAGE="C#" SMARTNAVIGATION="false" %>
<%@ Import NameSpace="System.Xml" %>
<script runat="server" >

  void Button1_Click(Object sender, EventArgs e)
  {
    XmlDocument myXml = new XmlDocument();
    myXml=(XmlDocument)XmlSource.GetXmlDocument();

    String path = "bookstore/book/@publicationdate";
    XmlNodeList nodeList;
    nodeList = myXml.SelectNodes(path);
    foreach (XmlNode date in nodeList)
      {
        int helper = int.Parse(date.Value) + 2;
        date.Value = helper.ToString();
      }
    XmlSource.Save();
    Repeater1.DataBind();
  }

</script>

<!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 id="Head1" runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="Form1" runat="server" >

      <asp:XmlDataSource
        runat="server"
        ID="XmlSource"
        XPath="bookstore/book[@genre='novel']"
        DataFile="Booksort2.xml"
        EnableViewState="True"
        EnableCaching="False" />

      <asp:Repeater
        runat="server"
        ID="Repeater1"
        DataSourceID="XmlSource" >
          <ItemTemplate >
            <h1><%# XPath ("title/text()") %> </h1>
              <b>Author:</b><%# XPath ("author/first-name/text()") %> <%# XPath ("author/last-name/text()") %>
              <b>PublicationDate:</b><%# XPath ("@publicationdate") %>
              <b>Price:</b><%# XPath ("price/text()") %>
          </ItemTemplate>
      </asp:Repeater>


      <p><asp:Button
        runat="server"
        ID="Button1"
        onclick="Button1_Click"
        Text="Add 2 years to the Publication Date!" /></p>
</form>
</body>
</html>


نظراً للخصائص التي يتم استخدامها لإنشاء ، فإنه هو المحتملة لذلك المتعددة ويمكن استخدام عناصر تحكم التخزين المؤقت نفسه في وحدات سيناريو الموقع يتم تحميل بيانات نفسها الموجودة في نفس ملف XML وتحويل ملف ويكون لهما نفس و التعيين.

<?xml version="1.0" encoding="utf-8"?>
 <bookstore xmlns:bk="urn:samples">
   <book genre="novel" publicationdate="1999" bk:ISBN="0000000000">
     <title>Secrets of Silicon Valley</title>
     <author>
       <first-name>Sheryl</first-name>
       <last-name>Hunter</last-name>
     </author>
     <price>24.95</price>" 
     </book>
   <book genre="novel" publicationdate="1985" bk:ISBN="1111111111">
     <title>Straight Talk About Computers</title>
     <author>
       <first-name>Dean</first-name>
       <last-name>Straight</last-name>
     </author>
     <price>29.95</price>
   </book>
</bookstore>

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