SqlMembershipProvider.ApplicationName Proprietà

  • Riferimento

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 ApplicationName MyApplication.

<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

L'oggetto ApplicationName viene utilizzato dall'oggetto SqlMembershipProvider per raggruppare le informazioni utente. Qualificando le informazioni utente con un nome di applicazione, è possibile archiviare le informazioni per più applicazioni in un singolo database senza entrare in conflitto 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 non viene specificato un valore per l'attributo applicationName nel file di configurazione per l'applicazione Web, viene usato il valore della ApplicationPath proprietà per la prima richiesta effettuata all'applicazione.

Attenzione

Poiché una singola istanza del provider di appartenenze 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 proprietà può comportare un ApplicationName 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.

Si applica a

Vedi anche