Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

XmlDataFileEditor-Klasse

 

Veröffentlicht: Oktober 2016

Stellt eine Entwurfszeit-Benutzeroberfläche für die Auswahl einer XML-Datendatei.

Namespace:   System.Web.UI.Design
Assembly:  System.Design (in System.Design.dll)

System.Object
  System.Drawing.Design.UITypeEditor
    System.Web.UI.Design.UrlEditor
      System.Web.UI.Design.XmlDataFileEditor

[SecurityPermissionAttribute(SecurityAction.Demand, Flags = SecurityPermissionFlag.UnmanagedCode)]
public class XmlDataFileEditor : UrlEditor

NameBeschreibung
System_CAPS_pubmethodXmlDataFileEditor()

Initialisiert eine neue Instanz der XmlDataFileEditor-Klasse.

NameBeschreibung
System_CAPS_protpropertyCaption

Ruft die für das Auswahldialogfeld anzuzeigende Beschriftung ab.(Überschreibt UrlEditor.Caption.)

System_CAPS_protpropertyFilter

Ruft die URL-Filteroptionen für den Editor, die verwendet wird, zum Filtern der Elemente, die in das URL-Auswahldialogfeld angezeigt werden.(Überschreibt UrlEditor.Filter.)

System_CAPS_pubpropertyIsDropDownResizable

Ruft einen Wert ab, der angibt, ob Dropdowneditoren von den Benutzern in der Größe veränderbar sein sollten.(Geerbt von „UITypeEditor“.)

System_CAPS_protpropertyOptions

Ruft die Optionen für die URL-Generator verwenden.(Geerbt von „UrlEditor“.)

NameBeschreibung
System_CAPS_pubmethodEditValue(IServiceProvider, Object)

Bearbeitet den Wert des angegebenen Objekts, wobei der von der GetEditStyle-Methode angegebene Editor-Stil verwendet wird.(Geerbt von „UITypeEditor“.)

System_CAPS_pubmethodEditValue(ITypeDescriptorContext, IServiceProvider, Object)

Bearbeitet den Wert des angegebenen Objekts, wobei der Editor-Stil durch die GetEditStyle Methode.(Geerbt von „UrlEditor“.)

System_CAPS_pubmethodEquals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.(Geerbt von „Object“.)

System_CAPS_protmethodFinalize()

Gibt einem Objekt Gelegenheit, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der Garbage Collection freigegeben wird. (Geerbt von „Object“.)

System_CAPS_pubmethodGetEditStyle()

Ruft den von der EditValue-Methode verwendeten Editor-Stil ab.(Geerbt von „UITypeEditor“.)

System_CAPS_pubmethodGetEditStyle(ITypeDescriptorContext)

Ruft den Stil bearbeiten, der die EditValue Methode.(Geerbt von „UrlEditor“.)

System_CAPS_pubmethodGetHashCode()

Fungiert als die Standardhashfunktion.(Geerbt von „Object“.)

System_CAPS_pubmethodGetPaintValueSupported()

Gibt an, ob dieser Editor das Zeichnen einer Objektwertdarstellung unterstützt.(Geerbt von „UITypeEditor“.)

System_CAPS_pubmethodGetPaintValueSupported(ITypeDescriptorContext)

Gibt an, ob der angegebene Kontext das Zeichnen einer Objektwertdarstellung innerhalb des angegebenen Kontexts unterstützt.(Geerbt von „UITypeEditor“.)

System_CAPS_pubmethodGetType()

Ruft den Type der aktuellen Instanz ab.(Geerbt von „Object“.)

System_CAPS_protmethodMemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.(Geerbt von „Object“.)

System_CAPS_pubmethodPaintValue(Object, Graphics, Rectangle)

Zeichnet eine Darstellung des Werts des angegebenen Objekts in den angegebenen Bereich.(Geerbt von „UITypeEditor“.)

System_CAPS_pubmethodPaintValue(PaintValueEventArgs)

Zeichnet die Darstellung eines Objektwerts mit dem angegebenen PaintValueEventArgs.(Geerbt von „UITypeEditor“.)

System_CAPS_pubmethodToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.(Geerbt von „Object“.)

Ein XmlDataFileEditor Objekt dient zur Entwurfszeit auswählen und bearbeiten eine URL für eine XML-Datendatei (XML) und dann einer Steuerelementeigenschaft zuordnen. Z. B. die XmlDataSource -Steuerelement verwendet die XmlDataFileEditor Klasse zur Entwurfszeit zum Festlegen des Werts, der die DataFile Eigenschaft.

Verwenden der EditorAttribute Attribut zum Zuordnen der XmlDataFileEditor mit einer Eigenschaft. Wenn die zugeordnete Eigenschaft auf der Entwurfsoberfläche bearbeitet wird, ruft der Designerhost die EditValue Methode. Die EditValue -Methode verwendet die BuildUrl -Methode, die wiederum eine Benutzeroberfläche zum Auswählen der URL anzeigt, und gibt anschließend die URL, die vom Benutzer ausgewählt wird. Die GetEditStyle -Methode gibt den Anzeigestil der Benutzeroberfläche an.

Leiten Sie eine Klasse von der XmlDataFileEditor um einen benutzerdefinierten Editor für eine XML-Dateneigenschaft zu definieren. Beispielsweise kann eine abgeleitete Klasse überschreiben die EditValue -Methode, und rufen Sie dann die BuildUrl Methode mit einem benutzerdefinierten Filter oder Caption Wert.

Im folgenden Codebeispiel wird veranschaulicht, wie eine Instanz zuordnen der XmlDataFileEditor Klasse mit einer Eigenschaft, die in einem benutzerdefinierten Steuerelement enthalten ist. Wenn die Steuerelementeigenschaft auf der Entwurfsoberfläche bearbeitet wird die XmlDataFileEditor -Klasse stellt die Benutzeroberfläche zum auswählen und Bearbeiten eines XML-Dateinamens für den Eigenschaftswert.

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 = "";
                }
            }
        }
    }

}

.NET Framework
Verfügbar seit 2.0

Alle öffentlichen statischen Member ( Shared in Visual Basic) dieses Typs sind threadsicher. Die Threadsicherheit für Instanzmember ist nicht garantiert.

Zurück zum Anfang
Anzeigen: