XslTransformFileEditor Klass

Definition

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

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

type XslTransformFileEditor = class
    inherit UrlEditor

Public Class XslTransformFileEditor
Inherits UrlEditor

Arv

Object

UITypeEditor

UrlEditor

XslTransformFileEditor

Exempel

Följande kodexempel visar hur du associerar en instans av XslTransformFileEditor klassen med en egenskap som finns i en anpassad kontroll. När kontrollegenskapen redigeras på designytan XslTransformFileEditor tillåter klassen användargränssnittet att välja och redigera ett XML-transformeringsfilnamn för egenskapsvärdet.

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 transform file property.  Indicate that the
        // property can be edited at design-time with the XslTransformFileEditor class.
        [EditorAttribute(typeof(System.Web.UI.Design.XslTransformFileEditor), 
                         typeof(System.Drawing.Design.UITypeEditor))]
        public string TransformFileName
        {
            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 = "";
                }
            }
        }
    }
}

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 transform file property.  Indicate that the
        ' property can be edited at design-time with the XslTransformFileEditor class.
        <EditorAttribute(GetType(System.Web.UI.Design.XslTransformFileEditor), _
                         GetType(System.Drawing.Design.UITypeEditor))> _
        Public Property TransformFileName() 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

Kommentarer

Ett XslTransformFileEditor objekt används vid designtillfället för att välja och redigera en URL för en XML-transformeringsfil (.xsl) och för att tilldela URL:en till en kontrollegenskap. Kontrollen använder XmlDataSource till exempel XslTransformFileEditor klassen vid designtillfället för att ange värdet för TransformFile egenskapen.

Använd attributet EditorAttribute för att associera XslTransformFileEditor med en egenskap. När den associerade egenskapen redigeras på designytan anropar EditValue designervärden metoden. Metoden EditValue använder BuildUrl metoden, som i sin tur visar ett användargränssnitt för att välja URL:en och returnerar sedan den URL som användaren har valt. Metoden GetEditStyle anger visningsformatet för användargränssnittet.

Härled en klass från XslTransformFileEditor för att definiera en anpassad redigerare för en XML-transformeringsfils-URL-egenskap. En härledd klass kan till exempel åsidosätta EditValue metoden och sedan anropa BuildUrl metoden med ett anpassat Filter eller Caption värde.

Se även

• UrlEditor
• EditorAttribute
• TransformFile