ClientTarget 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.
Definiuje alias skojarzony z docelowym agentem użytkownika, dla którego kontrolki serwera ASP.NET powinny renderować zawartość. Klasa ta nie może być dziedziczona.
public ref class ClientTarget sealed : System::Configuration::ConfigurationElement
public sealed class ClientTarget : System.Configuration.ConfigurationElement
type ClientTarget = class
inherit ConfigurationElement
Public NotInheritable Class ClientTarget
Inherits ConfigurationElement
- Dziedziczenie
Przykłady
Ta sekcja zawiera dwa przykłady kodu. Pierwszy pokazuje, jak deklaratywnie określać wartości dla kilku właściwości ClientTarget klasy. Drugi pokazuje, jak uzyskać ClientTargetCollection obiekt z pliku konfiguracji. Ten obiekt służy do uzyskiwania ClientTarget dostępu do obiektów, które zawiera.
W poniższym przykładzie kodu pokazano, jak deklaratywnie określać wartości dla kilku właściwości ClientTarget klasy.
<clientTarget>
<add alias=
"uplevel"
userAgent="Mozilla/5.0 (compatible;MSIE 6.0;Windows NT 5.1)"/>
<add alias="downlevel" userAgent="Generic Downlevel"/>
</clientTarget>
Poniższy przykład kodu pokazuje, jak uzyskać ClientTargetCollection obiekt z pliku konfiguracji.
// Get the Web application configuration.
System.Configuration.Configuration configuration =
WebConfigurationManager.OpenWebConfiguration(
"/aspnetTest");
// Get the <clientTarget> section.
ClientTargetSection clientTargetSection =
(ClientTargetSection)configuration.GetSection(
"system.web/clientTarget");
// Get the client target collection.
ClientTargetCollection clientTargets =
clientTargetSection.ClientTargets;
' Get the Web application configuration.
Dim configuration _
As System.Configuration.Configuration = _
WebConfigurationManager.OpenWebConfiguration( _
"/aspnetTest")
' Get the <clientTarget> section.
Dim clientTargetSection _
As ClientTargetSection = _
CType(configuration.GetSection( _
"system.web/clientTarget"), _
ClientTargetSection)
' Get the client target collection.
Dim clientTargets _
As ClientTargetCollection = _
clientTargetSection.ClientTargets
Uwagi
Klasa ClientTarget odwołuje się do elementów dodanych w clientTarget
sekcji pliku konfiguracji.
Klasa ClientTarget należy do grupy zawierającej klasę ClientTargetCollection i klasę ClientTargetSection .
Klasa ClientTarget zawiera dwie właściwości identyfikujące przeglądarkę klienta, również nazwaną agenta użytkownika. Jedną z właściwości jest alias skojarzony z przeglądarką klienta zidentyfikowaną przez drugą właściwość. ASP.NET używa tych informacji do renderowania kontrolek serwera na stronie.
Aby uzyskać informacje o sposobie programowego użycia agenta użytkownika lub jego aliasu Page.ClientTarget , zobacz właściwość . Aby uzyskać informacje o sposobie użycia agenta użytkownika lub jego aliasu deklaratywnie, zobacz @ Strona.
Page.ClientTarget Jeśli właściwość nie jest ustawiona, HttpBrowserCapabilities obiekt skojarzony z właściwością Page.Request odzwierciedla możliwości przeglądarki klienta. (Odzwierciedla ona możliwości typu przeglądarki, ale niekoniecznie ustawienia w określonym wystąpieniu tej przeglądarki). Jeśli właściwość jest ustawiona, wykrywanie przeglądarki klienta jest wyłączone, a strona używa funkcji przeglądarki skojarzonych z zdefiniowanym ciągiem agenta użytkownika. Tę właściwość można ustawić na dowolny prawidłowy ciąg agenta użytkownika.
Konstruktory
ClientTarget(String, String) |
Inicjuje nowe wystąpienie klasy ClientTarget. |
Właściwości
Alias |
Pobiera alias agenta użytkownika. |
CurrentConfiguration |
Pobiera odwołanie do wystąpienia najwyższego poziomu Configuration , które reprezentuje hierarchię konfiguracji, do którego należy bieżące ConfigurationElement wystąpienie. (Odziedziczone po ConfigurationElement) |
ElementInformation |
ElementInformation Pobiera obiekt, który zawiera niezstosowalne informacje i funkcje ConfigurationElement obiektu. (Odziedziczone po ConfigurationElement) |
ElementProperty |
ConfigurationElementProperty Pobiera obiekt reprezentujący ConfigurationElement sam obiekt. (Odziedziczone po ConfigurationElement) |
EvaluationContext |
ContextInformation Pobiera obiekt dla ConfigurationElement obiektu. (Odziedziczone po ConfigurationElement) |
HasContext |
Pobiera wartość wskazującą, czy CurrentConfiguration właściwość to |
Item[ConfigurationProperty] |
Pobiera lub ustawia właściwość lub atrybut tego elementu konfiguracji. (Odziedziczone po ConfigurationElement) |
Item[String] |
Pobiera lub ustawia właściwość, atrybut lub element podrzędny tego elementu konfiguracji. (Odziedziczone po ConfigurationElement) |
LockAllAttributesExcept |
Pobiera kolekcję zablokowanych atrybutów. (Odziedziczone po ConfigurationElement) |
LockAllElementsExcept |
Pobiera kolekcję zablokowanych elementów. (Odziedziczone po ConfigurationElement) |
LockAttributes |
Pobiera kolekcję zablokowanych atrybutów. (Odziedziczone po ConfigurationElement) |
LockElements |
Pobiera kolekcję zablokowanych elementów. (Odziedziczone po ConfigurationElement) |
LockItem |
Pobiera lub ustawia wartość wskazującą, czy element jest zablokowany. (Odziedziczone po ConfigurationElement) |
Properties |
Pobiera kolekcję właściwości. (Odziedziczone po ConfigurationElement) |
UserAgent |
Pobiera nazwę identyfikacji agenta użytkownika. |
Metody
DeserializeElement(XmlReader, Boolean) |
Odczytuje kod XML z pliku konfiguracji. (Odziedziczone po ConfigurationElement) |
Equals(Object) |
Porównuje bieżące ConfigurationElement wystąpienie z określonym obiektem. (Odziedziczone po ConfigurationElement) |
GetHashCode() |
Pobiera unikatową wartość reprezentującą bieżące ConfigurationElement wystąpienie. (Odziedziczone po ConfigurationElement) |
GetTransformedAssemblyString(String) |
Zwraca przekształconą wersję określonej nazwy zestawu. (Odziedziczone po ConfigurationElement) |
GetTransformedTypeString(String) |
Zwraca przekształconą wersję określonej nazwy typu. (Odziedziczone po ConfigurationElement) |
GetType() |
Type Pobiera bieżące wystąpienie. (Odziedziczone po Object) |
Init() |
ConfigurationElement Ustawia obiekt na stan początkowy. (Odziedziczone po ConfigurationElement) |
InitializeDefault() |
Służy do inicjowania domyślnego zestawu wartości dla ConfigurationElement obiektu. (Odziedziczone po ConfigurationElement) |
IsModified() |
Wskazuje, czy ten element konfiguracji został zmodyfikowany od czasu ostatniego zapisania lub załadowania, gdy został zaimplementowany w klasie pochodnej. (Odziedziczone po ConfigurationElement) |
IsReadOnly() |
Pobiera wartość wskazującą, czy ConfigurationElement obiekt jest tylko do odczytu. (Odziedziczone po ConfigurationElement) |
ListErrors(IList) |
Dodaje błędy nieprawidłowej właściwości w tym ConfigurationElement obiekcie i we wszystkich podelementach do przekazanej listy. (Odziedziczone po ConfigurationElement) |
MemberwiseClone() |
Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object) |
OnDeserializeUnrecognizedAttribute(String, String) |
Pobiera wartość wskazującą, czy podczas deserializacji napotkano nieznany atrybut. (Odziedziczone po ConfigurationElement) |
OnDeserializeUnrecognizedElement(String, XmlReader) |
Pobiera wartość wskazującą, czy podczas deserializacji napotkano nieznany element. (Odziedziczone po ConfigurationElement) |
OnRequiredPropertyNotFound(String) |
Zgłasza wyjątek, gdy nie znaleziono wymaganej właściwości. (Odziedziczone po ConfigurationElement) |
PostDeserialize() |
Wywoływana po deserializacji. (Odziedziczone po ConfigurationElement) |
PreSerialize(XmlWriter) |
Wywoływane przed serializacji. (Odziedziczone po ConfigurationElement) |
Reset(ConfigurationElement) |
Resetuje stan ConfigurationElement wewnętrzny obiektu, w tym blokady i kolekcje właściwości. (Odziedziczone po ConfigurationElement) |
ResetModified() |
Resetuje wartość IsModified() metody w |
SerializeElement(XmlWriter, Boolean) |
Zapisuje zawartość tego elementu konfiguracji do pliku konfiguracji po zaimplementowaniu w klasie pochodnej. (Odziedziczone po ConfigurationElement) |
SerializeToXmlElement(XmlWriter, String) |
Zapisuje zewnętrzne tagi tego elementu konfiguracji do pliku konfiguracji po zaimplementowaniu w klasie pochodnej. (Odziedziczone po ConfigurationElement) |
SetPropertyValue(ConfigurationProperty, Object, Boolean) |
Ustawia właściwość na określoną wartość. (Odziedziczone po ConfigurationElement) |
SetReadOnly() |
IsReadOnly() Ustawia właściwość obiektu ConfigurationElement i wszystkich podelementów. (Odziedziczone po ConfigurationElement) |
ToString() |
Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object) |
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode) |
Modyfikuje obiekt, ConfigurationElement aby usunąć wszystkie wartości, które nie powinny być zapisywane. (Odziedziczone po ConfigurationElement) |