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

AutoCompleteType (Enumeración)

Actualización: noviembre 2007

Representa los valores que controlan el comportamiento de la característica Autocompletar en un control TextBox.

Espacio de nombres:  System.Web.UI.WebControls
Ensamblado:  System.Web (en System.Web.dll)

public enum AutoCompleteType
public enum AutoCompleteType
public enum AutoCompleteType

Nombre de miembroDescripción
NoneNinguna categoría está asociada con el control TextBox. Todos los controles TextBox que tienen la misma propiedad ID comparten la misma lista de valores.
DisabledLa característica Autocompletar está deshabilitada para el control TextBox.
CellularNúmero de teléfono para una categoría de teléfono móvil.
CompanyNombre de una categoría profesional.
DepartmentDepartamento en una categoría profesional.
DisplayNameNombre que se va a mostrar para la categoría de usuario.
EmailCategoría de dirección de correo electrónico del usuario.
FirstNameNombre de la categoría de usuario.
GenderSexo de la categoría de usuario.
HomeCityCiudad para una categoría de dirección personal.
HomeCountryRegionPaís o región para una categoría de dirección personal.
HomeFaxNúmero de fax para una categoría de dirección personal.
HomePhoneNúmero de teléfono para una categoría de dirección personal.
HomeStateEstado o provincia para una categoría de dirección personal.
HomeStreetAddressCalle para una categoría de dirección personal.
HomeZipCodeCódigo postal para una categoría de dirección personal.
HomepageDirección URL para una categoría de sitio Web.
JobTitleCategoría de puesto del usuario.
LastNameCategoría de apellido del usuario.
MiddleNameCategoría de segundo nombre del usuario.
NotesCualquier información complementaria que se desee incluir en la categoría de formulario.
OfficeUbicación de la categoría de oficina profesional.
PagerNúmero de teléfono para una categoría de localizador (pager).
BusinessCityCiudad para una categoría de dirección profesional.
BusinessCountryRegionPaís o región para una categoría de dirección profesional.
BusinessFaxNúmero de fax para una categoría de dirección profesional.
BusinessPhoneNúmero de teléfono para una categoría de dirección profesional.
BusinessStateEstado o provincia para una categoría de dirección profesional.
BusinessStreetAddressCalle para una categoría de dirección profesional.
BusinessUrlDirección URL para una categoría de sitio Web comercial.
BusinessZipCodeCódigo postal para una categoría de dirección profesional.
SearchPalabra o palabras clave con las que buscar una página Web o categoría de sitio Web.

Para ayudar con la entrada de datos, Internet Explorer 5 y posteriores y otros exploradores proporcionan soporte técnico para una característica denominada Autocompletar. Autocompletar supervisa los cuadros de texto y crea una lista de valores escritos por el usuario. Cuando el usuario vuelve a un cuadro de texto determinado en un momento posterior, se muestra la lista. En lugar de volver a escribir un valor escrito anteriormente, el usuario sólo tiene que seleccionar el valor en esta lista. Para controlar el comportamiento de la característica Autocompletar en un control TextBox, se utiliza la propiedad AutoCompleteType. La enumeración AutoCompleteType se utiliza para representar los valores que pueden aplicarse a la propiedad AutoCompleteType.

sk2a996b.alert_note(es-es,VS.90).gifNota:

No todos los exploradores admiten la característica Autocompletar. Compruebe si su explorador es compatible con esta característica.

De manera predeterminada, la propiedad AutoCompleteType del control TextBox está establecida en AutoCompleteType.None. Con esta configuración, el control TextBox comparte la lista con otros controles TextBox que tengan establecida la misma propiedad ID entre páginas diferentes. También se puede compartir una lista entre controles TextBox basándose en una categoría, en lugar de basarse en su propiedad ID. Cuando establece la propiedad AutoCompleteType en uno de los valores de categoría (como AutoCompleteType.FirstName, AutoCompleteType.LastName, etc.), todos los TextBox controles con la misma categoría comparten la misma lista. Puede deshabilitar la característica Autocompletar para un control TextBox estableciendo la propiedad AutoCompleteType en AutoCompleteType.Disabled.

Consulte la documentación del explorador para obtener información detallada sobre la configuración y activación de la característica Autocompletar. Por ejemplo, para habilitar la característica Autocompletar en la versión 5 o posteriores de Internet Explorer, seleccione Opciones de Internet en el menú Herramientas; a continuación, seleccione la ficha Contenido. Haga clic el botón Autocompletar para ver y modificar las distintas opciones de explorador para la característica Autocompletar.

Para obtener más información sobre la característica Autocompletar en Internet Explorer, busque el tema Usar Autocompletar en formularios HTML en MSDN Library en la dirección http://msdn2.microsoft.com/es-es/library.

En el ejemplo siguiente se muestra cómo utilizar la enumeración AutoCompleteType para especificar la categoría Autocompletar en un control TextBox.

sk2a996b.alert_security(es-es,VS.90).gifNota de seguridad:

Este ejemplo tiene un cuadro de texto que acepta datos del usuario, lo que puede suponer una amenaza para la seguridad. De forma predeterminada, las páginas Web ASP.NET validan que los datos proporcionados por el usuario no incluyen elementos HTML ni de secuencia de comandos. Para obtener más información, vea Información general sobre los ataques mediante secuencias de comandos.


<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>AutoCompleteType example</title>
</head>
<body>
    <form id="form1" runat="server">

      <!-- You need to enable the AutoComplete feature on -->
      <!-- a browser that supports it (such as Internet   -->
      <!-- Explorer 5.0 and later) for this sample to     -->
      <!-- work. The AutoComplete lists are created after -->
      <!-- the Submit button is clicked.                  -->

      <h3>AutoCompleteType example</h3>

      Enter values in the text boxes and click the Submit <br/>
      button. <br/><br/> 

      <!-- The following TextBox controls have different  -->
      <!-- categories assigned to their AutoCompleteType  -->
      <!-- properties.                                    -->
      First Name:<br/>
      <asp:textbox id="FirstNameTextBox"
        autocompletetype="FirstName" 
        runat="server"/>
      <br/>

      Last Name:<br/>   
      <asp:textbox id="LastNameTextBox"
        autocompletetype="LastName" 
        runat="server"/>
      <br/>

      Email:<br/>   
      <asp:textbox id="EmailTextBox"
        autocompletetype="Email" 
        runat="server"/>
      <br/>

      <!-- The following TextBox controls have the same   -->
      <!-- categories assigned to their AutoCompleteType  -->
      <!-- properties. They share the same AutoComplete   -->
      <!-- list.                                          -->
      Phone Line #1:<br/>
      <asp:textbox id="Phone1TextBox"
        autocompletetype="HomePhone" 
        runat="server"/>
      <br/>

      Phone Line #2:<br/>
      <asp:textbox id="Phone2TextBox"
        autocompletetype="HomePhone" 
        runat="server"/>
      <br/>


      <!-- The following TextBox control has its          -->
      <!-- AutoCompleteType property set to               -->
      <!-- AutoCompleteType.None. All TextBox controls    -->
      <!-- with the same ID across different pages share  -->
      <!-- the same AutoComplete list.                    -->
      Category:<br/>   
      <asp:textbox id="CategoryTextBox"
        autocompletetype="None" 
        runat="server"/>
      <br/>

      <!-- The following TextBox control has the          -->
      <!-- AutoComplete feature disabled.                 -->
      Comments:<br/>   
      <asp:textbox id="CommentsTextBox"
        autocompletetype="Disabled" 
        runat="server"/>
      <br/>
      <br/><br/>  

      <asp:button id="SubmitButton"
        text="Submit"
        runat="Server"/>

    </form>
  </body>
</html>



Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

.NET Framework

Compatible con: 3.5, 3.0, 2.0
Mostrar: