Roles.ApplicationName Właściwość

Definicja

Pobiera lub ustawia nazwę aplikacji do przechowywania i pobierania informacji o roli dla programu.Gets or sets the name of the application to store and retrieve role information for.

public:
 static property System::String ^ ApplicationName { System::String ^ get(); void set(System::String ^ value); };
public static string ApplicationName { get; set; }
member this.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 dla programu.The name of the application to store and retrieve role information for.

Przykłady

Poniższy przykład pokazuje element roleManager w system.web sekcji Web.config pliku dla aplikacji ASP.NET.The following example shows the roleManager element in the system.web section of the Web.config file for an ASP.NET application. Określa, że aplikacja używa SqlRoleProvider wystąpienia i ustawia applicationName atrybut na MyApplication .It specifies that the application uses a SqlRoleProvider instance and sets the applicationName attribute to 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

Ta ApplicationName Właściwość jest używana przez Roles klasę do kojarzenia użytkowników i ról z różnymi aplikacjami.The ApplicationName property is used by the Roles class to associate users and roles with different applications. Dzięki temu wiele aplikacji może korzystać z tego samego źródła danych w celu przechowywania informacji o użytkownikach i rolach bez rozwiązywania konfliktów między zduplikowanymi nazwami użytkowników lub zduplikowanymi nazwami ról.This enables multiple applications to use the same data source to store user and role information without running into conflicts between duplicate user names or duplicate role names. 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.Multiple ASP.NET applications can use the same data source by specifying the same value in the ApplicationName property. Można ustawić ApplicationName właściwość programowo lub można ustawić ją w sposób deklaratywny w pliku konfiguracji dla aplikacji sieci Web przy użyciu applicationName atrybutu.You can set the ApplicationName property programmatically, or you can set it declaratively in the configuration file for the Web application by using the applicationName attribute.

Jeśli aplikacja sieci Web używa klasy, SqlRoleProvider a dla applicationName atrybutu w pliku konfiguracji nie określono wartości, HttpRequest.ApplicationPath HttpContext.Request zostanie użyta wartość właściwości bieżącej właściwości.If your Web application is using the SqlRoleProvider class and a value is not specified for the applicationName attribute in the configuration file, the HttpRequest.ApplicationPath property value for the current HttpContext.Request property is used.

Przestroga

Ponieważ pojedyncze domyślne wystąpienie dostawcy roli jest używane dla wszystkich żądań obsłużonych przez HttpApplication obiekt, można wykonywać wiele żądań jednocześnie i próbować ustawić ApplicationName wartość właściwości.Because a single default role provider instance is used for all of the requests served by an HttpApplication object, you can have multiple requests executing concurrently and attempting to set the ApplicationName property value. ApplicationNameWłaściwość nie jest bezpieczna wątkowo dla wielu zapisów, a zmiana ApplicationName wartości właściwości może spowodować nieoczekiwane zachowanie dla wielu użytkowników aplikacji.The ApplicationName property is not thread safe for multiple writes, and changing the ApplicationName property value can result in unexpected behavior for multiple users of an application. Należy unikać pisania kodu, aby umożliwić użytkownikom ustawianie ApplicationName właściwości, chyba że jest to wymagane.You should avoid writing code to allow users to set the ApplicationName property, unless required. Przykładem aplikacji, w której ustawienie ApplicationName właściwości może być wymagane, jest aplikacja administracyjna, która zarządza danymi roli dla wielu aplikacji.An example of an application where setting the ApplicationName property may be required is an administrative application that manages role data for multiple applications. Taka aplikacja powinna być aplikacją pojedynczego użytkownika, a nie aplikacją sieci Web.Such an application should be a single-user application and not a Web application.

Dotyczy

Zobacz też