SqlRoleProvider.ApplicationName Properti

Definisi

Ruang nama:

System.Web.Security

Rakitan:

System.Web.dll

Mendapatkan atau menetapkan nama aplikasi untuk menyimpan dan mengambil informasi peran.

public:
 virtual property System::String ^ ApplicationName { System::String ^ get(); void set(System::String ^ value); };

public override string ApplicationName { get; set; }

member this.ApplicationName : string with get, set

Public Overrides Property ApplicationName As String

Nilai Properti

String

Nama aplikasi untuk menyimpan dan mengambil informasi peran. Defaultnya ApplicationPath adalah nilai properti untuk saat ini Request.

Pengecualian

HttpException

Upaya dilakukan untuk mengatur ApplicationName properti oleh penelepon yang tidak memiliki High izin hosting ASP.NET.

ProviderException

Upaya dilakukan untuk mengatur ke ApplicationName string yang lebih panjang dari 256 karakter.

Contoh

Contoh berikut menunjukkan roleManager elemen di bagian system.web file Web.config untuk aplikasi ASP.NET. Ini menentukan instans aplikasi SqlRoleProvider dan mengatur ApplicationName properti ke MyApplication.

<roleManager defaultProvider="SqlProvider"
  enabled="true"
  cacheRolesInCookie="true"
  cookieName=".ASPROLES"
  cookieTimeout="30"
  cookiePath="/"
  cookieRequireSSL="false"
  cookieSlidingExpiration="true"
  cookieProtection="All" >
  <providers>
    <add
      name="SqlProvider"
      type="System.Web.Security.SqlRoleProvider"
      connectionStringName="SqlServices"
      applicationName="MyApplication" />
  </providers>
</roleManager>

Keterangan

ApplicationName digunakan oleh SqlRoleProvider untuk mengaitkan pengguna dan peran dengan aplikasi yang berbeda. Ini memungkinkan beberapa aplikasi untuk menggunakan database yang sama untuk menyimpan informasi pengguna dan peran tanpa mengalami konflik antara nama pengguna duplikat atau nama peran. Beberapa aplikasi ASP.NET dapat menggunakan database yang sama dengan menentukan nilai yang sama dalam ApplicationName properti . ApplicationName Properti dapat diatur secara terprogram, atau dapat diatur secara deklaratif dalam file konfigurasi untuk aplikasi Web menggunakan applicationName atribut .

Jika nilai tidak ditentukan untuk applicationName atribut dalam file konfigurasi untuk aplikasi Web, maka HttpRequest.ApplicationPath nilai properti untuk objek saat ini HttpContext.Request digunakan.

Perhatian

Karena satu instans penyedia peran default digunakan untuk semua permintaan yang HttpApplication dilayani oleh objek, Anda dapat memiliki beberapa permintaan yang dijalankan secara bersamaan dan mencoba mengatur ApplicationName nilai properti. Properti ApplicationName tidak aman untuk beberapa penulisan, dan mengubah ApplicationName nilai properti dapat mengakibatkan perilaku tak terduga untuk beberapa pengguna aplikasi. Disarankan agar Anda menghindari penulisan kode yang memungkinkan pengguna untuk mengatur ApplicationName properti kecuali Anda harus. Contoh aplikasi di mana pengaturan ApplicationName properti mungkin diperlukan adalah aplikasi administratif yang mengelola data peran untuk beberapa aplikasi. Aplikasi seperti itu harus menjadi aplikasi pengguna tunggal dan bukan aplikasi Web.

Lihat juga

• Memahami Manajemen Peran ASP.NET