Roles.ApplicationName Właściwość

Definicja

Przestrzeń nazw:

System.Web.Security

Zestaw:

System.Web.dll

Pobiera lub ustawia nazwę aplikacji do przechowywania i pobierania informacji o roli.

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

public static string ApplicationName { get; set; }

static member ApplicationName : string with get, set

Public Shared Property ApplicationName As String

Wartość właściwości

String

Nazwa aplikacji do przechowywania i pobierania informacji o roli.

Przykłady

Poniższy przykład przedstawia element roleManager w system.web sekcji pliku Web.config dla aplikacji ASP.NET. Określa, że aplikacja używa SqlRoleProvider wystąpienia i ustawia applicationName atrybut na 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>

Uwagi

Właściwość ApplicationName jest używana przez klasę Roles do kojarzenie użytkowników i ról z różnymi aplikacjami. Dzięki temu wiele aplikacji może używać tego samego źródła danych do przechowywania informacji o użytkowniku i roli bez wystąpienia konfliktów między zduplikowanymi nazwami użytkowników lub zduplikowanymi nazwami ról. Wiele aplikacji ASP.NET może używać tego samego źródła danych, określając tę samą wartość we ApplicationName właściwości. Właściwość można ustawić ApplicationName programowo lub deklaratywnie ustawić ją w pliku konfiguracji aplikacji internetowej przy użyciu atrybutu applicationName .

Jeśli aplikacja internetowa używa SqlRoleProvider klasy, a wartość nie jest określona dla applicationName atrybutu w pliku konfiguracji, HttpRequest.ApplicationPath używana jest wartość właściwości bieżącej HttpContext.Request właściwości.

Przestroga

Ponieważ pojedyncze domyślne wystąpienie dostawcy ról jest używane dla wszystkich żądań obsługiwanych przez HttpApplication obiekt, można mieć wiele żądań wykonywanych jednocześnie i próbować ustawić ApplicationName wartość właściwości. Właściwość ApplicationName nie jest bezpieczna wątkiem dla wielu zapisów, a zmiana ApplicationName wartości właściwości może spowodować nieoczekiwane zachowanie wielu użytkowników aplikacji. Należy unikać pisania kodu, aby umożliwić użytkownikom ustawianie ApplicationName właściwości, chyba że jest to wymagane. Przykładem aplikacji, w której może być wymagane ustawienie ApplicationName właściwości, jest aplikacja administracyjna, która zarządza danymi roli dla wielu aplikacji. Taka aplikacja powinna być aplikacją pojedynczego użytkownika, a nie aplikacją internetową.

Zobacz też

• Omówienie zarządzania rolami ASP.NET