SessionAuthenticationModule.IsReferenceMode Eigenschaft

Definition

Namespace:

System.IdentityModel.Services

Assembly:

System.IdentityModel.Services.dll

Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob die Sitzungsinformationen (Anspruchswerte usw.) im Sitzungscookie gespeichert werden sollen oder ob der Sitzungsinhalt auf der Serverseite über das Cookie als Referenz gespeichert werden soll.

public:
 property bool IsReferenceMode { bool get(); void set(bool value); };

public bool IsReferenceMode { get; set; }

member this.IsReferenceMode : bool with get, set

Public Property IsReferenceMode As Boolean

Eigenschaftswert

Boolean

true, wenn sich ausgestellte Cookies im Referenzmodus befinden; andernfalls false. Der Standardwert ist false und gibt an, dass sich ausgestellte Cookies nicht im Referenzmodus befinden.

Hinweise

Im Verweismodus wird das SessionSecurityToken in einem serverseitigen Cache (ein Objekt, das von SessionSecurityTokenCacheabgeleitet wird) gespeichert. Das ausgegebene Cookie enthält nur einen Kontextbezeichner, der zum Abrufen des Tokens aus dem Cache verwendet wird.

Wichtig

Um im Verweismodus zu arbeiten, empfiehlt Microsoft, einen Handler für das WSFederationAuthenticationModule.SessionSecurityTokenCreated Ereignis in der global.asax.cs-Datei bereitzustellen und die SessionSecurityToken.IsReferenceMode -Eigenschaft für das token festzulegen, das in der SessionSecurityTokenCreatedEventArgs.SessionToken -Eigenschaft übergeben wird. Dadurch wird sichergestellt, dass das Sitzungstoken im Verweismodus für jede Anforderung ausgeführt wird und gegenüber dem bloßen Festlegen der SessionAuthenticationModule.IsReferenceMode Eigenschaft im Sitzungsauthentifizierungsmodul bevorzugt wird.