(0) exportieren Drucken
Alle erweitern
Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen
Übersetzung
Original

XmlDataFileEditor-Klasse

Stellt eine Entwurfszeit-Benutzeroberfläche für das Auswählen einer XML-Datendatei bereit.

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

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

Der XmlDataFileEditor-Typ macht die folgenden Member verfügbar.

  NameBeschreibung
Öffentliche MethodeXmlDataFileEditorInitialisiert eine neue Instanz der XmlDataFileEditor-Klasse.
Zum Seitenanfang

  NameBeschreibung
Geschützte EigenschaftCaptionRuft die für das Auswahldialogfeld anzuzeigende Beschriftung ab. (Überschreibt UrlEditor.Caption.)
Geschützte EigenschaftFilterRuft die URL-Filteroptionen für den Editor ab, die zum Filtern der Elemente im URL-Auswahldialogfeld verwendet werden. (Überschreibt UrlEditor.Filter.)
Öffentliche EigenschaftIsDropDownResizableRuft einen Wert ab, der angibt, ob Dropdowneditoren von den Benutzern in der Größe veränderbar sein sollten. (Von UITypeEditor geerbt.)
Geschützte EigenschaftOptionsRuft die Optionen ab, die der URL-Generator verwenden soll. (Von UrlEditor geerbt.)
Zum Seitenanfang

  NameBeschreibung
Öffentliche MethodeEditValue(IServiceProvider, Object)Bearbeitet den Wert des angegebenen Objekts, wobei der von der GetEditStyle-Methode angegebene Editor-Stil verwendet wird. (Von UITypeEditor geerbt.)
Öffentliche MethodeEditValue(ITypeDescriptorContext, IServiceProvider, Object)Bearbeitet den Wert des angegebenen Objekts, wobei der von der GetEditStyle-Methode angegebene Editor-Stil verwendet wird. (Von UrlEditor geerbt.)
Öffentliche MethodeEquals(Object)Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist. (Von Object geerbt.)
Geschützte MethodeFinalize Gibt einem Objekt Gelegenheit, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der Garbage Collection freigegeben wird. (Von Object geerbt.)
Öffentliche MethodeGetEditStyle()Ruft den Editor-Stil ab, der von der EditValue-Methode verwendet wird. (Von UITypeEditor geerbt.)
Öffentliche MethodeGetEditStyle(ITypeDescriptorContext)Ruft den Bearbeitungsstil der EditValue-Methode ab. (Von UrlEditor geerbt.)
Öffentliche MethodeGetHashCodeFungiert als die Standardhashfunktion. (Von Object geerbt.)
Öffentliche MethodeGetPaintValueSupported()Gibt an, ob dieser Editor das Zeichnen einer Objektwertdarstellung unterstützt. (Von UITypeEditor geerbt.)
Öffentliche MethodeGetPaintValueSupported(ITypeDescriptorContext)Gibt an, ob der angegebene Kontext das Zeichnen einer Objektwertdarstellung innerhalb des angegebenen Kontexts unterstützt. (Von UITypeEditor geerbt.)
Öffentliche MethodeGetTypeRuft den Type der aktuellen Instanz ab. (Von Object geerbt.)
Geschützte MethodeMemberwiseCloneErstellt eine flache Kopie des aktuellen Object. (Von Object geerbt.)
Öffentliche MethodePaintValue(PaintValueEventArgs)Zeichnet die Darstellung eines Objektwerts mit dem angegebenen PaintValueEventArgs. (Von UITypeEditor geerbt.)
Öffentliche MethodePaintValue(Object, Graphics, Rectangle)Zeichnet eine Darstellung des Werts des angegebenen Objekts in den angegebenen Bereich. (Von UITypeEditor geerbt.)
Öffentliche MethodeToStringGibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Von Object geerbt.)
Zum Seitenanfang

Mit einem XmlDataFileEditor-Objekt können Sie zur Entwurfszeit eine URL für eine XML-Datendatei (.xml) auswählen und bearbeiten und diesen dann einer Steuerelementeigenschaft zuordnen. Zum Beispiel verwendet das XmlDataSource-Steuerelement die XmlDataFileEditor-Klasse zur Entwurfszeit, um den Wert der DataFile-Eigenschaft festzulegen.

Verwenden Sie das EditorAttribute-Attribut, um einer Eigenschaft den XmlDataFileEditor zuzuordnen. Wenn die zugeordnete Eigenschaft auf der Entwurfsoberfläche bearbeitet wird, ruft der Designerhost die EditValue-Methode auf. Die EditValue-Methode verwendet die BuildUrl-Methode, die eine Benutzeroberfläche zum Auswählen der URL anzeigt, und gibt die URL zurück, die vom Benutzer ausgewählt wurde. Die GetEditStyle-Methode gibt den Anzeigestil der Benutzeroberfläche an.

Leiten Sie eine Klasse vom XmlDataFileEditor ab, um einen benutzerdefinierten Editor für eine XML-Dateneigenschaft zu definieren. Eine abgeleitete Klasse kann z. B. die EditValue-Methode überschreiben und dann die BuildUrl-Methode mit einem benutzerdefinierten Filter-Wert oder Caption-Wert aufrufen.

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


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

Unterstützt in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Community-Beiträge

HINZUFÜGEN
Anzeigen:
© 2014 Microsoft