SessionStateSection 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.
Konfiguruje stan sesji dla aplikacji internetowej.
public ref class SessionStateSection sealed : System::Configuration::ConfigurationSectionpublic sealed class SessionStateSection : System.Configuration.ConfigurationSectiontype SessionStateSection = class
inherit ConfigurationSectionPublic NotInheritable Class SessionStateSection
Inherits ConfigurationSection- Dziedziczenie
Przykłady
Ta sekcja zawiera dwa przykłady kodu. Pierwszy pokazuje, jak deklaratywnie określić wartości dla kilku atrybutów sessionState sekcji, do których można również uzyskać dostęp jako elementy członkowskie SessionStateSection klasy. Drugi pokazuje, jak używać SessionStateSection klasy .
W poniższym przykładzie pliku konfiguracji pokazano, jak deklaratywnie określić wartości dla sessionState sekcji.
<configuration>
<system.web>
<sessionState mode="InProc"
stateConnectionString="tcpip=127.0.0.1:42424"
stateNetworkTimeout="10"
sqlConnectionString="data source=127.0.0.1;
Integrated Security=SSPI"
sqlCommandTimeout="30"
customProvider=""
cookieless="UseDeviceProfile"
cookieName="ASP.NET_SessionId"
timeout="20"
allowCustomSqlDatabase="False"
regenerateExpiredSessionId="False"
partitionResolverType=""
useHostingIdentity="True">
<providers>
<clear />
</providers>
</sessionState>
</system.web>
</configuration>
W poniższym przykładzie kodu pokazano, jak używać SessionStateSection klasy .
// Get the Web application configuration object.
System.Configuration.Configuration configuration =
System.Web.Configuration.WebConfigurationManager.OpenWebConfiguration("/aspnetTest");
// Get the section related object.
System.Web.Configuration.SessionStateSection sessionStateSection =
(System.Web.Configuration.SessionStateSection)
configuration.GetSection("system.web/sessionState");
' Get the Web application configuration.
Dim configuration As System.Configuration.Configuration = _
System.Web.Configuration.WebConfigurationManager.OpenWebConfiguration("/aspnetTest")
' Get the section.
Dim sessionStateSection As System.Web.Configuration.SessionStateSection = _
CType(configuration.GetSection("system.web/sessionState"), _
System.Web.Configuration.SessionStateSection)
Uwagi
Klasa SessionStateSection odwołuje się do elementu w pliku konfiguracji Machine.config lub Web.config zidentyfikowanym sessionState przez tag .
Gdy nowy klient rozpoczyna interakcję z aplikacją internetową, identyfikator sesji jest wystawiany i skojarzony ze wszystkimi kolejnymi żądaniami od tego samego klienta w czasie, gdy sesja jest prawidłowa. Ten identyfikator służy do obsługi stanu po stronie serwera skojarzonego z sesją klienta między żądaniami. SessionStateSection kontroluje sposób, w jaki aplikacja ASP.NET ustanawia i utrzymuje to skojarzenie w imieniu każdego klienta.
Ten mechanizm jest bardzo elastyczny i zapewnia możliwość hostowania informacji o stanie sesji poza procesem i śledzenia stanu bez używania plików cookie, między innymi.
Konstruktory
| Nazwa | Opis |
|---|---|
| SessionStateSection() |
Inicjuje nowe wystąpienie klasy SessionStateSection. |
Właściwości
| Nazwa | Opis |
|---|---|
| AllowCustomSqlDatabase |
Pobiera lub ustawia wartość wskazującą, czy użytkownik może określić początkową wartość katalogu we SqlConnectionString właściwości. |
| CompressionEnabled |
Pobiera lub ustawia wartość wskazującą, czy kompresja jest włączona dla danych stanu sesji. |
| Cookieless |
Pobiera lub ustawia wartość wskazującą, czy pliki cookie są używane do identyfikowania sesji klientów. |
| CookieName |
Pobiera lub ustawia nazwę pliku cookie. |
| CookieSameSite |
Pobiera lub ustawia wartość atrybutu SameSite pliku cookie. |
| CurrentConfiguration |
Pobiera odwołanie do wystąpienia najwyższego poziomu Configuration, które reprezentuje hierarchię konfiguracji, do którego należy bieżące wystąpienie ConfigurationElement. (Odziedziczone po ConfigurationElement) |
| CustomProvider |
Pobiera lub ustawia nazwę dostawcy niestandardowego z kolekcji Providers . |
| ElementInformation |
Pobiera obiekt ElementInformation zawierający informacje i funkcje obiektu ConfigurationElement, które nie można dostosowywać. (Odziedziczone po ConfigurationElement) |
| ElementProperty |
Pobiera obiekt ConfigurationElementProperty reprezentujący sam obiekt ConfigurationElement. (Odziedziczone po ConfigurationElement) |
| EvaluationContext |
Pobiera obiekt ContextInformation dla obiektu ConfigurationElement. (Odziedziczone po ConfigurationElement) |
| HasContext |
Pobiera wartość wskazującą, czy właściwość CurrentConfiguration jest |
| 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) |
| Mode |
Pobiera lub ustawia wartość określającą miejsce przechowywania stanu sesji. |
| PartitionResolverType |
Pobiera lub ustawia wartość określającą miejsce przechowywania stanu sesji. |
| Properties |
Pobiera kolekcję właściwości. (Odziedziczone po ConfigurationElement) |
| Providers |
Pobiera bieżących ProviderSettingsCollection dostawców. |
| RegenerateExpiredSessionId |
Pobiera lub ustawia wartość wskazującą, czy identyfikator sesji zostanie ponownie wystawiony po określeniu przez klienta wygasłego identyfikatora sesji. |
| SectionInformation |
Pobiera obiekt SectionInformation zawierający informacje i funkcje obiektu ConfigurationSection, które nie można dostosowywać. (Odziedziczone po ConfigurationSection) |
| SessionIDManagerType |
Pobiera lub ustawia wartość określającą w pełni kwalifikowany typ Menedżera identyfikatorów sesji. |
| SqlCommandTimeout |
Pobiera lub ustawia limit czasu trwania dla poleceń SQL przy użyciu trybu stanu sesji programu SQL Server. |
| SqlConnectionRetryInterval |
Pobiera lub ustawia interwał czasu, który powinien upłynąć przed ASP.NET ponowne nawiązywanie połączenia z bazą danych. |
| SqlConnectionString |
Pobiera lub ustawia parametry połączenia SQL. |
| StateConnectionString |
Pobiera lub ustawia parametry połączenia serwera stanu. |
| StateNetworkTimeout |
Pobiera lub ustawia czas, przez jaki połączenie sieciowe między serwerem sieci Web a serwerem stanu może pozostać bezczynne. |
| Timeout |
Pobiera lub ustawia limit czasu sesji. |
| UseHostingIdentity |
Pobiera lub ustawia wartość określającą, czy stan sesji będzie używać personifikacji klienta, gdy jest dostępny, czy zawsze przywraca tożsamość hostingu. |
Metody
| Nazwa | Opis |
|---|---|
| DeserializeElement(XmlReader, Boolean) |
Odczytuje kod XML z pliku konfiguracji. (Odziedziczone po ConfigurationElement) |
| DeserializeSection(XmlReader) |
Odczytuje kod XML z pliku konfiguracji. (Odziedziczone po ConfigurationSection) |
| Equals(Object) |
Porównuje bieżące wystąpienie ConfigurationElement z określonym obiektem. (Odziedziczone po ConfigurationElement) |
| GetHashCode() |
Pobiera unikatową wartość reprezentującą bieżące wystąpienie ConfigurationElement. (Odziedziczone po ConfigurationElement) |
| GetRuntimeObject() |
Zwraca obiekt niestandardowy podczas zastępowania w klasie pochodnej. (Odziedziczone po ConfigurationSection) |
| 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() |
Pobiera Type bieżącego wystąpienia. (Odziedziczone po Object) |
| Init() |
Ustawia obiekt ConfigurationElement na stan początkowy. (Odziedziczone po ConfigurationElement) |
| InitializeDefault() |
Służy do inicjowania domyślnego zestawu wartości dla obiektu ConfigurationElement. (Odziedziczone po ConfigurationElement) |
| IsModified() |
Wskazuje, czy ten element konfiguracji został zmodyfikowany od czasu ostatniego zapisania, czy załadowany podczas implementacji w klasie pochodnej. (Odziedziczone po ConfigurationSection) |
| IsReadOnly() |
Pobiera wartość wskazującą, czy obiekt ConfigurationElement jest tylko do odczytu. (Odziedziczone po ConfigurationElement) |
| ListErrors(IList) |
Dodaje błędy nieprawidłowej właściwości w tym obiekcie ConfigurationElement i we wszystkich elementach podrzędnych do przekazanej listy. (Odziedziczone po ConfigurationElement) |
| MemberwiseClone() |
Tworzy płytkią kopię bieżącego Object. (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 wewnętrzny obiektu ConfigurationElement, w tym blokady i kolekcje właściwości. (Odziedziczone po ConfigurationElement) |
| ResetModified() |
Resetuje wartość metody IsModified(), aby |
| SerializeElement(XmlWriter, Boolean) |
Zapisuje zawartość tego elementu konfiguracji w pliku konfiguracji po zaimplementowaniu w klasie pochodnej. (Odziedziczone po ConfigurationElement) |
| SerializeSection(ConfigurationElement, String, ConfigurationSaveMode) |
Tworzy ciąg XML zawierający niezaergowany widok obiektu ConfigurationSection jako pojedynczą sekcję do zapisu w pliku. (Odziedziczone po ConfigurationSection) |
| 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() |
Ustawia właściwość IsReadOnly() dla obiektu ConfigurationElement i wszystkich podelementów. (Odziedziczone po ConfigurationElement) |
| ShouldSerializeElementInTargetVersion(ConfigurationElement, String, FrameworkName) |
Wskazuje, czy określony element powinien być serializowany, gdy hierarchia obiektów konfiguracji jest serializowana dla określonej wersji docelowej platformy .NET. (Odziedziczone po ConfigurationSection) |
| ShouldSerializePropertyInTargetVersion(ConfigurationProperty, String, FrameworkName, ConfigurationElement) |
Wskazuje, czy określona właściwość powinna być serializowana, gdy hierarchia obiektów konfiguracji jest serializowana dla określonej wersji docelowej programu .NET Framework. (Odziedziczone po ConfigurationSection) |
| ShouldSerializeSectionInTargetVersion(FrameworkName) |
Wskazuje, czy bieżące wystąpienie ConfigurationSection powinno być serializowane, gdy hierarchia obiektów konfiguracji jest serializowana dla określonej wersji docelowej programu .NET Framework. (Odziedziczone po ConfigurationSection) |
| 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) |
