XmlDataFileEditor Klasse

Definition

Stellt eine Entwurfszeit-Benutzeroberfläche für das Auswählen einer XML-Datendatei bereit.Provides a design-time user interface for selecting an XML data file.

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
Vererbung
XmlDataFileEditor

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie eine Instanz der- XmlDataFileEditor Klasse mit einer Eigenschaft verknüpft wird, die in einem benutzerdefinierten Steuerelement enthalten ist.The following code example demonstrates how to associate an instance of the XmlDataFileEditor class with a property that is contained within a custom control. Wenn die Steuerelement Eigenschaft auf der Entwurfs Oberfläche bearbeitet wird, XmlDataFileEditor stellt die-Klasse die Benutzeroberfläche bereit, um einen XML-Dateinamen für den Eigenschafts Wert auszuwählen und zu bearbeiten.When the control property is edited on the design surface, the XmlDataFileEditor class provides the user interface to select and edit an XML file name for the property value.

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

Hinweise

Ein XmlDataFileEditor -Objekt wird zur Entwurfszeit verwendet, um eine URL für eine XML-Datendatei (. Xml) auszuwählen und zu bearbeiten, und dann die URL einer Steuerelement Eigenschaft zuzuweisen.An XmlDataFileEditor object is used at design time to select and edit a URL for an XML data file (.xml), and then assign the URL to a control property. Beispielsweise verwendet das-Steuerelement zur XmlDataSource XmlDataFileEditor Entwurfszeit die-Klasse, um den Wert der-Eigenschaft festzulegen DataFile .For example, the XmlDataSource control uses the XmlDataFileEditor class at design time to set the value of the DataFile property.

Verwenden Sie das- EditorAttribute Attribut, um die XmlDataFileEditor einer Eigenschaft zuzuordnen.Use the EditorAttribute attribute to associate the XmlDataFileEditor with a property. Wenn die zugehörige Eigenschaft auf der Entwurfs Oberfläche bearbeitet wird, ruft der Designer Host die- EditValue Methode auf.When the associated property is edited on the design surface, the designer host calls the EditValue method. Die EditValue -Methode verwendet die BuildUrl -Methode, die wiederum eine Benutzeroberfläche zum Auswählen der URL anzeigt, und gibt dann die URL zurück, die vom Benutzer ausgewählt wird.The EditValue method uses the BuildUrl method, which in turn displays a user interface for selecting the URL, and then returns the URL that is selected by the user. Die- GetEditStyle Methode gibt den Anzeige Stil der Benutzeroberfläche an.The GetEditStyle method indicates the display style of the user interface.

Leiten Sie eine Klasse von ab XmlDataFileEditor , um einen benutzerdefinierten Editor für eine XML-Dateneigenschaft zu definieren.Derive a class from the XmlDataFileEditor to define a custom editor for an XML data property. Beispielsweise kann eine abgeleitete Klasse die EditValue -Methode überschreiben und dann die- BuildUrl Methode mit einem benutzerdefinierten- Filter oder-Wert abrufen Caption .For example, a derived class can override the EditValue method, and then call the BuildUrl method with a custom Filter or Caption value.

Konstruktoren

XmlDataFileEditor()

Initialisiert eine neue Instanz der XmlDataFileEditor-Klasse.Initializes a new instance of the XmlDataFileEditor class.

Eigenschaften

Caption

Ruft die für das Auswahldialogfeld anzuzeigende Beschriftung ab.Gets the caption to display on the selection dialog box.

Filter

Ruft die URL-Filteroptionen für den Editor ab, die zum Filtern der Elemente im URL-Auswahldialogfeld verwendet werden.Gets the URL filter options for the editor, which is used to filter the items that appear in the URL selection dialog box.

IsDropDownResizable

Ruft einen Wert ab, der angibt, ob Dropdowneditoren von den Benutzern in der Größe veränderbar sein sollten.Gets a value indicating whether drop-down editors should be resizable by the user.

(Geerbt von UITypeEditor)
Options

Ruft die Optionen ab, die der URL-Generator verwenden soll.Gets the options for the URL builder to use.

(Geerbt von UrlEditor)

Methoden

EditValue(IServiceProvider, Object)

Bearbeitet den Wert des angegebenen Objekts, wobei der von der GetEditStyle()-Methode angegebene Editor-Stil verwendet wird.Edits the value of the specified object using the editor style indicated by the GetEditStyle() method.

(Geerbt von UITypeEditor)
EditValue(ITypeDescriptorContext, IServiceProvider, Object)

Bearbeitet den Wert des angegebenen Objekts, wobei der von der GetEditStyle(ITypeDescriptorContext)-Methode angegebene Editor-Stil verwendet wird.Edits the value of the specified object using the editor style provided by the GetEditStyle(ITypeDescriptorContext) method.

(Geerbt von UrlEditor)
Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
GetEditStyle()

Ruft den von der EditValue(IServiceProvider, Object)-Methode verwendeten Editor-Stil ab.Gets the editor style used by the EditValue(IServiceProvider, Object) method.

(Geerbt von UITypeEditor)
GetEditStyle(ITypeDescriptorContext)

Ruft den Bearbeitungsstil der EditValue(ITypeDescriptorContext, IServiceProvider, Object)-Methode ab.Gets the editing style of the EditValue(ITypeDescriptorContext, IServiceProvider, Object) method.

(Geerbt von UrlEditor)
GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Geerbt von Object)
GetPaintValueSupported()

Gibt an, ob dieser Editor das Zeichnen einer Objektwertdarstellung unterstützt.Indicates whether this editor supports painting a representation of an object's value.

(Geerbt von UITypeEditor)
GetPaintValueSupported(ITypeDescriptorContext)

Gibt an, ob der angegebene Kontext das Zeichnen einer Objektwertdarstellung innerhalb des angegebenen Kontexts unterstützt.Indicates whether the specified context supports painting a representation of an object's value within the specified context.

(Geerbt von UITypeEditor)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
PaintValue(Object, Graphics, Rectangle)

Zeichnet eine Darstellung des Werts des angegebenen Objekts in den angegebenen Bereich.Paints a representation of the value of the specified object to the specified canvas.

(Geerbt von UITypeEditor)
PaintValue(PaintValueEventArgs)

Zeichnet die Darstellung eines Objektwerts mit dem angegebenen PaintValueEventArgs.Paints a representation of the value of an object using the specified PaintValueEventArgs.

(Geerbt von UITypeEditor)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Geerbt von Object)

Gilt für:

Siehe auch