TextBoxBase.Text-Eigenschaft

Artikel
08/20/2007

Ruft den aktuellen Text im Textfeld ab oder legt diesen fest.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
<LocalizableAttribute(True)> _
Public Overrides Property Text As String
'Usage
Dim instance As TextBoxBase
Dim value As String

value = instance.Text

instance.Text = value

[LocalizableAttribute(true)] 
public override string Text { get; set; }

[LocalizableAttribute(true)] 
public:
virtual property String^ Text {
    String^ get () override;
    void set (String^ value) override;
}

/** @property */
public String get_Text ()

/** @property */
public void set_Text (String value)

public override function get Text () : String

public override function set Text (value : String)

Eigenschaftenwert

Der im Steuerelement angezeigte Text.

Hinweise

Um mehrere Textzeilen in einem Textfeld anzuzeigen, legen Sie die Multiline-Eigenschaft auf true fest. Um den Text eines mehrzeiligen Textfelds zu lesen oder festzulegen, verwenden Sie die Lines-Eigenschaft. Die Größe des Texts, der in das RichTextBox-Steuerelement eingegeben werden kann, wird nur durch den verfügbaren Arbeitsspeicher des Systems beschränkt.

Hinweis zu Windows 98, Windows Millennium Edition: Die Größe des Texts, der in der Text-Eigenschaft gespeichert werden kann, ist für das TextBox-Steuerelement auf 65 KB Arbeitsspeicher beschränkt.

Hinweis zu Windows NT 4.0, Windows 2000, Windows 2000 Professional, Windows 2000 Server, Windows 2000 Advanced Server, Windows XP Home Edition, Windows XP Professional x64 Edition, Windows Server 2003: Die Größe des Texts, der in der Text-Eigenschaft gespeichert werden kann, ist auf den verfügbaren Arbeitsspeicher des Systems beschränkt.

Beispiel

Im folgenden Codebeispiel wird mit der abgeleiteten Klasse TextBox ein mehrzeiliges TextBox-Steuerelement mit vertikalen Bildlaufleisten erstellt. In diesem Beispiel werden außerdem die Eigenschaften AcceptsTab, AcceptsReturn und WordWrap verwendet, damit das mehrzeilige Textfeld-Steuerelement zum Erstellen von Textdokumenten eingesetzt werden kann.

Public Sub CreateMyMultilineTextBox()
    ' Create an instance of a TextBox control.
    Dim textBox1 As New TextBox()
    
    ' Set the Multiline property to true.
    textBox1.Multiline = True
    ' Add vertical scroll bars to the TextBox control.
    textBox1.ScrollBars = ScrollBars.Vertical
    ' Allow the RETURN key in the TextBox control.
    textBox1.AcceptsReturn = True
    ' Allow the TAB key to be entered in the TextBox control.
    textBox1.AcceptsTab = True
    ' Set WordWrap to true to allow text to wrap to the next line.
    textBox1.WordWrap = True
    ' Set the default text of the control.
    textBox1.Text = "Welcome!" & Environment.NewLine & "Second Line"
End Sub

public void CreateMyMultilineTextBox()
 {
    // Create an instance of a TextBox control.
    TextBox textBox1 = new TextBox();
    
    // Set the Multiline property to true.
    textBox1.Multiline = true;
    // Add vertical scroll bars to the TextBox control.
    textBox1.ScrollBars = ScrollBars.Vertical;
    // Allow the RETURN key in the TextBox control.
    textBox1.AcceptsReturn = true;
    // Allow the TAB key to be entered in the TextBox control.
    textBox1.AcceptsTab = true;
    // Set WordWrap to true to allow text to wrap to the next line.
    textBox1.WordWrap = true;
    // Set the default text of the control.
    textBox1.Text = "Welcome!" + Environment.NewLine + "Second Line";
 }

public:
   void CreateMyMultilineTextBox()
   {
      // Create an instance of a TextBox control.
      TextBox^ textBox1 = gcnew TextBox;
      
      // Set the Multiline property to true.
      textBox1->Multiline = true;
      // Add vertical scroll bars to the TextBox control.
      textBox1->ScrollBars = ScrollBars::Vertical;
      // Allow the RETURN key in the TextBox control.
      textBox1->AcceptsReturn = true;
      // Allow the TAB key to be entered in the TextBox control.
      textBox1->AcceptsTab = true;
      // Set WordWrap to true to allow text to wrap to the next line.
      textBox1->WordWrap = true;
      // Set the default text of the control.
      textBox1->Text = "Welcome!" + Environment::NewLine + "Second Line";
   }

public void CreateMyMultilineTextBox()
{
    // Create an instance of a TextBox control.
    TextBox textBox1 = new TextBox();
    // Set the Multiline property to true.
    textBox1.set_Multiline(true);
    // Add vertical scroll bars to the TextBox control.
    textBox1.set_ScrollBars(ScrollBars.Vertical);
    // Allow the RETURN key in the TextBox control.
    textBox1.set_AcceptsReturn(true);
    // Allow the TAB key to be entered in the TextBox control.
    textBox1.set_AcceptsTab(true);
    // Set WordWrap to true to allow text to wrap to the next line.
    textBox1.set_WordWrap(true);
    // Set the default text of the control.
    textBox1.set_Text("Welcome!" + Environment.get_NewLine()
        + "Second Line");
} //CreateMyMultilineTextBox

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

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

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

TextBoxBase-Klasse
TextBoxBase-Member
System.Windows.Forms-Namespace
TextBoxBase.Lines-Eigenschaft
TextBoxBase.Multiline-Eigenschaft

Freigeben über