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 sieci Web.
public ref class SessionStateSection sealed : System::Configuration::ConfigurationSection
public sealed class SessionStateSection : System.Configuration.ConfigurationSection
type SessionStateSection = class
inherit ConfigurationSection
Public NotInheritable Class SessionStateSection
Inherits ConfigurationSection
- Dziedziczenie
Przykłady
Ta sekcja zawiera dwa przykłady kodu. Pierwszy demonstruje sposób deklaratywnego określania wartości dla kilku atrybutów sessionState
sekcji, do których można również uzyskać dostęp jako składowe SessionStateSection klasy. Drugi pokazuje, jak używać SessionStateSection klasy .
Poniższy przykładowy plik konfiguracji przedstawia sposób deklaratywnego określania sessionState
wartości dla 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 identyfikowanym sessionState
przez tag .
Gdy nowy klient rozpoczyna interakcję z aplikacją internetową, zostaje wystawiony identyfikator sesji 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. Steruje SessionStateSection sposobem, 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
SessionStateSection() |
Inicjuje nowe wystąpienie klasy SessionStateSection. |
Właściwości
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 reprezentującego hierarchię konfiguracji, do którego należy bieżące ConfigurationElement wystąpienie. (Odziedziczone po ConfigurationElement) |
CustomProvider |
Pobiera lub ustawia nazwę dostawcy niestandardowego z kolekcji Providers . |
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ść |
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 |
SectionInformation Pobiera obiekt, który zawiera informacje i funkcje ConfigurationSection obiektu, 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 ponownie nawiązać połączenie 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 połączenia sieciowego między serwerem sieci Web a serwerem stanu może pozostać bezczynny. |
Timeout |
Pobiera lub ustawia limit czasu sesji. |
UseHostingIdentity |
Pobiera lub ustawia wartość określającą, czy stan sesji będzie używać personifikacji klienta, jeśli jest dostępny, czy zawsze przywraca tożsamość hostingu. |
Metody
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 ConfigurationElement wystąpienie z określonym obiektem. (Odziedziczone po ConfigurationElement) |
GetHashCode() |
Pobiera unikatową wartość reprezentującą bieżące ConfigurationElement wystąpienie. (Odziedziczone po ConfigurationElement) |
GetRuntimeObject() |
Zwraca obiekt niestandardowy, gdy zostanie zastąpiony 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() |
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 ConfigurationSection) |
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 |
SerializeElement(XmlWriter, Boolean) |
Zapisuje zawartość tego elementu konfiguracji do pliku konfiguracji po zaimplementowaniu w klasie pochodnej. (Odziedziczone po ConfigurationElement) |
SerializeSection(ConfigurationElement, String, ConfigurationSaveMode) |
Tworzy ciąg XML zawierający nieskonwergentny widok ConfigurationSection obiektu 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() |
IsReadOnly() Ustawia właściwość dla ConfigurationElement obiektu 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 programu .NET Framework. (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 ConfigurationSection wystąpienie 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 w ConfigurationElement celu usunięcia wszystkich wartości, które nie powinny być zapisywane. (Odziedziczone po ConfigurationElement) |