SessionStateSection Klasa
Definicja
Ważny
Niektóre informacje dotyczą produktów przedpremierowych, które mogą zostać znacznie zmodyfikowane przed premierą. Microsoft nie udziela żadnych gwarancji, ani wyraźnych, ani domniemanych, dotyczących informacji podanych tutaj.
Konfiguruje stan sesji dla aplikacji sieci Web.
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 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.
Konstruktorów
| 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 reprezentującego hierarchię konfiguracji, do którego należy bieżące ConfigurationElement wystąpienie. (Dziedziczone od 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ć. (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ą CurrentConfiguration , czy właściwość ma wartość |
| 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) |
| 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. (Dziedziczone od 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ć. (Dziedziczone od 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
| Nazwa | Opis |
|---|---|
| DeserializeElement(XmlReader, Boolean) |
Odczytuje kod XML z pliku konfiguracji. (Dziedziczone od ConfigurationElement) |
| DeserializeSection(XmlReader) |
Odczytuje kod XML z pliku konfiguracji. (Dziedziczone od ConfigurationSection) |
| 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) |
| GetRuntimeObject() |
Zwraca obiekt niestandardowy, gdy zostanie zastąpiony w klasie pochodnej. (Dziedziczone od ConfigurationSection) |
| 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 wartość bieżącego wystąpienia. (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 podczas implementacji w klasie pochodnej. (Dziedziczone od ConfigurationSection) |
| 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 można odnaleźć wymaganej właściwości. (Dziedziczone od ConfigurationElement) |
| PostDeserialize() |
Wywoływana po deserializacji. (Dziedziczone od ConfigurationElement) |
| PreSerialize(XmlWriter) |
Wywoływana 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 |
| SerializeElement(XmlWriter, Boolean) |
Zapisuje zawartość tego elementu konfiguracji do pliku konfiguracji po zaimplementowaniu w klasie pochodnej. (Dziedziczone od ConfigurationElement) |
| SerializeSection(ConfigurationElement, String, ConfigurationSaveMode) |
Tworzy ciąg XML zawierający nieskonwergentny widok ConfigurationSection obiektu jako pojedynczą sekcję do zapisu w pliku. (Dziedziczone od ConfigurationSection) |
| 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ść dla ConfigurationElement obiektu i wszystkich podelementów. (Dziedziczone od 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. (Dziedziczone od 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. (Dziedziczone od 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. (Dziedziczone od ConfigurationSection) |
| ToString() |
Zwraca ciąg reprezentujący bieżący obiekt. (Dziedziczone od Object) |
| Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode) |
Modyfikuje obiekt w ConfigurationElement celu usunięcia wszystkich wartości, które nie powinny być zapisywane. (Dziedziczone od ConfigurationElement) |
