SqlRoleProvider Kelas

Referensi

Definisi

Ruang nama:: System.Web.Security

Rakitan:: System.Web.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Mengelola penyimpanan informasi keanggotaan peran untuk aplikasi ASP.NET dalam database SQL Server.

public ref class SqlRoleProvider : System::Web::Security::RoleProvider

public class SqlRoleProvider : System.Web.Security.RoleProvider

type SqlRoleProvider = class
    inherit RoleProvider

Public Class SqlRoleProvider
Inherits RoleProvider

Warisan: Object

ProviderBase

RoleProvider
SqlRoleProvider

Contoh

Contoh berikut menunjukkan file Web.config untuk aplikasi ASP.NET yang dikonfigurasi untuk menggunakan SqlRoleProvider objek dan SqlMembershipProvider. Elemen dikonfigurasi authorization untuk hanya mengizinkan akses ke pengguna yang diautentikasi dalam peran Administrator.

<configuration>
  <connectionStrings>
    <add name="SqlServices" connectionString="Data Source=localhost;Integrated Security=SSPI;Initial Catalog=aspnetdb;" />
  </connectionStrings>
  <system.web>
    <authentication mode="Forms" >
      <forms loginUrl="logincs.aspx"
      name=".ASPXFORMSAUTH" />
    </authentication>
    <authorization>
      <deny users="?" />
      <allow roles="Administrators" />
      <deny users="*" />
    </authorization>
    <membership defaultProvider="SqlProvider" userIsOnlineTimeWindow="15">
      <providers>
        <add
          name="SqlProvider"
          type="System.Web.Security.SqlMembershipProvider"
          connectionStringName="SqlServices"
          enablePasswordRetrieval="false"
          enablePasswordReset="false"
          requiresQuestionAndAnswer="false"
          passwordFormat="Hashed"
          applicationName="SampleApplication" />
      </providers>
    </membership>
    <roleManager defaultProvider="SqlProvider"
      enabled="true"
      cacheRolesInCookie="true"
      cookieName=".ASPROLES"
      cookieTimeout="30"
      cookiePath="/"
      cookieRequireSSL="true"
      cookieSlidingExpiration="true"
      cookieProtection="All" >
      <providers>
        <add
          name="SqlProvider"
          type="System.Web.Security.SqlRoleProvider"
          connectionStringName="SqlServices"
          applicationName="SampleApplication" />
      </providers>
    </roleManager>
  </system.web>
</configuration>

Keterangan

Kelas ini digunakan oleh Roles kelas dan RolePrincipal untuk menyediakan layanan manajemen peran untuk aplikasi ASP.NET menggunakan database SQL Server. Anda dapat menggunakan manajemen peran untuk menentukan tingkat otorisasi yang berbeda untuk aplikasi Anda.

Untuk menggunakan SqlRoleProvider kelas , Anda harus terlebih dahulu membuat database SQL Server yang SqlRoleProviderdigunakan oleh . Untuk membuat database yang digunakan oleh SqlRoleProvider kelas , jalankan aspnet_regsql.exe executable yang ditemukan di folder C:\WINDOWS\Microsoft.NET\Framework\ versionNumber dan tentukan -Ar opsi (misalnya, aspnet_regsql.exe -Ar). Database yang dibuat disebut Aspnetdb. Atau, jalankan aspnet_regsql.exe untuk menarik mode konfigurasi GUI dan pilih untuk mengonfigurasi semua fitur ASP.NET.

Jika penyedia peran dikonfigurasi dengan string koneksi yang menggunakan keamanan terintegrasi, akun proses aplikasi ASP.NET harus memiliki hak untuk terhubung ke database SQL Server.

File Machine.config dikonfigurasi dengan SqlRoleProvider instans bernama AspNetSqlProvider yang terhubung ke SQL Server di komputer lokal. Anda dapat menggunakan instans penyedia ini, atau menentukan sendiri dalam file Web.config untuk aplikasi ASP.NET Anda. Untuk menggunakan instans AspNetSqlProvider, tentukan AspNetSqlProvider sebagai dalam defaultProvider konfigurasi Anda.

Anda dapat mengonfigurasi SqlRoleProvider untuk menggunakan database dan informasi pengguna yang sama dengan SqlMembershipProvider untuk menggunakan database tunggal untuk informasi autentikasi dan otorisasi. Untuk menggunakan database yang sama untuk keanggotaan dan informasi peran, jalankan aspnet_regsql.exe yang dapat dieksekusi dan instal fitur keanggotaan. Kemudian, tentukan string koneksi yang sama dalam konfigurasi Anda untuk instans dan SqlMembershipProvider AndaSqlRoleProvider. Pastikan juga bahwa kedua instans penyedia dikonfigurasi dengan yang sama ApplicationName.

Konstruktor

SqlRoleProvider()

Membuat instans SqlRoleProvider kelas .

Properti

ApplicationName	Mendapatkan atau menetapkan nama aplikasi untuk menyimpan dan mengambil informasi peran.
Description	Mendapatkan deskripsi singkat dan ramah yang cocok untuk ditampilkan di alat administratif atau antarmuka pengguna (UI) lainnya. (Diperoleh dari ProviderBase)
Name	Mendapatkan nama ramah yang digunakan untuk merujuk ke penyedia selama konfigurasi. (Diperoleh dari ProviderBase)

Metode

AddUsersToRoles(String[], String[])	Menambahkan nama pengguna yang ditentukan ke setiap peran yang ditentukan.
CreateRole(String)	Menambahkan peran baru ke database peran.
DeleteRole(String, Boolean)	Menghapus peran dari database peran.
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
FindUsersInRole(String, String)	Mendapatkan array nama pengguna dalam peran di mana nama pengguna berisi nama pengguna yang ditentukan untuk dicocokkan.
GetAllRoles()	Mendapatkan daftar semua peran untuk aplikasi.
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetRolesForUser(String)	Mendapatkan daftar peran tempat pengguna berada.
GetType()	Mendapatkan dari instans Type saat ini. (Diperoleh dari Object)
GetUsersInRole(String)	Mendapatkan daftar pengguna dalam peran yang ditentukan.
Initialize(String, NameValueCollection)	Menginisialisasi penyedia peran SQL Server dengan nilai properti yang ditentukan dalam file konfigurasi aplikasi ASP.NET. Metode ini tidak dimaksudkan untuk digunakan langsung dari kode Anda.
IsUserInRole(String, String)	Mendapatkan nilai yang menunjukkan apakah pengguna yang ditentukan berada dalam peran yang ditentukan.
MemberwiseClone()	Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object)
RemoveUsersFromRoles(String[], String[])	Menghapus nama pengguna yang ditentukan dari peran yang ditentukan.
RoleExists(String)	Mendapatkan nilai yang menunjukkan apakah nama peran yang ditentukan sudah ada dalam database peran.
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Berlaku untuk

Lihat juga

Memahami ASP.NET Role Management

Bagikan melalui