ClientTarget Klasa

Definicja

Namespace:

System.Web.Configuration

Montaż:

System.Web.dll

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

Object

ConfigurationElement

ClientTarget

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.

Konstruktorów

Nazwa	Opis
ClientTarget(String, String)	Inicjuje nowe wystąpienie klasy ClientTarget.

Właściwości

Nazwa	Opis
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. (Dziedziczone od ConfigurationElement)
ElementInformation	ElementInformation Pobiera obiekt, który zawiera niezstosowalne informacje i funkcje ConfigurationElement obiektu. (Dziedziczone od ConfigurationElement)
ElementProperty	ConfigurationElementProperty Pobiera obiekt reprezentujący ConfigurationElement sam obiekt. (Dziedziczone od ConfigurationElement)
EvaluationContext	ContextInformation Pobiera obiekt dla ConfigurationElement obiektu. (Dziedziczone od ConfigurationElement)
HasContext	Pobiera wartość wskazującą, czy CurrentConfiguration właściwość to null. (Dziedziczone od ConfigurationElement)
Item[ConfigurationProperty]	Pobiera lub ustawia właściwość lub atrybut tego elementu konfiguracji. (Dziedziczone od ConfigurationElement)
Item[String]	Pobiera lub ustawia właściwość, atrybut lub element podrzędny tego elementu konfiguracji. (Dziedziczone od ConfigurationElement)
LockAllAttributesExcept	Pobiera kolekcję zablokowanych atrybutów. (Dziedziczone od ConfigurationElement)
LockAllElementsExcept	Pobiera kolekcję zablokowanych elementów. (Dziedziczone od ConfigurationElement)
LockAttributes	Pobiera kolekcję zablokowanych atrybutów. (Dziedziczone od ConfigurationElement)
LockElements	Pobiera kolekcję zablokowanych elementów. (Dziedziczone od ConfigurationElement)
LockItem	Pobiera lub ustawia wartość wskazującą, czy element jest zablokowany. (Dziedziczone od ConfigurationElement)
Properties	Pobiera kolekcję właściwości. (Dziedziczone od ConfigurationElement)
UserAgent	Pobiera nazwę identyfikacji agenta użytkownika.

Metody

Nazwa	Opis
DeserializeElement(XmlReader, Boolean)	Odczytuje kod XML z pliku konfiguracji. (Dziedziczone od ConfigurationElement)
Equals(Object)	Porównuje bieżące ConfigurationElement wystąpienie z określonym obiektem. (Dziedziczone od ConfigurationElement)
GetHashCode()	Pobiera unikatową wartość reprezentującą bieżące ConfigurationElement wystąpienie. (Dziedziczone od ConfigurationElement)
GetTransformedAssemblyString(String)	Zwraca przekształconą wersję określonej nazwy zestawu. (Dziedziczone od ConfigurationElement)
GetTransformedTypeString(String)	Zwraca przekształconą wersję określonej nazwy typu. (Dziedziczone od ConfigurationElement)
GetType()	Type Pobiera bieżące wystąpienie. (Dziedziczone od Object)
Init()	ConfigurationElement Ustawia obiekt na stan początkowy. (Dziedziczone od ConfigurationElement)
InitializeDefault()	Służy do inicjowania domyślnego zestawu wartości dla ConfigurationElement obiektu. (Dziedziczone od ConfigurationElement)
IsModified()	Wskazuje, czy ten element konfiguracji został zmodyfikowany od czasu ostatniego zapisania lub załadowania, gdy został zaimplementowany w klasie pochodnej. (Dziedziczone od ConfigurationElement)
IsReadOnly()	Pobiera wartość wskazującą, czy ConfigurationElement obiekt jest tylko do odczytu. (Dziedziczone od ConfigurationElement)
ListErrors(IList)	Dodaje błędy nieprawidłowej właściwości w tym ConfigurationElement obiekcie i we wszystkich podelementach do przekazanej listy. (Dziedziczone od ConfigurationElement)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Dziedziczone od Object)
OnDeserializeUnrecognizedAttribute(String, String)	Pobiera wartość wskazującą, czy podczas deserializacji napotkano nieznany atrybut. (Dziedziczone od ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)	Pobiera wartość wskazującą, czy podczas deserializacji napotkano nieznany element. (Dziedziczone od ConfigurationElement)
OnRequiredPropertyNotFound(String)	Zgłasza wyjątek, gdy nie znaleziono wymaganej właściwości. (Dziedziczone od ConfigurationElement)
PostDeserialize()	Wywoływana po deserializacji. (Dziedziczone od ConfigurationElement)
PreSerialize(XmlWriter)	Wywoływane przed serializacji. (Dziedziczone od ConfigurationElement)
Reset(ConfigurationElement)	Resetuje stan ConfigurationElement wewnętrzny obiektu, w tym blokady i kolekcje właściwości. (Dziedziczone od ConfigurationElement)
ResetModified()	Resetuje wartość IsModified() metody w false przypadku implementacji w klasie pochodnej. (Dziedziczone od ConfigurationElement)
SerializeElement(XmlWriter, Boolean)	Zapisuje zawartość tego elementu konfiguracji do pliku konfiguracji po zaimplementowaniu w klasie pochodnej. (Dziedziczone od ConfigurationElement)
SerializeToXmlElement(XmlWriter, String)	Zapisuje zewnętrzne tagi tego elementu konfiguracji do pliku konfiguracji po zaimplementowaniu w klasie pochodnej. (Dziedziczone od ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)	Ustawia właściwość na określoną wartość. (Dziedziczone od ConfigurationElement)
SetReadOnly()	IsReadOnly() Ustawia właściwość obiektu ConfigurationElement i wszystkich podelementów. (Dziedziczone od ConfigurationElement)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Dziedziczone od Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	Modyfikuje obiekt, ConfigurationElement aby usunąć wszystkie wartości, które nie powinny być zapisywane. (Dziedziczone od ConfigurationElement)

Zobacz także

• ClientTargetSection
• ClientTargetCollection
• ClientTarget
• ASP.NET funkcje kontrolek serwera i przeglądarki