IEditableTextControl Schnittstelle

Definition

Namespace:

System.Web.UI

Assembly:

System.Web.dll

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

public interface class IEditableTextControl : System::Web::UI::ITextControl

public interface IEditableTextControl : System.Web.UI.ITextControl

type IEditableTextControl = interface
    interface ITextControl

Public Interface IEditableTextControl
Implements ITextControl

Abgeleitet

System.Web.UI.WebControls.ListControl

System.Web.UI.WebControls.TextBox

Implementiert

ITextControl

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.
        }
    }
}

Public Class customeditablebox
    Inherits System.Web.UI.UserControl
    Implements System.Web.UI.IEditableTextControl

    Private Shared ReadOnly EventCustomTextChanged As New Object

    Public Custom Event TextChanged As EventHandler _
      Implements System.Web.UI.IEditableTextControl.TextChanged
        AddHandler(ByVal value As EventHandler)
            Events.AddHandler(EventCustomTextChanged, value)
        End AddHandler

        RemoveHandler(ByVal value As EventHandler)
            Events.RemoveHandler(EventCustomTextChanged, value)
        End RemoveHandler

        RaiseEvent(ByVal sender As Object, ByVal e As EventArgs)

        End RaiseEvent
    End Event

    Public Property Text() As String _
      Implements System.Web.UI.IEditableTextControl.Text
        Get
            ' Provide implementation.
            Return String.Empty
        End Get
        Set(ByVal value As String)
            ' Provide implementation.
        End Set
    End Property
End Class

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.