XslTransformFileEditor Classe

Referência

Definição

Namespace:: System.Web.UI.Design

Assembly:: System.Design.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Fornece uma interface do usuário no tempo de design para selecionar um arquivo de transformação XML.

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

Herança: Object

UITypeEditor

UrlEditor
XslTransformFileEditor

Exemplos

O exemplo de código a seguir demonstra como associar uma instância da classe a XslTransformFileEditor uma propriedade contida em um controle personalizado. Quando a propriedade de controle é editada na superfície de design, a XslTransformFileEditor classe permite que a interface do usuário selecione e edite um nome de arquivo de transformação XML para o valor da propriedade.

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

Comentários

Um XslTransformFileEditor objeto é usado no momento do design para selecionar e editar uma URL para um arquivo de transformação XML (.xsl) e atribuir a URL a uma propriedade de controle. Por exemplo, o XmlDataSource controle usa a XslTransformFileEditor classe em tempo de design para definir o valor da TransformFile propriedade.

Use o EditorAttribute atributo para associar a XslTransformFileEditor uma propriedade. Quando a propriedade associada é editada na superfície de design, o host do designer chama o EditValue método. O EditValue método usa o BuildUrl método, que, por sua vez, exibe uma interface do usuário para selecionar a URL e retorna a URL selecionada pelo usuário. O GetEditStyle método indica o estilo de exibição da interface do usuário.

Derivar uma classe do XslTransformFileEditor editor personalizado para uma propriedade de URL de arquivo de transformação XML. Por exemplo, uma classe derivada pode substituir o EditValue método e, em seguida, chamar o BuildUrl método com um valor ou Caption personalizadoFilter.

Construtores

XslTransformFileEditor()

Inicializa uma nova instância da classe XslTransformFileEditor.

Propriedades

Caption	Obtém a legenda a ser exibida na caixa de diálogo de seleção.
Filter	Obtém as opções de filtro de URL para o editor, que são usadas para filtrar os itens que aparecem na caixa de diálogo de seleção de URL.
IsDropDownResizable	Obtém um valor que indica se os editores de lista suspensa devem ser redimensionáveis pelo usuário. (Herdado de UITypeEditor)
Options	Obtém as opções do construtor de URL a ser usado. (Herdado de UrlEditor)

Métodos

EditValue(IServiceProvider, Object)	Edita o valor do objeto especificado usando o estilo de editor indicado pelo método GetEditStyle(). (Herdado de UITypeEditor)
EditValue(ITypeDescriptorContext, IServiceProvider, Object)	Edita o valor do objeto especificado usando o estilo de editor fornecido pelo método GetEditStyle(ITypeDescriptorContext). (Herdado de UrlEditor)
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetEditStyle()	Obtém o estilo de editor usado pelo método EditValue(IServiceProvider, Object). (Herdado de UITypeEditor)
GetEditStyle(ITypeDescriptorContext)	Obtém o estilo de edição do método EditValue(ITypeDescriptorContext, IServiceProvider, Object). (Herdado de UrlEditor)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetPaintValueSupported()	Indica se esse editor é compatível com pintura de uma representação do valor de um objeto. (Herdado de UITypeEditor)
GetPaintValueSupported(ITypeDescriptorContext)	Indica se o contexto especificado é compatível com pintura de uma representação do valor de um objeto no contexto especificado. (Herdado de UITypeEditor)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
PaintValue(Object, Graphics, Rectangle)	Pinta uma representação do valor do objeto especificado na tela especificada. (Herdado de UITypeEditor)
PaintValue(PaintValueEventArgs)	Pinta uma representação do valor de um objeto usando o PaintValueEventArgs especificado. (Herdado de UITypeEditor)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Aplica-se a