MailFileEditor Kelas

Definisi

Ruang nama:

System.Web.UI.Design

Rakitan:

System.Design.dll

Menyediakan antarmuka pengguna untuk memilih dan mengedit nama file email untuk properti pada waktu desain.

public ref class MailFileEditor : System::Web::UI::Design::UrlEditor

public class MailFileEditor : System.Web.UI.Design.UrlEditor

type MailFileEditor = class
    inherit UrlEditor

Public Class MailFileEditor
Inherits UrlEditor

Warisan

Object

UITypeEditor

UrlEditor

MailFileEditor

Contoh

Contoh kode berikut menunjukkan cara mengaitkan instans MailFileEditor kelas dengan properti yang terkandung dalam kontrol kustom. Saat properti kontrol diedit di permukaan desain, MailFileEditor kelas menyediakan antarmuka pengguna untuk memilih dan mengedit nama file email untuk nilai properti.

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 = "";
                }
            }
        }
    }
}

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

Keterangan

Kelas MailFileEditor adalah UITypeEditor objek yang dapat digunakan pada waktu desain untuk memilih dan mengedit nama file email sebagai string, dan menetapkan string ke properti kontrol. Misalnya, EmbeddedMailObject kontrol menggunakan kelas pada MailFileEditor waktu desain untuk mengatur nilai Path properti.

EditorAttribute Gunakan atribut untuk mengaitkan MailFileEditor dengan properti. Ketika properti terkait diedit di permukaan desain, host perancang memanggil EditValue metode . Metode EditValue ini menampilkan kotak dialog untuk memilih nama file email dari daftar file yang difilter, dan mengembalikan nama file yang dipilih oleh pengguna. Metode menunjukkan GetEditStyle gaya tampilan antarmuka pengguna.

Mendapatkan kelas dari MailFileEditor untuk menentukan editor kustom untuk properti nama file email. Misalnya, kelas turunan dapat mengambil alih EditValue metode , dan menampilkan OpenFileDialog instans dengan filter atau judul file email kustom.

Konstruktor

Nama	Deskripsi
MailFileEditor()	Menginisialisasi instans baru dari kelas MailFileEditor.

Properti

Nama	Deskripsi
Caption	Mendapatkan keterangan untuk dialog editor.
Filter	Mendapatkan string filter file untuk dialog (seperti "*.txt").
IsDropDownResizable	Mendapatkan nilai yang menunjukkan apakah editor drop-down harus dapat diubah bentuknya oleh pengguna. (Diperoleh dari UITypeEditor)
Options	Mendapatkan opsi untuk digunakan penyusun URL. (Diperoleh dari UrlEditor)

Metode

Nama	Deskripsi
EditValue(IServiceProvider, Object)	Mengedit nilai objek yang ditentukan menggunakan gaya editor yang ditunjukkan GetEditStyle() oleh metode . (Diperoleh dari UITypeEditor)
EditValue(ITypeDescriptorContext, IServiceProvider, Object)	Mengedit nilai objek yang ditentukan menggunakan gaya editor yang disediakan oleh GetEditStyle(ITypeDescriptorContext) metode . (Diperoleh dari UrlEditor)
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetEditStyle()	Mendapatkan gaya editor yang digunakan oleh EditValue(IServiceProvider, Object) metode . (Diperoleh dari UITypeEditor)
GetEditStyle(ITypeDescriptorContext)	Mendapatkan gaya EditValue(ITypeDescriptorContext, IServiceProvider, Object) pengeditan metode . (Diperoleh dari UrlEditor)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetPaintValueSupported()	Menunjukkan apakah editor ini mendukung pengecatan representasi nilai objek. (Diperoleh dari UITypeEditor)
GetPaintValueSupported(ITypeDescriptorContext)	Menunjukkan apakah konteks yang ditentukan mendukung pengecatan representasi nilai objek dalam konteks yang ditentukan. (Diperoleh dari UITypeEditor)
GetType()	Mendapatkan Type instans saat ini. (Diperoleh dari Object)
MemberwiseClone()	Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object)
PaintValue(Object, Graphics, Rectangle)	Melukis representasi nilai objek yang ditentukan ke kanvas yang ditentukan. (Diperoleh dari UITypeEditor)
PaintValue(PaintValueEventArgs)	Melukis representasi nilai objek menggunakan yang ditentukan PaintValueEventArgs. (Diperoleh dari UITypeEditor)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Lihat juga

• UITypeEditor
• EditorAttribute
• Path