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 TextChanged Ereignisses.

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 z TextBox . B. diejenigen, die von ListControldieser abgeleitet 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 TextChanged das Ereignis implementierenIEditableTextControl, müssen das 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 TextChanged Ereignis definieren, das auftritt, wenn die Text Eigenschaft zwischen Beiträgen auf dem Server wechselt.

IEditableTextControl wird von TextBox und ListControl. In diesen Klassen wird das Ereignis über die ListControl.OnTextChanged Methoden oder TextBox.OnTextChanged Methoden ausgelöst. Eine Klasse, die die IEditableTextControl Schnittstelle implementiert, kann eine ähnliche Methode zum Auslösen des Ereignisses definieren.

Eigenschaften

Name	Beschreibung
Text	Dient zum Abrufen oder Festlegen des Textinhalts eines Steuerelements. (Geerbt von ITextControl)

Ereignisse

Name	Beschreibung
TextChanged	Tritt auf, wenn sich der Inhalt des Texts zwischen Beiträgen auf dem Server ändert.