AutoCompleteType Wyliczenie
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Reprezentuje wartości kontrolujące zachowanie funkcji Autouzupełnianie w kontrolce TextBox .
public enum class AutoCompleteType
public enum AutoCompleteType
type AutoCompleteType =
Public Enum AutoCompleteType
- Dziedziczenie
Pola
BusinessCity | 23 | Miasto kategorii adresów biznesowych. |
BusinessCountryRegion | 24 | Kraj/region kategorii adresów biznesowych. |
BusinessFax | 25 | Numer faksu dla kategorii adresów służbowych. |
BusinessPhone | 26 | Numer telefonu kategorii adresu biznesowego. |
BusinessState | 27 | Stan kategorii adresów biznesowych. |
BusinessStreetAddress | 28 | Ulica kategorii adresów biznesowych. |
BusinessUrl | 29 | Adres URL do kategorii firmowej witryny sieci Web. |
BusinessZipCode | 30 | Kod pocztowy kategorii adresów biznesowych. |
Cellular | 2 | Numer telefonu w kategorii telefon komórkowy. |
Company | 3 | Nazwa kategorii biznesowej. |
Department | 4 | Dział w kategorii biznesowej. |
Disabled | 1 | Funkcja autouzupełniania jest wyłączona dla kontrolki TextBox . |
DisplayName | 5 | Nazwa wyświetlana dla kategorii użytkownika. |
6 | Kategoria adresów e-mail użytkownika. |
|
Enabled | 32 | Funkcja Autouzupełnianie jest włączona dla kontrolki TextBox . |
FirstName | 7 | Kategoria imienia. |
Gender | 8 | Płeć kategorii użytkownika. |
HomeCity | 9 | Miasto kategorii adresów domowych. |
HomeCountryRegion | 10 | Kraj/region kategorii adresów domowych. |
HomeFax | 11 | Numer faksu kategorii adresów domowych. |
Homepage | 16 | Adres URL kategorii witryny sieci Web. |
HomePhone | 12 | Numer telefonu kategorii adresów domowych. |
HomeState | 13 | Stan kategorii adresów domowych. |
HomeStreetAddress | 14 | Ulica kategorii adresów domowych. |
HomeZipCode | 15 | Kod pocztowy kategorii adresów domowych. |
JobTitle | 17 | Kategoria stanowiska użytkownika. |
LastName | 18 | Kategoria nazwisko. |
MiddleName | 19 | Kategoria nazwy środkowej użytkownika. |
None | 0 | Żadna kategoria nie jest skojarzona z kontrolką TextBox . Wszystkie TextBox kontrolki z tym samym udziałem tej samej ID listy wartości. |
Notes | 20 | Wszelkie informacje uzupełniające do uwzględnienia w kategorii formularzy. |
Office | 21 | Lokalizacja kategorii biura biznesowego. |
Pager | 22 | Numer telefonu kategorii pager. |
Search | 31 | Słowo kluczowe lub słowa kluczowe, za pomocą którego ma być wyszukiwana strona sieci Web lub kategoria witryny sieci Web. |
Przykłady
W poniższym przykładzie pokazano, jak za pomocą AutoCompleteType wyliczenia określić kategorię Autouzupełnianie dla kontrolki TextBox .
Ważne
Ten przykład zawiera pole tekstowe, które akceptuje dane wejściowe użytkownika, co jest potencjalnym zagrożeniem bezpieczeństwa. Domyślnie ASP.NET strony sieci Web sprawdzają, czy dane wejściowe użytkownika nie zawierają skryptów ani elementów HTML. Aby uzyskać więcej informacji, zobacz Script Exploits Overview (Omówienie luk w zabezpieczeniach skryptów).
<%@ 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>
Uwagi
Aby ułatwić wprowadzanie danych, program Internet Explorer 5 lub nowszy oraz inne przeglądarki obsługują funkcję o nazwie Autouzupełnianie. Funkcja Autouzupełnianie monitoruje pole tekstowe i przechowuje listę wartości wprowadzonych przez użytkownika. Gdy użytkownik wróci do pola tekstowego innym razem, zostanie wyświetlona lista wartości. Zamiast ponownie wpisywać wartość, użytkownik może po prostu wybrać wartość z tej listy.
Uwaga
Nie wszystkie przeglądarki obsługują funkcję autouzupełniania. Sprawdź w przeglądarce, aby określić zgodność.
Aby kontrolować zachowanie funkcji Autouzupełnianie dla TextBox kontrolki, należy użyć AutoCompleteType właściwości . Wyliczenie AutoCompleteType służy do reprezentowania wartości, które można zastosować do AutoCompleteType właściwości .
Domyślnie AutoCompleteType właściwość kontrolki jest ustawiona TextBox na AutoCompleteType.None
wartość . Dzięki temu ustawieniu kontrolka TextBox udostępnia listę innym TextBox kontrolkom z tymi samymi ID na różnych stronach. Możesz również udostępnić listę między TextBox kontrolkami w oparciu o kategorię zamiast na podstawie elementu ID. Po ustawieniu AutoCompleteType właściwości na jedną z wartości kategorii (takich jak AutoCompleteType.FirstName
lub AutoCompleteType.LastName
) wszystkie TextBox kontrolki z tą samą kategorią mają ten sam udział na tej samej liście. Funkcję TextBox Autouzupełniania dla kontrolki można wyłączyć, ustawiając AutoCompleteType właściwość na AutoCompleteType.Disabled
.
Zapoznaj się z dokumentacją przeglądarki, aby uzyskać szczegółowe informacje na temat konfigurowania i włączania funkcji autouzupełniania. Aby na przykład włączyć funkcję Autouzupełnianie w programie Internet Explorer w wersji 5 lub nowszej, w menu Narzędzia wybierz pozycję Opcje internetowe. Następnie wybierz kartę Zawartość . Wybierz przycisk Autouzupełnianie , aby wyświetlić i zmodyfikować opcje funkcji Autouzupełnianie.