AutoCompleteType Enumeración

Referencia

Definición

Espacio de nombres:: System.Web.UI.WebControls

Ensamblado:: System.Web.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

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

public enum class AutoCompleteType

public enum AutoCompleteType

type AutoCompleteType =

Public Enum AutoCompleteType

Herencia: Object

ValueType

Enum
AutoCompleteType

Campos

BusinessCity	23	Ciudad para una categoría de dirección profesional.
BusinessCountryRegion	24	País o región para una categoría de dirección profesional.
BusinessFax	25	Número de fax para una categoría de dirección profesional.
BusinessPhone	26	Número de teléfono para una categoría de dirección profesional.
BusinessState	27	Estado o provincia para una categoría de dirección profesional.
BusinessStreetAddress	28	Calle para una categoría de dirección profesional.
BusinessUrl	29	Dirección URL para una categoría de sitio Web comercial.
BusinessZipCode	30	Código postal para una categoría de dirección profesional.
Cellular	2	Número de teléfono para una categoría de teléfono móvil.
Company	3	Nombre de una categoría profesional.
Department	4	Departamento en una categoría profesional.
Disabled	1	La característica AutoComplete está deshabilitada para el control TextBox.
DisplayName	5	Nombre que se va a mostrar para la categoría de usuario.
Email	6	Categoría de dirección de correo electrónico del usuario.
Enabled	32	La característica AutoComplete está habilitada para el control TextBox.
FirstName	7	Primera categoría de nombre.
Gender	8	Sexo de la categoría de usuario.
HomeCity	9	Ciudad para una categoría de dirección personal.
HomeCountryRegion	10	País o región para una categoría de dirección personal.
HomeFax	11	Número de fax para una categoría de dirección personal.
Homepage	16	Dirección URL para una categoría de sitio Web.
HomePhone	12	Número de teléfono para una categoría de dirección personal.
HomeState	13	Estado o provincia para una categoría de dirección personal.
HomeStreetAddress	14	Calle para una categoría de dirección personal.
HomeZipCode	15	Código postal para una categoría de dirección personal.
JobTitle	17	Categoría de puesto del usuario.
LastName	18	Última categoría de nombre.
MiddleName	19	Categoría de segundo nombre del usuario.
None	0	Ninguna categoría está asociada con el control TextBox. Todos los controles TextBox que tienen la misma propiedad ID comparten la misma lista de valores.
Notes	20	Cualquier información complementaria que se desee incluir en la categoría de formulario.
Office	21	Ubicación de la categoría de oficina profesional.
Pager	22	Número de teléfono para una categoría de paginación.
Search	31	Palabra o palabras clave con las que buscar una página Web o categoría de sitio Web.

Ejemplos

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

Importante

Este ejemplo tiene un cuadro de texto que acepta datos proporcionados por el usuario, lo que puede suponer una amenaza para la seguridad. De forma predeterminada, ASP.NET Web Pages valida que los datos proporcionados por el usuario no incluyen elementos HTML ni de script. Para más información, consulte Información general sobre los ataques mediante scripts.


<%@ 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>


<%@ Page Language="VB" %>
<!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>

Comentarios

Para ayudar con la entrada de datos, Internet Explorer 5 y versiones posteriores y otros exploradores admiten una característica denominada Autocompletar. AutoCompletar supervisa un cuadro de texto y almacena una lista de los valores especificados por el usuario. Cuando el usuario vuelve al cuadro de texto otra vez, se muestra la lista de valores. En lugar de volver a establecer un valor, el usuario simplemente puede seleccionar el valor de esta lista.

Nota

No todos los exploradores admiten la característica Autocompletar. Consulte con el explorador para determinar la compatibilidad.

Para controlar el comportamiento de la característica Autocompletar de un TextBox control, use la AutoCompleteType propiedad . La AutoCompleteType enumeración se usa para representar los valores que se pueden aplicar a la AutoCompleteType propiedad .

De forma predeterminada, la AutoCompleteType propiedad de un TextBox control se establece en AutoCompleteType.None. Con esta configuración, el TextBox control comparte la lista con otros TextBox controles con los mismos ID en distintas páginas. También puede compartir una lista entre TextBox los controles basados en una categoría en lugar de en función de .ID Al establecer la AutoCompleteType propiedad en uno de los valores de categoría (como AutoCompleteType.FirstName o AutoCompleteType.LastName), todos los TextBox controles con la misma categoría comparten la misma lista. Puede deshabilitar la característica Autocompletar para un TextBox control estableciendo la AutoCompleteType propiedad en AutoCompleteType.Disabled.

Consulte la documentación del explorador para obtener más información sobre cómo configurar y habilitar la característica Autocompletar. Por ejemplo, para habilitar la característica Autocompletar en Internet Explorer versión 5 o posterior, en el menú Herramientas , elija Opciones de Internet. A continuación, elija la pestaña Contenido . Elija el botón AutoCompletar para ver y modificar las opciones de la característica Autocompletar.

Se aplica a