Esta documentación está archivada y no tiene mantenimiento.

Control.Text (Propiedad)

Obtiene o establece el texto asociado al control.

Espacio de nombres: System.Windows.Forms
Ensamblado: System.Windows.Forms (en system.windows.forms.dll)

[LocalizableAttribute(true)] 
[BindableAttribute(true)] 
public virtual string Text { get; set; }
/** @property */
public String get_Text ()

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

public function get Text () : String

public function set Text (value : String)

No aplicable.

Valor de propiedad

Texto asociado al control.

Cada clase derivada utiliza la propiedad Text del control de manera diferente. Por ejemplo, la propiedad Text de Form se muestra en la barra de título de la parte superior del formulario, el límite de caracteres es bastante pequeño y, normalmente, muestra el nombre de la aplicación o del documento. No obstante, la propiedad Text de RichTextBox puede ser grande y puede incluir numerosos caracteres no visuales que se utilizan para dar formato al texto. Por ejemplo, se puede dar formato al texto que se muestra en RichTextBox ajustando las propiedades Font o agregando caracteres de espacio o tabulación para alinear el texto.

Notas para los herederos: Cuando se reemplaza la propiedad Text en una clase derivada, hay que utilizar la propiedad Text de la clase base para extender la implementación base. Si no, deberá proporcionarse toda la implementación. No es necesario reemplazar ambos descriptores de acceso get y set de la propiedad Text; se puede reemplazar sólo uno, si es necesario.

En el ejemplo de código siguiente se crea un control GroupBox y se establecen algunas de sus propiedades comunes. En el ejemplo se crea un TextBox y se establece su propiedad Location dentro del cuadro de grupo. A continuación, se establece la propiedad Text del cuadro de grupo y se acopla el cuadro de grupo a la parte superior del formulario. Por último, se deshabilita el cuadro de grupo estableciendo la propiedad Enabled en false, con lo que todos los controles contenidos en el cuadro de grupo se deshabilitan.

// Add a GroupBox to a form and set some of its common properties.
private void AddMyGroupBox()
{
   // Create a GroupBox and add a TextBox to it.
   GroupBox groupBox1 = new GroupBox();
   TextBox textBox1 = new TextBox();
   textBox1.Location = new Point(15, 15);
   groupBox1.Controls.Add(textBox1);

   // Set the Text and Dock properties of the GroupBox.
   groupBox1.Text = "MyGroupBox";
   groupBox1.Dock = DockStyle.Top;

   // Disable the GroupBox (which disables all its child controls)
   groupBox1.Enabled = false;

   // Add the Groupbox to the form.
   this.Controls.Add(groupBox1);
}

// Add a GroupBox to a form and set some of its common properties.
private void AddMyGroupBox()
{
    // Create a GroupBox and add a TextBox to it.
    GroupBox groupBox1 = new GroupBox();
    TextBox textBox1 = new TextBox();
    textBox1.set_Location(new Point(15, 15));
    groupBox1.get_Controls().Add(textBox1);
    // Set the Text and Dock properties of the GroupBox.
    groupBox1.set_Text("MyGroupBox");
    groupBox1.set_Dock(DockStyle.Top);
    // Disable the GroupBox (which disables all its child controls)
    groupBox1.set_Enabled(false);
    // Add the Groupbox to the form.
    this.get_Controls().Add(groupBox1);
} //AddMyGroupBox

Windows 98, Windows 2000 Service Pack 4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter

Microsoft .NET Framework 3.0 es compatible con Windows Vista, Microsoft Windows XP SP2 y Windows Server 2003 SP1.

.NET Framework

Compatible con: 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Compatible con: 2.0, 1.0
Mostrar: