XmlDataSource.Data プロパティとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

XmlDataSource.Data プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

データソースコントロールのバインド先の XML データのブロックを取得または設定します。

名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Overridable Property
 Data As String

Visual Basic (使用法)

Dim instance As XmlDataSource
Dim value As String

value = instance.Data

instance.Data = value

public virtual string Data { get;
 set; }

C++

public:
virtual property String^ Data {
    String^ get ();
    void set (String^ value);
}

/** @property */
public String get_Data ()

/** @property */
public void set_Data (String value)

JScript

public function get Data
 () : String

public function set Data
 (value : String)

プロパティ値
XmlDataSource コントロールのバインド先のインライン XML データの文字列。既定値は String.Empty です。

解説

宣言する時に、XmlDataSource オブジェクトの複数行から成る内部プロパティとして Data を直接指定します。内部プロパティは XML データとの互換性が確保され、XML データを任意の形式で指定できるほか、文字の埋め込みに伴う問題 (引用符文字の埋め込みなど) は無視できます。

DataFile プロパティと Data プロパティの両方を設定した場合、DataFile プロパティが優先され、Data プロパティに指定された XML データではなく、XML ファイル内のデータが使用されます。

Data プロパティの値を変更した場合、DataSourceChanged イベントが発生します。キャッシングが有効になっている場合、Data の値を変更すると、キャッシュは無効になります。

使用例

XmlDataSource コントロールを使用し、Data プロパティに格納されたインライン XML データを TreeView コントロールに表示する方法を次のコード例に示します。

Visual Basic

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

<HTML>
  <BODY>
    <form runat="server">
      <asp:xmldatasource
        id="XmlDataSource1"
        runat="server" >
        <data>
          <Books>
            <LanguageBooks>
              <Book Title="Pure JavaScript" Author="Wyke,
 Gilliam, and Ting"/>
              <Book Title="Effective C++ Second Edition"
 Author="Scott Meyers"/>
              <Book Title="Assembly Language Step-By-Step"
 Author="Jeff Duntemann"/>
              <Book Title="Oracle PL/SQL" Author="Steven
 Feuerstein"/>
            </LanguageBooks>
            <SecurityBooks>
              <Book Title="Counter Hack" Author="Ed
 Skoudis"/>
            </SecurityBooks>
          </Books>
        </data>
        </asp:xmldatasource>

      <!- 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>

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

<HTML>
  <BODY>
    <form runat="server">
      <asp:xmldatasource
        id="XmlDataSource1"
        runat="server" >
        <data>
          <Books>
            <LanguageBooks>
              <Book Title="Pure JavaScript" Author="Wyke, Gilliam,
 and Ting"/>
              <Book Title="Effective C++ Second Edition" Author="Scott
 Meyers"/>
              <Book Title="Assembly Language Step-By-Step" Author="Jeff
 Duntemann"/>
              <Book Title="Oracle PL/SQL" Author="Steven Feuerstein"/>
            </LanguageBooks>
            <SecurityBooks>
              <Book Title="Counter Hack" Author="Ed Skoudis"/>
            </SecurityBooks>
          </Books>
        </data>
        </asp:xmldatasource>

      <!- 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>

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

<HTML>
  <BODY>
    <form runat="server">
      <asp:xmldatasource
        id="XmlDataSource1"
        runat="server" >
        <data>
          <Books>
            <LanguageBooks>
              <Book Title="Pure JavaScript" Author="Wyke, Gilliam,
 and Ting"/>
              <Book Title="Effective C++ Second Edition" Author="Scott
 Meyers"/>
              <Book Title="Assembly Language Step-By-Step" Author="Jeff
 Duntemann"/>
              <Book Title="Oracle PL/SQL" Author="Steven Feuerstein"/>
            </LanguageBooks>
            <SecurityBooks>
              <Book Title="Counter Hack" Author="Ed Skoudis"/>
            </SecurityBooks>
          </Books>
        </data>
        </asp:xmldatasource>

      <!- 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>