add-Element für providers für profile (ASP.NET-Einstellungsschema)

Artikel
08/10/2011

Fügt eine Profilanbieterinstanz zur Auflistung der Benutzerprofilanbieter hinzu.

Dieses Element ist neu in .NET Framework, Version 2.0.

<add 
    name="provider name" 
    type="fully qualified type reference"
    connectionStringName="connection string identifier"
    commandTimeout="number of seconds before a command times out"
    description="description of the provider instance"
    applicationName="application name for stored profile information" />

Attribute und Elemente

In den folgenden Abschnitten werden Attribute, untergeordnete Elemente und übergeordnete Elemente beschrieben.

Attribute

Attribute	Beschreibung
name	Erforderliches String-Attribut. Legt den Namen der Anbieterinstanz fest. Dieser Wert wird für das defaultProvider-Attribut des <profile>-Elements verwendet, um die Anbieterinstanz als Standardprofilanbieter zu identifizieren. Zur Indizierung des Anbieters in der Providers-Auflistung wird auch der name des Anbieters verwendet.
type	Erforderliches String-Attribut Gibt den Typ an, der die abstrakte ProfileProvider-Basisklasse implementiert.
connectionStringName	Erforderliches String-Attribut Gibt den Namen der im <connectionStrings>-Element definierten Verbindungszeichenfolge an. Die festgelegte Verbindungszeichenfolge wird vom hinzugefügten Anbieter verwendet.
applicationName	Optionales String-Attribut. Gibt den Anwendungsnamen an, unter dem Profildaten in der Datenquelle gespeichert werden. Der Anwendungsname ermöglicht mehreren ASP.NET-Anwendungen, die gleiche Datenbank zu nutzen, ohne auf doppelt vorhandene Profildaten unterschiedlicher Anwendungen zu stoßen. Alternativ dazu können mehrere ASP.NET-Anwendungen dieselbe Profilinformation durch Angabe desselben Anwendungsnamens verwenden. Die Profilanbieter in .NET Framework verwenden den ApplicationVirtualPath-Wert für die ApplicationName-Eigenschaft, falls dieses Attribut nicht angegeben ist.
commandTimeout	Optionales Int32-Attribut. Legt die Anzahl der Sekunden fest, nach denen ein an die Mitgliedschaftsdatenquelle ausgegebener Befehl aufgrund der angegebenen Zeitbeschränkung abgebrochen wird. Dieses Timeout wird vom SQL-Anbieter beim Erstellen von SqlCommand-Objekten verwendet. Dieses Attribut ist in der ASP.NET-Konfiguration nicht standardmäßig festgelegt. Deshalb wird der ADO.NET-Standard von 30 Sekunden verwendet. Wenn dieses Attribut festgelegt ist, verwendet der SQL-Anbieter den konfigurierten Timeoutwert für alle an die Datenbank ausgegebenen SQL-Befehle. Die Standardeinstellung ist 30 (ADO.NET-Standardeinstellung).
description	Optionales String-Attribut. Legt die Beschreibung der Profilanbieterinstanz fest.

Untergeordnete Elemente

Keine.

Übergeordnete Elemente

Element	Beschreibung
providers	Definiert eine Auflistung von Profilanbietern für das Benutzerprofil.
profile	Konfiguriert das Benutzerprofil für eine Anwendung.
configuration	Gibt das Stammelement in jeder Konfigurationsdatei an, die von der Common Language Runtime und den .NET Framework-Anwendungen verwendet wird.
system.web	Gibt das Stammelement für den ASP.NET-Konfigurationsabschnitt an.

Hinweise

Das add-Element zur Implementierung benutzerdefinierter Profilanbieter kann zusätzliche Attribute enthalten. Ein Beispiel finden Sie unter Gewusst wie: Erstellen und Ausführen des Beispiels für Profilanbieter.

Informationen darüber, wie Sie im Anwendungscode auf Konfigurationswerte für das profile-Element zugreifen und diese ändern können, finden Sie unter ProfileSection.

Standardkonfiguration

Das folgende profile-Standardelement wird in der Datei Machine.config von .NET Framework, Version 2.0, konfiguriert.

  <providers>
    <add name="AspNetSqlProfileProvider" connectionStringName="LocalSqlServer" applicationName="/" type="System.Web.Profile.SqlProfileProvider, System.Web, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" /> 
  </providers>

Beispiel

Das folgende Codebeispiel zeigt, wie Sie für eine ASP.NET-Anwendung eine Datei Web.config erstellen, die für die Verwendung eines SqlProfileProvider-Anbieters konfiguriert ist.

<configuration>
  <connectionStrings>
    <add name="SqlServices" connectionString="Data Source=localhost;Integrated Security=SSPI;Initial 
         Catalog=aspnetdb;" />
  </connectionStrings>

  <system.web>
    <authentication mode="Forms" >
      <forms loginUrl="login.aspx" name=".ASPXFORMSAUTH" />
    </authentication>

    <authorization>
      <deny users="?" />
    </authorization>

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

    <profile defaultProvider="SqlProvider">
      <providers>
        <clear />
        <add name="SqlProvider"
             type="System.Web.Profile.SqlProfileProvider"
             connectionStringName="SqlServices"
             applicationName="SampleApplication"
             description="SqlProfileProvider for SampleApplication" />
      </providers>

      <properties>
        <add name="ZipCode" />
        <add name="CityAndState" />
      </properties>
    </profile>
  </system.web>
</configuration>

Elementinformationen

Konfigurationsabschnittshandler	System.Web.Configuration.ProfileSection
Konfigurationsmember	ProfileSection.Providers
Konfigurierbare Speicherorte	Machine.config Web.config auf der Stammebene Web.config auf der Anwendungsebene
Anforderungen	Microsoft Internetinformationsdienste (IIS), Version 5.0, 5.1 oder 6.0 .NET Framework, Version 2.0 Microsoft Visual Studio 2005

Siehe auch

Freigeben über

add-Element für providers für profile (ASP.NET-Einstellungsschema)

Attribute und Elemente

Attribute

Untergeordnete Elemente

Übergeordnete Elemente

Hinweise

Standardkonfiguration

Beispiel

Elementinformationen

Siehe auch

Aufgaben

Referenz

Konzepte

Weitere Ressourcen

Zusätzliche Ressourcen