SqlMembershipProvider.ApplicationName Eigenschap

Definitie

Naamruimte:
System.Web.Security
Assembly:
System.Web.dll

Hiermee wordt de naam van de toepassing opgehaald of ingesteld om lidmaatschapsgegevens voor op te slaan en op te halen.

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

Waarde van eigenschap

String

De naam van de toepassing voor het opslaan en ophalen van lidmaatschapsgegevens. De standaardwaarde is de ApplicationPath eigenschapswaarde voor de huidige Request.

Uitzonderingen

ArgumentException

Er is geprobeerd de ApplicationName eigenschap in te stellen op een lege tekenreeks of null.

ProviderException

Er is geprobeerd de ApplicationName eigenschap in te stellen op een tekenreeks die langer is dan 256 tekens.

Voorbeelden

In het volgende codevoorbeeld ziet u het element lidship in de sectie system.web van het Web.config-bestand voor een ASP.NET-toepassing. Hiermee geeft u het exemplaar van SqlMembershipProvider de toepassing op en stelt u het in ApplicationName op 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>

Opmerkingen

De ApplicationName gegevens worden door de groep SqlMembershipProvider gebruikt om gebruikersgegevens te groeperen. Door in aanmerking te komen voor gebruikersgegevens met een toepassingsnaam, kunt u informatie opslaan voor meerdere toepassingen in één database zonder conflicten tussen dubbele gebruikersnamen op te lopen. Bovendien kunnen meerdere ASP.NET toepassingen dezelfde gebruikersdatabase gebruiken door dezelfde waarde op te geven in de eigenschap ApplicationName. De ApplicationName eigenschap kan programmatisch worden ingesteld of deze kan declaratief worden ingesteld in het configuratiebestand voor de webtoepassing met het applicationName kenmerk.

Als er geen waarde is opgegeven voor het kenmerk in het applicationName configuratiebestand voor de webtoepassing, wordt de ApplicationPath eigenschapswaarde voor de eerste aanvraag die bij de toepassing is ingediend, gebruikt.

Caution

Omdat één exemplaar van een standaardlidmaatschapsprovider wordt gebruikt voor alle aanvragen die door een HttpApplication object worden verwerkt, kunt u meerdere aanvragen tegelijk uitvoeren en proberen de ApplicationName eigenschapswaarde in te stellen. De ApplicationName eigenschap is niet thread veilig voor meerdere schrijfbewerkingen en het wijzigen van de ApplicationName eigenschapswaarde kan leiden tot onverwacht gedrag voor meerdere gebruikers van een toepassing. Het is raadzaam om te voorkomen dat u code schrijft om gebruikers toe te staan de ApplicationName eigenschap in te stellen, tenzij dat nodig is. Een voorbeeld van een toepassing waarbij het instellen van de ApplicationName eigenschap mogelijk vereist is, is een beheertoepassing waarmee lidmaatschapsgegevens voor meerdere toepassingen worden beheerd. Een dergelijke toepassing moet een toepassing met één gebruiker zijn en geen webtoepassing.

Van toepassing op

Zie ook