ClientTarget Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.Configuration

Zestaw:: System.Web.dll

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: Object

ConfigurationElement
ClientTarget

Przykłady

Ta sekcja zawiera dwa przykłady kodu. Pierwszy demonstruje sposób deklaratywnego określania 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 zawartych w nim obiektów.

Poniższy przykład kodu przedstawia sposób deklaratywnego określania 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, które są dodawane w clientTarget sekcji pliku konfiguracji.

Klasa ClientTarget należy do grupy, która zawiera klasę ClientTargetCollection i klasę ClientTargetSection .

Klasa ClientTarget zawiera dwie właściwości identyfikujące przeglądarkę klienta, nazywaną również agentem 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 na temat programowego użycia agenta użytkownika lub jego aliasu Page.ClientTarget , zobacz właściwość . Aby uzyskać informacje o sposobie deklaratywnego użycia agenta użytkownika lub jego aliasu, zobacz @ Strona.

Page.ClientTarget Jeśli właściwość nie jest ustawiona, HttpBrowserCapabilities obiekt skojarzony z Page.Request właściwością odzwierciedla możliwości przeglądarki klienta. (Odzwierciedla 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 reprezentującego hierarchię konfiguracji, do którego należy bieżące ConfigurationElement wystąpienie. (Odziedziczone po ConfigurationElement)
ElementInformation	ElementInformation Pobiera obiekt, który zawiera informacje i funkcje ConfigurationElement obiektu, które nie można dostosowywać. (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ą CurrentConfiguration , czy właściwość ma wartość `null`. (Odziedziczone po ConfigurationElement)
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 wartość bieżącego wystąpienia. (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, podczas implementacji 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 można odnaleźć wymaganej właściwości. (Odziedziczone po ConfigurationElement)
PostDeserialize()	Wywoływana po deserializacji. (Odziedziczone po ConfigurationElement)
PreSerialize(XmlWriter)	Wywoływana 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 `false` przypadku implementacji w klasie pochodnej. (Odziedziczone po ConfigurationElement)
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ść dla ConfigurationElement obiektu 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 w ConfigurationElement celu usunięcia wszystkich wartości, które nie powinny być zapisywane. (Odziedziczone po ConfigurationElement)

Dotyczy