Localize Klasa
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.
Rezerwuje lokalizację na stronie sieci Web, w której ma być wyświetlany zlokalizowany tekst statyczny.
public ref class Localize : System::Web::UI::WebControls::Literal[System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.Localize))]
public class Localize : System.Web.UI.WebControls.Literal[<System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.Localize))>]
type Localize = class
inherit LiteralPublic Class Localize
Inherits Literal- Dziedziczenie
- Atrybuty
Przykłady
W poniższym przykładzie kodu pokazano, jak używać kontrolki do wyświetlania Localize tekstu statycznego.
Uwaga
W poniższym przykładzie kodu użyto modelu kodu z jednym plikiem i może nie działać poprawnie, jeśli skopiowano bezpośrednio do pliku za pomocą kodu. Ten przykładowy kod musi zostać skopiowany do pustego pliku tekstowego z rozszerzeniem aspx. Aby uzyskać więcej informacji na temat modelu kodu Web Forms, zobacz ASP.NET Web Forms Page Code Model (Model kodu strony ASP.NET Web Forms).
<%@ Page Language="C#" AutoEventWireup="True" %>
<!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>
<title>Localize Example</title>
<script runat="server">
void ButtonClick(Object sender, EventArgs e)
{
Localize1.Text="Welcome to ASP.NET!! This is localized text.";
}
</script>
</head>
<body>
<form id="Form1" runat="server">
<h3>Localize Example</h3>
<asp:Localize id="Localize1"
Text="Hello World!!"
runat="server"/>
<br /><br />
<asp:Button id="Button1"
Text="Change Localize Text"
OnClick="ButtonClick"
runat="server"/>
</form>
</body>
</html>
<%@ Page Language="VB" AutoEventWireup="True" %>
<!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>
<title>Localize Example</title>
<script runat="server">
Sub ButtonClick(ByVal sender As [Object], ByVal e As EventArgs)
Localize1.Text = "Welcome to ASP.NET!! This is localized text."
End Sub 'ButtonClick
</script>
</head>
<body>
<form id="Form1" runat="server">
<h3>Localize Example</h3>
<asp:Localize id="Localize1"
Text="Hello World!!"
runat="server"/>
<br /><br />
<asp:Button id="Button1"
Text="Change Localize Text"
OnClick="ButtonClick"
runat="server"/>
</form>
</body>
</html>
Uwagi
W tym temacie:
Wprowadzenie
Użyj kontrolki Localize , aby zarezerwować lokalizację na stronie sieci Web, w której ma być wyświetlany zlokalizowany tekst.
Uwaga
Kontrolki spoza body elementu są ignorowane.
Kontrolka Localize dziedziczy po kontrolce Literal i jest taka sama w każdy sposób. Kontrolka Localize jest używana w czasie projektowania w celu odróżnienia tekstu statycznego, który można lokalizować z innego tekstu statycznego. Mimo że kontrolka Label umożliwia zastosowanie stylu do wyświetlanego tekstu, kontrolka Localize nie. Możesz programowo zarządzać tekstem wyświetlanym w kontrolce, ustawiając Literal.Text właściwość dziedziczonej z kontrolki Literal .
Przestroga
Ta kontrolka może służyć do wyświetlania danych wejściowych użytkownika, które mogą obejmować złośliwy skrypt klienta. Przed wyświetleniem w aplikacji sprawdź informacje wysyłane z klienta pod kątem skryptu wykonywalnego, instrukcji SQL lub innego kodu. ASP.NET udostępnia funkcję weryfikacji żądania wejściowego w celu blokowania skryptu i kodu HTML w danych wejściowych użytkownika. Kontrolki serwera sprawdzania poprawności są również udostępniane w celu oceny danych wejściowych użytkownika. Aby uzyskać więcej informacji, zobacz Securing Standard Controls (Zabezpieczanie standardowych kontrolek), How to: Protect Against Script Exploits in a Web Application by Applying HTML Encoding to Strings (Zabezpieczanie standardowych kontrolek), How to: Protect Against Script Exploits in a Web Pages (Zabezpieczanie standardowych kontrolek: ochrona przed programami wykorzystującymi luki w zabezpieczeniach skryptów w aplikacji internetowej przez zastosowanie kodowania HTML do ciągów) i Weryfikowanie danych wejściowych użytkownika na stronach sieci Web ASP.NET.
Składnia deklaracyjna
<asp:Localize
EnableTheming="True|False"
EnableViewState="True|False"
ID="string"
Mode="Transform|PassThrough|Encode"
OnDataBinding="DataBinding event handler"
OnDisposed="Disposed event handler"
OnInit="Init event handler"
OnLoad="Load event handler"
OnPreRender="PreRender event handler"
OnUnload="Unload event handler"
runat="server"
SkinID="string"
Text="string"
Visible="True|False"
/>
Konstruktory
| Localize() |
Inicjuje nowe wystąpienie klasy Localize. |
Właściwości
| Adapter |
Pobiera kartę specyficzną dla przeglądarki dla kontrolki. (Odziedziczone po Control) |
| AppRelativeTemplateSourceDirectory |
Pobiera lub ustawia względny katalog Page wirtualny aplikacji obiektu lub UserControl , który zawiera tę kontrolkę. (Odziedziczone po Control) |
| BindingContainer |
Pobiera kontrolkę zawierającą powiązanie danych tego formantu. (Odziedziczone po Control) |
| ChildControlsCreated |
Pobiera wartość wskazującą, czy kontrolki podrzędne kontrolki serwera zostały utworzone. (Odziedziczone po Control) |
| ClientID |
Pobiera identyfikator kontrolki dla znaczników HTML generowanych przez ASP.NET. (Odziedziczone po Control) |
| ClientIDMode |
Pobiera lub ustawia algorytm używany do generowania ClientID wartości właściwości. (Odziedziczone po Control) |
| ClientIDSeparator |
Pobiera wartość znaku reprezentującą znak separatora ClientID używany we właściwości . (Odziedziczone po Control) |
| Context |
HttpContext Pobiera obiekt skojarzony z kontrolką serwera dla bieżącego żądania sieci Web. (Odziedziczone po Control) |
| Controls |
ControlCollection Pobiera obiekt reprezentujący kontrolki podrzędne dla określonej kontrolki serwera w hierarchii interfejsu użytkownika. (Odziedziczone po Control) |
| DataItemContainer |
Pobiera odwołanie do kontenera nazewnictwa, jeśli kontener nazewnictwa implementuje IDataItemContainerelement . (Odziedziczone po Control) |
| DataKeysContainer |
Pobiera odwołanie do kontenera nazewnictwa, jeśli kontener nazewnictwa implementuje IDataKeysControlelement . (Odziedziczone po Control) |
| DesignMode |
Pobiera wartość wskazującą, czy kontrolka jest używana na powierzchni projektowej. (Odziedziczone po Control) |
| EnableTheming |
Pobiera lub ustawia wartość wskazującą, czy motywy mają zastosowanie do tej kontrolki. (Odziedziczone po Control) |
| EnableViewState |
Pobiera lub ustawia wartość wskazującą, czy kontrolka serwera utrzymuje stan widoku oraz stan widoku wszystkich kontrolek podrzędnych, które zawiera, do klienta wysyłającego żądanie. (Odziedziczone po Control) |
| Events |
Pobiera listę delegatów programu obsługi zdarzeń dla kontrolki. Ta właściwość jest tylko do odczytu. (Odziedziczone po Control) |
| HasChildViewState |
Pobiera wartość wskazującą, czy kontrolki podrzędne bieżącego formantu serwera mają zapisane ustawienia stanu widoku. (Odziedziczone po Control) |
| ID |
Pobiera lub ustawia identyfikator programowy przypisany do kontrolki serwera. (Odziedziczone po Control) |
| IdSeparator |
Pobiera znak używany do oddzielania identyfikatorów kontrolek. (Odziedziczone po Control) |
| IsChildControlStateCleared |
Pobiera wartość wskazującą, czy kontrolki zawarte w tej kontrolce mają stan kontroli. (Odziedziczone po Control) |
| IsTrackingViewState |
Pobiera wartość wskazującą, czy kontrolka serwera zapisuje zmiany w stanie widoku. (Odziedziczone po Control) |
| IsViewStateEnabled |
Pobiera wartość wskazującą, czy dla tej kontrolki jest włączony stan widoku. (Odziedziczone po Control) |
| LoadViewStateByID |
Pobiera wartość wskazującą, czy kontrolka uczestniczy w ładowaniu stanu widoku przez ID zamiast indeksu. (Odziedziczone po Control) |
| Mode |
Pobiera lub ustawia wartość wyliczenia, która określa sposób renderowania zawartości w kontrolce Literal . (Odziedziczone po Literal) |
| NamingContainer |
Pobiera odwołanie do kontenera nazewnictwa kontrolki serwera, który tworzy unikatową przestrzeń nazw do rozróżniania między kontrolkami serwera o tej samej ID wartości właściwości. (Odziedziczone po Control) |
| Page |
Pobiera odwołanie do Page wystąpienia, które zawiera kontrolkę serwera. (Odziedziczone po Control) |
| Parent |
Pobiera odwołanie do kontrolki nadrzędnej kontrolki serwera w hierarchii sterowania stronami. (Odziedziczone po Control) |
| RenderingCompatibility |
Pobiera wartość określającą wersję ASP.NET, z którą renderowany kod HTML będzie zgodny. (Odziedziczone po Control) |
| Site |
Pobiera informacje o kontenerze, który hostuje bieżącą kontrolkę podczas renderowania na powierzchni projektowej. (Odziedziczone po Control) |
| SkinID |
Pobiera lub ustawia skórę do zastosowania w kontrolce. (Odziedziczone po Control) |
| TemplateControl |
Pobiera lub ustawia odwołanie do szablonu zawierającego tę kontrolkę. (Odziedziczone po Control) |
| TemplateSourceDirectory |
Pobiera katalog wirtualny obiektu Page lub UserControl , który zawiera bieżącą kontrolkę serwera. (Odziedziczone po Control) |
| Text |
Pobiera lub ustawia podpis wyświetlane w kontrolceLiteral. (Odziedziczone po Literal) |
| UniqueID |
Pobiera unikatowy, hierarchicznie kwalifikowany identyfikator kontroli serwera. (Odziedziczone po Control) |
| ValidateRequestMode |
Pobiera lub ustawia wartość wskazującą, czy kontrolka sprawdza dane wejściowe klienta z przeglądarki pod kątem potencjalnie niebezpiecznych wartości. (Odziedziczone po Control) |
| ViewState |
Pobiera słownik informacji o stanie, który pozwala zapisać i przywrócić stan widoku kontroli serwera w wielu żądaniach dla tej samej strony. (Odziedziczone po Control) |
| ViewStateIgnoresCase |
Pobiera wartość wskazującą, czy StateBag obiekt nie uwzględnia wielkości liter. (Odziedziczone po Control) |
| ViewStateMode |
Pobiera lub ustawia tryb wyświetlania tej kontrolki. (Odziedziczone po Control) |
| Visible |
Pobiera lub ustawia wartość wskazującą, czy kontrolka serwera jest renderowana jako interfejs użytkownika na stronie. (Odziedziczone po Control) |
Metody
| AddedControl(Control, Int32) |
Wywoływane po dodaniu kontrolki podrzędnej do Controls kolekcji Control obiektu. (Odziedziczone po Control) |
| AddParsedSubObject(Object) |
Powiadamia kontrolkę Literal , że element XML lub HTML został przeanalizowany i dodaje ten element do ControlCollection kontrolki. (Odziedziczone po Literal) |
| ApplyStyleSheetSkin(Page) |
Stosuje właściwości stylu zdefiniowane w arkuszu stylów strony do kontrolki. (Odziedziczone po Control) |
| BeginRenderTracing(TextWriter, Object) |
Rozpoczyna śledzenie danych renderowania w czasie projektowania. (Odziedziczone po Control) |
| BuildProfileTree(String, Boolean) |
Zbiera informacje o kontrolce serwera i dostarcza ją do Trace właściwości, która ma być wyświetlana po włączeniu śledzenia dla strony. (Odziedziczone po Control) |
| ClearCachedClientID() |
Ustawia wartość buforowanej ClientID na |
| ClearChildControlState() |
Usuwa informacje o stanie sterowania dla kontrolek podrzędnych kontrolki serwera. (Odziedziczone po Control) |
| ClearChildState() |
Usuwa informacje o stanie widoku i stanie sterowania dla wszystkich kontrolek podrzędnych kontrolki serwera. (Odziedziczone po Control) |
| ClearChildViewState() |
Usuwa informacje o stanie widoku dla wszystkich kontrolek podrzędnych kontrolki serwera. (Odziedziczone po Control) |
| ClearEffectiveClientIDMode() |
ClientIDMode Ustawia właściwość bieżącego wystąpienia kontrolki i wszystkich kontrolek podrzędnych na Inheritwartość . (Odziedziczone po Control) |
| CreateChildControls() |
Wywoływana przez platformę strony ASP.NET w celu powiadamiania kontrolek serwera, które używają implementacji opartej na kompozycji w celu utworzenia wszelkich kontrolek podrzędnych, które zawierają w ramach przygotowania do publikowania z powrotem lub renderowania. (Odziedziczone po Control) |
| CreateControlCollection() |
EmptyControlCollection Tworzy obiekt dla bieżącego wystąpienia kontrolkiLiteral. (Odziedziczone po Literal) |
| DataBind() |
Wiąże źródło danych z wywołaną kontrolką serwera i wszystkimi jej kontrolkami podrzędnymi. (Odziedziczone po Control) |
| DataBind(Boolean) |
Wiąże źródło danych z wywołaną kontrolką serwera i wszystkie jego kontrolki podrzędne z opcją wywołania DataBinding zdarzenia. (Odziedziczone po Control) |
| DataBindChildren() |
Wiąże źródło danych z kontrolkami podrzędnymi kontrolki serwera. (Odziedziczone po Control) |
| Dispose() |
Umożliwia kontroli serwera przeprowadzenie końcowego czyszczenia przed zwolnieniem z pamięci. (Odziedziczone po Control) |
| EndRenderTracing(TextWriter, Object) |
Kończy śledzenie danych renderowania w czasie projektowania. (Odziedziczone po Control) |
| EnsureChildControls() |
Określa, czy kontrolka serwera zawiera kontrolki podrzędne. Jeśli tak nie jest, tworzy kontrolki podrzędne. (Odziedziczone po Control) |
| EnsureID() |
Tworzy identyfikator kontrolek, które nie mają przypisanego identyfikatora. (Odziedziczone po Control) |
| Equals(Object) |
Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object) |
| FindControl(String) |
Wyszukuje bieżący kontener nazewnictwa dla kontrolki serwera przy użyciu określonego |
| FindControl(String, Int32) |
Wyszukuje bieżący kontener nazewnictwa dla kontrolki serwera z określoną liczbą |
| Focus() |
Ustaw fokus danych wejściowych na kontrolkę; podstawowa Focus() metoda sterowania nie jest obsługiwana w kontrolce Literal . (Odziedziczone po Literal) |
| GetDesignModeState() |
Pobiera dane czasu projektowania dla kontrolki. (Odziedziczone po Control) |
| GetHashCode() |
Służy jako domyślna funkcja skrótu. (Odziedziczone po Object) |
| GetRouteUrl(Object) |
Pobiera adres URL odpowiadający zestawowi parametrów trasy. (Odziedziczone po Control) |
| GetRouteUrl(RouteValueDictionary) |
Pobiera adres URL odpowiadający zestawowi parametrów trasy. (Odziedziczone po Control) |
| GetRouteUrl(String, Object) |
Pobiera adres URL odpowiadający zestawowi parametrów trasy i nazwie trasy. (Odziedziczone po Control) |
| GetRouteUrl(String, RouteValueDictionary) |
Pobiera adres URL odpowiadający zestawowi parametrów trasy i nazwie trasy. (Odziedziczone po Control) |
| GetType() |
Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object) |
| GetUniqueIDRelativeTo(Control) |
Zwraca prefiksowaną część UniqueID właściwości określonej kontrolki. (Odziedziczone po Control) |
| HasControls() |
Określa, czy kontrolka serwera zawiera jakiekolwiek kontrolki podrzędne. (Odziedziczone po Control) |
| HasEvents() |
Zwraca wartość wskazującą, czy zdarzenia są zarejestrowane dla kontrolki, czy dla kontrolek podrzędnych. (Odziedziczone po Control) |
| IsLiteralContent() |
Określa, czy kontrolka serwera przechowuje tylko zawartość literału. (Odziedziczone po Control) |
| LoadControlState(Object) |
Przywraca informacje o stanie kontroli z poprzedniego żądania strony, które zostało zapisane przez metodę SaveControlState() . (Odziedziczone po Control) |
| LoadViewState(Object) |
Przywraca informacje o stanie widoku z poprzedniego żądania strony, które zostało zapisane przez metodę SaveViewState() . (Odziedziczone po Control) |
| MapPathSecure(String) |
Pobiera ścieżkę fizyczną, z którą mapuje się ścieżka wirtualna , bezwzględna lub względna. (Odziedziczone po Control) |
| MemberwiseClone() |
Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object) |
| OnBubbleEvent(Object, EventArgs) |
Określa, czy zdarzenie kontroli serwera jest przekazywane w hierarchii kontroli serwera interfejsu użytkownika strony. (Odziedziczone po Control) |
| OnDataBinding(EventArgs) |
DataBinding Zgłasza zdarzenie. (Odziedziczone po Control) |
| OnInit(EventArgs) |
Init Zgłasza zdarzenie. (Odziedziczone po Control) |
| OnLoad(EventArgs) |
Load Zgłasza zdarzenie. (Odziedziczone po Control) |
| OnPreRender(EventArgs) |
PreRender Zgłasza zdarzenie. (Odziedziczone po Control) |
| OnUnload(EventArgs) |
Unload Zgłasza zdarzenie. (Odziedziczone po Control) |
| OpenFile(String) |
Pobiera element Stream używany do odczytywania pliku. (Odziedziczone po Control) |
| RaiseBubbleEvent(Object, EventArgs) |
Przypisuje wszystkie źródła zdarzenia i jego informacje do elementu nadrzędnego kontrolki. (Odziedziczone po Control) |
| RemovedControl(Control) |
Wywoływane po usunięciu kontrolki podrzędnej z Controls kolekcji Control obiektu. (Odziedziczone po Control) |
| Render(HtmlTextWriter) |
Wysyła zawartość kontroli serwera do dostarczonego HtmlTextWriter obiektu, który zapisuje zawartość do renderowania na kliencie. (Odziedziczone po Literal) |
| RenderChildren(HtmlTextWriter) |
Wyprowadza zawartość elementów podrzędnych formantu serwera do dostarczonego HtmlTextWriter obiektu, który zapisuje zawartość do renderowania na kliencie. (Odziedziczone po Control) |
| RenderControl(HtmlTextWriter) |
Dane wyjściowe serwera steruje zawartością dostarczonego HtmlTextWriter obiektu i przechowuje informacje śledzenia dotyczące kontrolki, jeśli śledzenie jest włączone. (Odziedziczone po Control) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Dane wyjściowe serwera steruje zawartością dostarczonego HtmlTextWriter obiektu przy użyciu dostarczonego ControlAdapter obiektu. (Odziedziczone po Control) |
| ResolveAdapter() |
Pobiera kartę sterową odpowiedzialną za renderowanie określonej kontrolki. (Odziedziczone po Control) |
| ResolveClientUrl(String) |
Pobiera adres URL, który może być używany przez przeglądarkę. (Odziedziczone po Control) |
| ResolveUrl(String) |
Konwertuje adres URL na adres, który może być używany przez klienta żądającego. (Odziedziczone po Control) |
| SaveControlState() |
Zapisuje wszelkie zmiany stanu kontroli serwera, które wystąpiły od czasu opublikowania strony z powrotem na serwerze. (Odziedziczone po Control) |
| SaveViewState() |
Zapisuje wszelkie zmiany stanu widoku kontroli serwera, które wystąpiły od czasu opublikowania strony z powrotem na serwerze. (Odziedziczone po Control) |
| SetDesignModeState(IDictionary) |
Ustawia dane czasu projektowania dla kontrolki. (Odziedziczone po Control) |
| SetRenderMethodDelegate(RenderMethod) |
Przypisuje delegata programu obsługi zdarzeń w celu renderowania kontrolki serwera i jego zawartości do kontrolki nadrzędnej. (Odziedziczone po Control) |
| SetTraceData(Object, Object) |
Ustawia dane śledzenia dla śledzenia czasu projektowania danych renderowania przy użyciu klucza danych śledzenia i wartości danych śledzenia. (Odziedziczone po Control) |
| SetTraceData(Object, Object, Object) |
Ustawia dane śledzenia dla śledzenia czasu projektowania danych renderowania, przy użyciu obiektu śledzonego, klucza danych śledzenia i wartości danych śledzenia. (Odziedziczone po Control) |
| ToString() |
Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object) |
| TrackViewState() |
Powoduje śledzenie zmian stanu widoku w kontrolce serwera, dzięki czemu można je przechowywać w obiekcie kontrolki StateBag serwera. Ten obiekt jest dostępny za pośrednictwem ViewState właściwości . (Odziedziczone po Control) |
Zdarzenia
| DataBinding |
Występuje, gdy kontrolka serwera wiąże się ze źródłem danych. (Odziedziczone po Control) |
| Disposed |
Występuje, gdy kontrolka serwera jest zwalniana z pamięci, która jest ostatnim etapem cyklu życia kontroli serwera po zażądaniu strony ASP.NET. (Odziedziczone po Control) |
| Init |
Występuje, gdy kontrolka serwera jest inicjowana, co jest pierwszym krokiem w jego cyklu życia. (Odziedziczone po Control) |
| Load |
Występuje, gdy kontrolka serwera jest ładowana do Page obiektu. (Odziedziczone po Control) |
| PreRender |
Występuje po załadowaniu Control obiektu, ale przed renderowaniem. (Odziedziczone po Control) |
| Unload |
Występuje, gdy kontrolka serwera jest zwalniana z pamięci. (Odziedziczone po Control) |
Jawne implementacje interfejsu
Metody rozszerzania
| FindDataSourceControl(Control) |
Zwraca źródło danych skojarzone z kontrolką danych dla określonej kontrolki. |
| FindFieldTemplate(Control, String) |
Zwraca szablon pola dla określonej kolumny w kontenerze nazewnictwa określonej kontrolki. |
| FindMetaTable(Control) |
Zwraca obiekt metatable dla kontrolki zawierającej dane. |
Dotyczy
Zobacz też
Opinia
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź: https://aka.ms/ContentUserFeedback.
Prześlij i wyświetl opinię dla