XmlDataFileEditor

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

XmlDataFileEditor クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

XML データ ファイルを選択するためのデザイン時ユーザー インターフェイスを提供します。

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

Visual Basic (宣言)

Public Class XmlDataFileEditor
    Inherits UrlEditor

Visual Basic (使用法)

Dim instance As XmlDataFileEditor

C#

public class XmlDataFileEditor : UrlEditor

C++

public ref class XmlDataFileEditor : public
 UrlEditor

J#

public class XmlDataFileEditor extends UrlEditor

JScript

public class XmlDataFileEditor extends
 UrlEditor

解説

XmlDataFileEditor オブジェクトは、XML データ ファイル (.xml) の URL を選択および編集し、その URL をコントロール プロパティに割り当てるためにデザイン時に使用します。たとえば、XmlDataSource コントロールは、デザイン時に XmlDataFileEditor クラスを使用し、DataFile プロパティの値を設定します。

XmlDataFileEditor とプロパティとを関連付けるには、EditorAttribute 属性を使用します。関連付けられたプロパティをデザイン サーフェイスで編集する場合、デザイナ ホストによって EditValue メソッドが呼び出されます。EditValue メソッドは BuildUrl メソッドを使用して、URL を選択するためのユーザー インターフェイスを表示し、ユーザーが選択した URL を返します。GetEditStyle メソッドは、ユーザー インターフェイスの表示スタイルを示します。

XmlDataFileEditor からクラスを派生し、XML データ プロパティのカスタム エディタを定義します。たとえば、派生クラスは、EditValue メソッドをオーバーライドして、BuildUrl メソッドをカスタム Filter 値または Caption 値で呼び出すことができます。

使用例

カスタム コントロールに格納されたプロパティで XmlDataFileEditor クラスのインスタンスにアクセスする方法を次のコード例に示します。デザイン サーフェイスでコントロールのプロパティを編集する場合、XmlDataFileEditor クラスは、プロパティ値の XML ファイル名を選択および編集するためのユーザー インターフェイスを提供します。

Visual Basic

Imports Microsoft.VisualBasic
Imports System
Imports System.ComponentModel
Imports System.ComponentModel.Design
Imports System.Web.UI
Imports System.Web.UI.Design
Imports System.Web.UI.Design.WebControls
Imports System.Web.UI.WebControls
Imports System.IO

Namespace ControlDesignerSamples.VB


    ' Define a simple text control, derived from the 
    ' System.Web.UI.WebControls.Label class.

    <Designer(GetType(TextControlDesigner))> _
    Public Class SimpleTextControl
        Inherits Label

        ' Define a private member to store the file name value in the
 control.
        Private _filename As String
 = ""
        Private _internalText As String
 = ""

        ' Define the public XML data file name property.  Indicate that
 the
        ' property can be edited at design-time with the XmlDataFileEditor
 class.
        <EditorAttribute(GetType(System.Web.UI.Design.XmlDataFileEditor),
 _
                         GetType(System.Drawing.Design.UITypeEditor))>
 _
        Public Property XmlFileName() As
 String
            Get
                Return _filename
            End Get

            Set(ByVal value As
 String)
                _filename = value
            End Set
        End Property

        ' Define a property that returns the timestamp
        ' for the selected file.
        Public ReadOnly Property
 LastChanged() As String
            Get
                If Not _filename Is
 Nothing AndAlso _filename.Length > 0 Then
                    If File.Exists(_filename) Then
                        Dim lastChangedStamp As
 DateTime
                        lastChangedStamp = File.GetLastWriteTime(_filename)
                        Return lastChangedStamp.ToLongDateString()
                    End If
                End If

                Return String.Empty

            End Get

        End Property

        ' Override the control Text property, setting the default
        ' text to the LastChanged string value for the selected
        ' file name.  If the file name has not been set in the
        ' design view, then default to an empty string.
        Public Overrides Property
 Text() As String
            Get
                If _internalText.Length = 0 And
 LastChanged.Length > 0 Then
                    ' If the internally stored value hasn't been set
,
                    ' and the file name property has been set,
                    ' return the last changed timestamp for the file.

                    _internalText = LastChanged
                End If
                Return _internalText
            End Get

            Set(ByVal value As
 String)
                If Not value Is
 Nothing AndAlso value.Length > 0 Then
                    _internalText = value
                Else
                    _internalText = String.Empty
                End If

            End Set
        End Property

    End Class
End Namespace

C#

using System;
using System.ComponentModel;
using System.ComponentModel.Design;
using System.Web.UI;
using System.Web.UI.Design;
using System.Web.UI.Design.WebControls;
using System.Web.UI.WebControls;
using System.IO;

namespace ControlDesignerSamples.CS
{
    // Define a simple text control, derived from the 
    // System.Web.UI.WebControls.Label class.
    [
        Designer(typeof(TextControlDesigner))
    ]
    public class SimpleTextControl : Label
    {
        // Define a private member to store the file name value in the
 control.
        private string _filename = "";
        private string _internalText = "";

        // Define the public XML data file name property.  Indicate
 that the
        // property can be edited at design-time with the XmlDataFileEditor
 class.
        [EditorAttribute(typeof(System.Web.UI.Design.XmlDataFileEditor), 
                         typeof(System.Drawing.Design.UITypeEditor))]
        public string XmlFileName
        {
            get
            {
                return _filename;
            }
            set
            {
                _filename = value;
            }
        }

        // Define a property that returns the timestamp
        // for the selected file.
        public string LastChanged
        {
            get
            {
                if ((_filename != null) &&
 (_filename.Length > 0))
                {
                    if (File.Exists(_filename))
                    {
                        DateTime lastChangedStamp = File.GetLastWriteTime(_filename);
                        return lastChangedStamp.ToLongDateString();
                    }
                }
                return "";
            }
            
        }

        // Override the control Text property, setting the default
        // text to the LastChanged string value for the selected
        // file name.  If the file name has not been set in the
        // design view, then default to an empty string.
        public override string Text
        {
            get
            {
                if ((_internalText == "") &&
 (LastChanged.Length > 0))
                {
                    // If the internally stored value hasn't been set
,
                    // and the file name property has been set,
                    // return the last changed timestamp for the file.
                    _internalText = LastChanged;
                } 
                return _internalText;
            }

            set
            {
                if ((value != null) &&
 (value.Length > 0))
                {
                    _internalText = value;
                }
                else {
                    _internalText = "";
                }
            }
        }
    }

}

.NET Framework のセキュリティ

• SecurityPermission  (アンマネージ コードを操作するために必要なアクセス許可)UnmanagedCode (関連する列挙体)

継承階層

System.Object
   System.Drawing.Design.UITypeEditor
     System.Web.UI.Design.UrlEditor
      System.Web.UI.Design.XmlDataFileEditor

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
XmlDataFileEditor メンバ
System.Web.UI.Design 名前空間
UrlEditor クラス
EditorAttribute
XmlDataSource.DataFile
その他の技術情報
Web フォームのデザイン時サポート

XmlDataFileEditor コンストラクタ

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

XmlDataFileEditor クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New XmlDataFileEditor

C#

public XmlDataFileEditor ()

C++

public:
XmlDataFileEditor ()

J#

public XmlDataFileEditor ()

JScript

public function XmlDataFileEditor ()

.NET Framework のセキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
XmlDataFileEditor クラス
XmlDataFileEditor メンバ
System.Web.UI.Design 名前空間

XmlDataFileEditor プロパティ

パブリック プロパティ

( プロテクト プロパティ も参照)

	名前	説明
	IsDropDownResizable	ユーザーがドロップダウン エディタのサイズを変更できるかどうかを示す値を取得します。 ( UITypeEditor から継承されます。)

プロテクト プロパティ

	名前	説明
	Caption	オーバーライドされます。 選択ダイアログ ボックスに表示するキャプションを取得します。
	Filter	オーバーライドされます。 URL 選択ダイアログ ボックスに表示されるアイテムにフィルタをかけるための、エディタの URL フィルタ オプションを取得します。
	Options	使用する URL ビルダのオプションを示します。 ( UrlEditor から継承されます。)

参照

関連項目

XmlDataFileEditor クラス
System.Web.UI.Design 名前空間
UrlEditor クラス
EditorAttribute
XmlDataSource.DataFile

その他の技術情報

Web フォームのデザイン時サポート

XmlDataFileEditor メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	EditValue	オーバーロードされます。 指定したオブジェクトの値を編集します。 ( UrlEditor から継承されます。)
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetEditStyle	オーバーロードされます。 EditValue メソッドの編集スタイルを取得します。 ( UrlEditor から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetPaintValueSupported	オーバーロードされます。 エディタでオブジェクトの値の視覚的な表現を描画できるかどうかを示します。 ( UITypeEditor から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	PaintValue	オーバーロードされます。 オブジェクトの値の視覚的な表現を描画します。 ( UITypeEditor から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

関連項目

XmlDataFileEditor クラス
System.Web.UI.Design 名前空間
UrlEditor クラス
EditorAttribute
XmlDataSource.DataFile

その他の技術情報

Web フォームのデザイン時サポート

XmlDataFileEditor メンバ

XML データ ファイルを選択するためのデザイン時ユーザー インターフェイスを提供します。

XmlDataFileEditor データ型で公開されるメンバを以下の表に示します。

パブリック コンストラクタ

	名前	説明
	XmlDataFileEditor	XmlDataFileEditor クラスの新しいインスタンスを初期化します。

パブリック プロパティ

( プロテクト プロパティ も参照)

	名前	説明
	IsDropDownResizable	ユーザーがドロップダウン エディタのサイズを変更できるかどうかを示す値を取得します。(UITypeEditor から継承されます。)

プロテクト プロパティ

	名前	説明
	Caption	オーバーライドされます。 選択ダイアログ ボックスに表示するキャプションを取得します。
	Filter	オーバーライドされます。 URL 選択ダイアログ ボックスに表示されるアイテムにフィルタをかけるための、エディタの URL フィルタ オプションを取得します。
	Options	使用する URL ビルダのオプションを示します。(UrlEditor から継承されます。)

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	EditValue	オーバーロードされます。 指定したオブジェクトの値を編集します。 (UrlEditor から継承されます。)
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetEditStyle	オーバーロードされます。 EditValue メソッドの編集スタイルを取得します。 (UrlEditor から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetPaintValueSupported	オーバーロードされます。 エディタでオブジェクトの値の視覚的な表現を描画できるかどうかを示します。 (UITypeEditor から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	PaintValue	オーバーロードされます。 オブジェクトの値の視覚的な表現を描画します。 (UITypeEditor から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

参照

関連項目

XmlDataFileEditor クラス
System.Web.UI.Design 名前空間
UrlEditor クラス
EditorAttribute
XmlDataSource.DataFile

その他の技術情報

Web フォームのデザイン時サポート