SqlMembershipProvider.ApplicationName Proprietà

Definizione

Spazio dei nomi:

System.Web.Security

Assembly:

System.Web.dll

Ottiene o imposta il nome dell'applicazione per cui archiviare e recuperare informazioni di appartenenza.

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

Valore della proprietà

String

Nome dell'applicazione per cui archiviare e recuperare le informazioni di appartenenza. Il valore predefinito è il valore della proprietà ApplicationPath per la proprietà Request corrente.

Eccezioni

ArgumentException

Si è tentato di impostare la proprietà ApplicationName su una stringa vuota o su null.

ProviderException

È stato effettuato un tentativo di impostare la proprietà ApplicationName su una stringa la cui lunghezza supera i 256 caratteri.

Esempio

Nell'esempio di codice seguente viene illustrato l'elemento di appartenenza nella system.web sezione del file Web.config per un'applicazione ASP.NET. Specifica l'istanza dell'applicazione SqlMembershipProvider e imposta su ApplicationNameMyApplication.

<membership defaultProvider="SqlProvider" userIsOnlineTimeWindow="20">  
  <providers>  
    <add name="SqlProvider"  
      type="System.Web.Security.SqlMembershipProvider"  
      connectionStringName="SqlServices"  
      enablePasswordRetrieval="true"  
      enablePasswordReset="false"  
      requiresQuestionAndAnswer="true"  
      passwordFormat="Encrypted"  
      applicationName="MyApplication" />  
  </providers>  
</membership>  

Commenti

Viene usato dall'oggetto ApplicationNameSqlMembershipProvider per raggruppare le informazioni utente. Qualificando le informazioni utente con un nome applicazione, è possibile archiviare informazioni per più applicazioni in un singolo database senza incorrere in conflitti tra nomi utente duplicati. Inoltre, più applicazioni ASP.NET possono usare lo stesso database utente specificando lo stesso valore nella ApplicationName proprietà. La ApplicationName proprietà può essere impostata a livello di codice oppure può essere impostata in modo dichiarativo nel file di configurazione per l'applicazione Web con l'attributo applicationName .

Se un valore non viene specificato per l'attributo nel file di configurazione per l'applicazione applicationName Web, viene usato il ApplicationPath valore della proprietà per la prima richiesta effettuata all'applicazione.

Attenzione

Poiché un'unica istanza del provider di appartenenza predefinita viene usata per tutte le richieste gestite da un HttpApplication oggetto, è possibile avere più richieste in esecuzione simultaneamente e tentare di impostare il valore della ApplicationName proprietà. La ApplicationName proprietà non è thread safe per più scritture e la modifica del valore della ApplicationName proprietà può comportare un comportamento imprevisto per più utenti di un'applicazione. È consigliabile evitare di scrivere codice per consentire agli utenti di impostare la ApplicationName proprietà a meno che non sia necessario. Un esempio di applicazione in cui l'impostazione della ApplicationName proprietà può essere necessaria è un'applicazione amministrativa che gestisce i dati di appartenenza per più applicazioni. Tale applicazione deve essere un'applicazione a utente singolo e non un'applicazione Web.

Vedi anche

• Introduzione all'appartenenza a ASP.NET