MailFileEditorとは何？わかりやすく解説 Weblio辞書

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

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

MailFileEditor クラス

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

デザイン時にプロパティのメールファイル名を選択および編集するためのユーザーインターフェイスを提供します。

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

Visual Basic (宣言)

Public Class MailFileEditor
    Inherits UrlEditor

Visual Basic (使用法)

Dim instance As MailFileEditor

public class MailFileEditor : UrlEditor

C++

public ref class MailFileEditor : public
 UrlEditor

public class MailFileEditor extends UrlEditor

JScript

public class MailFileEditor extends
 UrlEditor

解説

MailFileEditor クラスは、メールファイル名を文字列として選択および編集し、その文字列をコントロールプロパティに割り当てるためにデザイン時に使用できる UITypeEditor オブジェクトです。たとえば、EmbeddedMailObject コントロールは、デザイン時に MailFileEditor クラスを使用し、Path プロパティの値を設定します。

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

MailFileEditor からクラスを派生し、メールファイル名プロパティのカスタムエディタを定義します。たとえば、派生クラスは、EditValue メソッドをオーバーライドし、カスタムメールファイルフィルタまたはタイトルを使用して OpenFileDialog インスタンスを表示できます。

使用例

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

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

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 mail file name property.  Indicate that
 the
        ' property can be edited at design-time with the MailFileEditor
 class.
        <EditorAttribute(GetType(System.Web.UI.Design.MailFileEditor),
 _
                         GetType(System.Drawing.Design.UITypeEditor))>
 _
        Public Property MailFileName() 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 System.IO.File.Exists(_filename) Then
                        Dim lastChangedStamp As
 DateTime
                        lastChangedStamp = System.IO.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

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;

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 file name property.  Indicate that the
        // property can be edited at design-time with the MailFileEditor
 class.
        [EditorAttribute(typeof(System.Web.UI.Design.MailFileEditor), 
                         typeof(System.Drawing.Design.UITypeEditor))]
        public string MailFileName
        {
            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 (System.IO.File.Exists(_filename))
                    {
                        DateTime lastChangedStamp = System.IO.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.MailFileEditor

スレッドセーフ

この型の 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

参照

関連項目
MailFileEditor メンバ
System.Web.UI.Design 名前空間
UITypeEditor
EditorAttribute
Path

MailFileEditor コンストラクタ

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

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

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

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New MailFileEditor

public MailFileEditor ()

C++

public:
MailFileEditor ()

public MailFileEditor ()

JScript

public function MailFileEditor ()

.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
サポート対象 : 2.0

参照

関連項目
MailFileEditor クラス
MailFileEditor メンバ
System.Web.UI.Design 名前空間
UITypeEditor
EditorAttribute
Path

MailFileEditor プロパティ

パブリックプロパティパブリックプロパティ

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

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

プロテクトプロパティ

	名前	説明
	Caption	オーバーライドされます。エディタダイアログのキャプションを返します。
	Filter	オーバーライドされます。ダイアログのファイルフィルタ文字列 ("*.txt" など) を返します。
	Options	使用する URL ビルダのオプションを示します。 ( UrlEditor から継承されます。)

参照

MailFileEditor メソッド

パブリックメソッドパブリックメソッド

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

	名前	説明
	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 から継承されます。)

参照

MailFileEditor メンバ

デザイン時にプロパティのメールファイル名を選択および編集するためのユーザーインターフェイスを提供します。

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

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

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

パブリックプロパティ

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

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

プロテクトプロパティ

	名前	説明
	Caption	オーバーライドされます。エディタダイアログのキャプションを返します。
	Filter	オーバーライドされます。ダイアログのファイルフィルタ文字列 ("*.txt" など) を返します。
	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 から継承されます。)

参照

MailFileEditorとは？わかりやすく解説

MailFileEditor クラス

MailFileEditor コンストラクタ

MailFileEditor プロパティ

関連項目

MailFileEditor メソッド

関連項目

MailFileEditor メンバ

関連項目

「MailFileEditor」の関連用語


	© 2024 Microsoft.All rights reserved.

MailFileEditorとは？ わかりやすく解説

MailFileEditor クラス

MailFileEditor コンストラクタ

MailFileEditor プロパティ

関連項目

MailFileEditor メソッド

関連項目

MailFileEditor メンバ

関連項目

急上昇のことば

「MailFileEditor」の関連用語

MailFileEditorとは？わかりやすく解説