WindowsAuthenticationModule Osztály
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
Beállítja a felhasználó identitását egy ASP.NET-alkalmazáshoz, ha Windows authentication engedélyezve van. Ez az osztály nem örökölhető.
public ref class WindowsAuthenticationModule sealed : System::Web::IHttpModule
public sealed class WindowsAuthenticationModule : System.Web.IHttpModule
type WindowsAuthenticationModule = class
interface IHttpModule
Public NotInheritable Class WindowsAuthenticationModule
Implements IHttpModule
- Öröklődés
-
WindowsAuthenticationModule
- Megvalósítás
Példák
Az alábbi példakód az WindowsAuthentication_OnAuthenticate esemény használatával állítja be az User aktuális HttpContext tulajdonságot egy egyéni IPrincipal objektumra.
public void WindowsAuthentication_OnAuthenticate(object sender, WindowsAuthenticationEventArgs args)
{
if (!args.Identity.IsAnonymous)
{
args.User = new Samples.AspNet.Security.MyPrincipal(args.Identity);
}
}
Public Sub WindowsAuthentication_OnAuthenticate(sender As Object, args As WindowsAuthenticationEventArgs)
If Not args.Identity.IsAnonymous Then
args.User = New Samples.AspNet.Security.MyPrincipal(args.Identity)
End If
End Sub
Megjegyzések
Ha a hitelesítési ModeWindows értékre van állítva, a WindowsAuthenticationModule az aktuális UserHttpContext tulajdonságát egy IPrincipal objektumra állítja, amely az IIS által az aktuális kéréshez megadott Windows identitást jelöli. Ha az IIS névtelen hitelesítést használ, akkor a WindowsAuthenticationModule metódus által visszaadott identitást GetAnonymous használja.
Az WindowsAuthenticationModule esemény olyan eseményt Authenticate tesz elérhetővé, amely lehetővé teszi, hogy egyéni IPrincipal objektumot adjon meg az User aktuális HttpContexttulajdonsághoz. A Authenticate esemény egy WindowsAuthentication_OnAuthenticate nevű alrutin megadásával érhető el a ASP.NET-alkalmazás Global.asax fájljában.
Note
Az IIS 7.0-ban az WindowsAuthenticationModule osztály használata az FormsAuthenticationModule osztálysal nem támogatott. Az integrált módban előforduló kompatibilitási problémákról további információt a Az ASP.NET-alkalmazások IIS 6.0-ról IIS 7.0-ra történő csatlakoztatása című témakörben talál.
Konstruktorok
| Name | Description |
|---|---|
| WindowsAuthenticationModule() |
Létrehozza a WindowsAuthenticationModule osztály példányát. |
Metódusok
| Name | Description |
|---|---|
| Dispose() |
Felszabadítja az összes erőforrást, a memória kivételével, amelyet a WindowsAuthenticationModulerendszer használ. |
| Equals(Object) |
Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object) |
| GetHashCode() |
Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object) |
| GetType() |
Lekéri az Type aktuális példányt. (Öröklődés forrása Object) |
| Init(HttpApplication) |
Inicializálja a WindowsAuthenticationModule objektumot. |
| MemberwiseClone() |
Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object) |
| ToString() |
Az aktuális objektumot jelképező sztringet ad vissza. (Öröklődés forrása Object) |
esemény
| Name | Description |
|---|---|
| Authenticate |
Akkor fordul elő, ha az alkalmazás hitelesíti az aktuális kérést. |