Auf Englisch lesen

Freigeben über


IEditableTextControl Schnittstelle

Definition

Stellt ein Steuerelement dar, das Text rendert, der vom Benutzer geändert werden kann.

public interface IEditableTextControl : System.Web.UI.ITextControl
Abgeleitet
Implementiert

Beispiele

Das folgende Codebeispiel zeigt eine Implementierung des Ereignisses TextChanged .


public partial class customeditablebox : System.Web.UI.UserControl, IEditableTextControl
{
    private static readonly object EventCustomTextChanged = new Object();

    public event EventHandler TextChanged
    {
        add
        {
            Events.AddHandler(EventCustomTextChanged, value);
        }
        remove
        {
            Events.RemoveHandler(EventCustomTextChanged, value);
        }
    }

    public string Text
    {
        get
        {
            // Provide implementation.
            return String.Empty;
        }
        set
        {
            // Provide implementation.
        }
    }
}

Hinweise

Steuerelemente wie TextBox und die, die von ListControlabgeleitet werden, stellen eine Texteigenschaft bereit, die von einem Seitenbenutzer geändert werden kann. Wenn die Texteigenschaft geändert wird, wird ein Ereignis ausgelöst, um Handler zu benachrichtigen, dass die Eigenschaft geändert wurde. Klassen, die implementieren IEditableTextControl , müssen das TextChanged -Ereignis definieren.

Obwohl die IEditableTextControl Schnittstelle nur das TextChanged -Ereignis enthält, erbt sie von der ITextControl -Schnittstelle, die eine Text -Eigenschaft definiert. Um die IEditableTextControl -Schnittstelle zu implementieren, muss ein -Steuerelement die Text -Eigenschaft und das -Ereignis definieren, das TextChanged auftritt, wenn die Text Eigenschaft zwischen Beiträgen zum Server geändert wird.

IEditableTextControl wird von TextBox und ListControlimplementiert. In diesen Klassen wird das -Ereignis durch die ListControl.OnTextChanged -Methode oder TextBox.OnTextChanged ausgelöst. Eine Klasse, die die IEditableTextControl -Schnittstelle implementiert, könnte eine ähnliche Methode zum Auslösen des Ereignisses definieren.

Eigenschaften

Text

Ruft den Textinhalt eines Steuerelements ab oder legt diesen fest.

(Geerbt von ITextControl)

Ereignisse

TextChanged

Tritt ein, wenn der Inhalt des Texts zwischen Übertragungen zum Server geändert wird.

Gilt für:

Produkt Versionen
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1