XmlDataFileEditor Sınıf

Tanım

Ad Alanı:

System.Web.UI.Design

Bütünleştirilmiş Kod:

System.Design.dll

XML veri dosyası seçmek için tasarım zamanı kullanıcı arabirimi sağlar.

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

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

type XmlDataFileEditor = class
    inherit UrlEditor

Public Class XmlDataFileEditor
Inherits UrlEditor

Devralma

Object

UITypeEditor

UrlEditor

XmlDataFileEditor

Örnekler

Aşağıdaki kod örneği, sınıfın bir örneğinin XmlDataFileEditor özel denetim içinde yer alan bir özellik ile nasıl ilişkilendirildiğini gösterir. Denetim özelliği tasarım yüzeyinde düzenlendiğinde, sınıf özellik XmlDataFileEditor değeri için bir XML dosya adı seçmek ve düzenlemek için kullanıcı arabirimi sağlar.

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 data file name property.  Indicate that the
        // property can be edited at design-time with the XmlDataFileEditor class.
        [EditorAttribute(typeof(System.Web.UI.Design.XmlDataFileEditor), 
                         typeof(System.Drawing.Design.UITypeEditor))]
        public string XmlFileName
        {
            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 data file name property.  Indicate that the
        ' property can be edited at design-time with the XmlDataFileEditor class.
        <EditorAttribute(GetType(System.Web.UI.Design.XmlDataFileEditor), _
                         GetType(System.Drawing.Design.UITypeEditor))> _
        Public Property XmlFileName() 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

Açıklamalar

Nesne XmlDataFileEditor tasarım zamanında xml veri dosyası (.xml) için bir URL seçmek ve düzenlemek ve ardından URL'yi bir denetim özelliğine atamak için kullanılır. Örneğin, XmlDataSource denetim, özelliğin XmlDataFileEditor değerini ayarlamak için tasarım zamanında sınıfını DataFile kullanır.

özniteliğini EditorAttribute bir özellik ile ilişkilendirmek XmlDataFileEditor için kullanın. İlişkili özellik tasarım yüzeyinde düzenlendiğinde tasarımcı konağı yöntemini çağırır EditValue . EditValue yöntemi yöntemini kullanırBuildUrl. Bu yöntem, URL'yi seçmek için bir kullanıcı arabirimi görüntüler ve ardından kullanıcı tarafından seçilen URL'yi döndürür. GetEditStyle yöntemi, kullanıcı arabiriminin görüntüleme stilini gösterir.

XML veri özelliği için özel bir düzenleyici tanımlamak üzere öğesinden XmlDataFileEditor bir sınıf türetin. Örneğin, türetilmiş bir sınıf yöntemini geçersiz kılabilir EditValue ve ardından yöntemini özel Filter veya Caption değerle çağırabilirBuildUrl.

Oluşturucular

XmlDataFileEditor()

XmlDataFileEditor sınıfının yeni bir örneğini başlatır.

Özellikler

Caption	Seçim iletişim kutusunda görüntülenecek resim yazısını alır.
Filter	Düzenleyicinin URL seçimi iletişim kutusunda görünen öğeleri filtrelemek için kullanılan URL filtresi seçeneklerini alır.
IsDropDownResizable	Açılan düzenleyicilerin kullanıcı tarafından yeniden boyutlandırılabilir olup olmayacağını belirten bir değer alır. (Devralındığı yer: UITypeEditor)
Options	URL oluşturucusunun kullanabileceği seçenekleri alır. (Devralındığı yer: UrlEditor)

Yöntemler

EditValue(IServiceProvider, Object)	yöntemi tarafından belirtilen düzenleyici stilini kullanarak belirtilen nesnenin GetEditStyle() değerini düzenler. (Devralındığı yer: UITypeEditor)
EditValue(ITypeDescriptorContext, IServiceProvider, Object)	yöntemi tarafından sağlanan düzenleyici stilini kullanarak belirtilen nesnenin GetEditStyle(ITypeDescriptorContext) değerini düzenler. (Devralındığı yer: UrlEditor)
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetEditStyle()	yöntemi tarafından EditValue(IServiceProvider, Object) kullanılan düzenleyici stilini alır. (Devralındığı yer: UITypeEditor)
GetEditStyle(ITypeDescriptorContext)	Yönteminin düzenleme stilini EditValue(ITypeDescriptorContext, IServiceProvider, Object) alır. (Devralındığı yer: UrlEditor)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetPaintValueSupported()	Bu düzenleyicinin bir nesnenin değerinin gösterimini boyamayı destekleyip desteklemediğini gösterir. (Devralındığı yer: UITypeEditor)
GetPaintValueSupported(ITypeDescriptorContext)	Belirtilen bağlamın, belirtilen bağlam içinde nesne değerinin bir gösterimini boyamayı destekleyip desteklemediğini gösterir. (Devralındığı yer: UITypeEditor)
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
PaintValue(Object, Graphics, Rectangle)	Belirtilen nesnenin değerinin gösterimini belirtilen tuvale boyar. (Devralındığı yer: UITypeEditor)
PaintValue(PaintValueEventArgs)	Belirtilen PaintValueEventArgsöğesini kullanarak bir nesnenin değerinin gösterimini boyar. (Devralındığı yer: UITypeEditor)
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)

Ayrıca bkz.

• UrlEditor
• EditorAttribute
• DataFile