MailFileEditor Klas

Definitie

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

Overname

Object

UITypeEditor

UrlEditor

MailFileEditor

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u een exemplaar van de MailFileEditor klasse koppelt aan een eigenschap die zich in een aangepast besturingselement bevindt. Wanneer de besturingselementeigenschap wordt bewerkt in het ontwerpoppervlak, biedt de klasse de MailFileEditor gebruikersinterface voor het selecteren en bewerken van een e-mailbestandsnaam voor de eigenschapswaarde.

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

Opmerkingen

De MailFileEditor klasse is een UITypeEditor object dat tijdens het ontwerp kan worden gebruikt om een e-mailbestandsnaam als tekenreeks te selecteren en te bewerken en de tekenreeks toe te wijzen aan een besturingselementeigenschap. Het besturingselement gebruikt bijvoorbeeld EmbeddedMailObject de klasse tijdens het MailFileEditor ontwerp om de waarde van de Path eigenschap in te stellen.

Gebruik het EditorAttribute kenmerk om het MailFileEditor aan een eigenschap te koppelen. Wanneer de bijbehorende eigenschap wordt bewerkt in het ontwerpoppervlak, roept de ontwerphost de methode aan EditValue . De EditValue methode geeft een dialoogvenster weer voor het selecteren van een e-mailbestandsnaam in een gefilterde lijst met bestanden en retourneert de bestandsnaam die door de gebruiker is geselecteerd. De GetEditStyle methode geeft de weergavestijl van de gebruikersinterface aan.

Een klasse afleiden van de MailFileEditor klasse om een aangepaste editor te definiëren voor een eigenschap van een e-mailbestandsnaam. Een afgeleide klasse kan bijvoorbeeld de EditValue methode overschrijven en een OpenFileDialog exemplaar weergeven met een aangepast e-mailbestandsfilter of een aangepaste titel.

Zie ook

• UITypeEditor
• EditorAttribute
• Path