RoleServiceManager Klasse

Referenz

Definition

Namespace:: System.Web.UI

Assembly:: System.Web.Extensions.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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: Object
RoleServiceManager

Attribute: TypeConverterAttribute

Hinweise

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

Der Rollenwebdienst wird von AJAX-fähigen Anwendungen verwendet, um Rolleninformationen für den aktuellen authentifizierten Benutzer mithilfe eines asynchronen Webdienstaufrufs abzurufen. Sie können verwenden RoleServiceManager , um den Pfad einer alternativen Implementierung des Rollenwebdiensts bereitzustellen, anstatt den integrierten Webdienst zu verwenden.

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

Um einen benutzerdefinierten Rollendienst zu erstellen, müssen Sie einen Webdienst implementieren, der über zwei Methoden verfügt: GetRolesForCurrentUser und IsCurrentUserInRole. Diese Methoden müssen dieselbe Signatur wie die entsprechenden Methoden des integrierten Rollenwebdiensts aufweisen.

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 im Markup hinzufügen, indem Sie ein RoleService Element im ScriptManager Steuerelement platzieren, 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 so festlegen, dass sie einen benutzerdefinierten Rollenwebdienst verwendet.

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:

Freigeben über