Compartir vía


AutoCompleteType Enumeración

Definición

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

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

Consulte también