RoleServiceManager Klasse

Definition

Konfiguriert den Speicherort einer benutzerdefinierten Implementierung des Rollendiensts.

public ref class RoleServiceManager
[System.ComponentModel.TypeConverter(typeof(System.Web.UI.EmptyStringExpandableObjectConverter))]
public class RoleServiceManager
[<System.ComponentModel.TypeConverter(typeof(System.Web.UI.EmptyStringExpandableObjectConverter))>]
type RoleServiceManager = class
Public Class RoleServiceManager
Vererbung
RoleServiceManager
Attribute

Hinweise

Die RoleServiceManager Klasse entspricht der RoleService Eigenschaft des ScriptManager Steuerelements oder ScriptManagerProxy steuerelements.

Der Rollenwebdienst wird von AJAX-aktivierten Anwendungen verwendet, um Rolleninformationen für den aktuellen authentifizierten Benutzer mithilfe eines asynchronen Webdienstaufrufs abzurufen. Sie können den RoleServiceManager Pfad einer alternativen Implementierung des Rollenwebdiensts anstelle des integrierten Webdiensts bereitstellen.

Um den Rollendienst in Ihrer Anwendung zu verwenden, müssen Sie sie in der Konfigurationsdatei aktivieren und auf der Seite deklarieren. Wenn Sie den integrierten Rollenwebdienst verwenden, müssen Sie es aktivieren, aber Sie müssen den Rollendienst-Manager auf der Seite nicht explizit deklarieren.

Um einen benutzerdefinierten Rollendienst zu erstellen, müssen Sie einen Webdienst implementieren, der zwei Methoden enthält: GetRolesForCurrentUser und IsCurrentUserInRole. Diese Methoden müssen dieselbe Signatur haben wie die entsprechenden Methoden des integrierten Rollenwebdiensts.

Das folgende Beispiel zeigt die grundlegende Klassenstruktur, die in einer benutzerdefinierten Rollenwebdienstklasse implementiert werden muss.

Um einen benutzerdefinierten Rollenwebdienst zu verwenden, können Sie den Dienst deklarativ in Markup hinzufügen, indem Sie ein RoleService Element in das ScriptManager Steuerelement einfügen, wie im folgenden Beispiel gezeigt.

<asp:ScriptManager ID="SM1" runat="server">  
  <RoleService Path="MyRoleService.asmx" LoadRoles="true" />  
</asp:ScriptManager>  

Sie können die Path Eigenschaft auch programmgesteuert festlegen, um einen benutzerdefinierten Rollenwebdienst zu verwenden.

Konstruktoren

RoleServiceManager()

Initialisiert eine neue Instanz der RoleServiceManager-Klasse.

Eigenschaften

LoadRoles

Ruft einen Wert ab, der angibt, ob die Liste der Rollen für den derzeit angemeldeten Benutzer abgerufen werden soll, oder legt diesen Wert fest.

Path

Ruft den Pfad des Rollendiensts ab oder legt diesen fest.

Methoden

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)

Gilt für

Siehe auch