Freigeben über


ProfileBase.Create Methode

Definition

Erstellt eine Instanz eines Benutzerprofils.

Überlädt

Create(String)

Wird von ASP.NET verwendet, um eine Instanz eines Profils für den angegebenen Benutzernamen zu erstellen.

Create(String, Boolean)

Wird von ASP.NET verwendet, um eine Instanz eines Profils für den angegebenen Benutzernamen zu erstellen. Akzeptiert einen Parameter, der angibt, ob der Benutzer authentifiziert oder anonym ist.

Create(String)

Wird von ASP.NET verwendet, um eine Instanz eines Profils für den angegebenen Benutzernamen zu erstellen.

public:
 static System::Web::Profile::ProfileBase ^ Create(System::String ^ username);
public static System.Web.Profile.ProfileBase Create (string username);
static member Create : string -> System.Web.Profile.ProfileBase
Public Shared Function Create (username As String) As ProfileBase

Parameter

username
String

Der Name des Benutzers, für den ein Profil erstellt werden soll.

Gibt zurück

Eine ProfileBase, die das Profil für den angegebenen Benutzer darstellt.

Ausnahmen

Das enabled-Attribut des profile-Abschnitts der Datei „Web.config“ ist false.

Die aktuelle Berechtigungsebene für Hosting ist niedriger als Medium.

Ein im Abschnitt profile der Datei „Web.config“ angegebener Eigenschaftentyp konnte nicht erstellt werden.

- oder -

Das allowAnonymous-Attribut für eine Eigenschaft im Abschnitt profile der Datei „Web.config“ ist auf true festgelegt, und das enabled-Attribut des <anonymousIdentification>-Elements ist auf false festgelegt.

- oder -

Das serializeAs-Attribut für eine Eigenschaft im Abschnitt profile der Datei „Web.config“ ist auf Binary festgelegt, und die IsSerializable-Eigenschaft vom angegebenen type gibt false zurück.

- oder -

Der mithilfe des provider-Attributs einer Profileigenschaft angegebene Name eines Anbieters konnte nicht in der Providers-Auflistung gefunden werden.

- oder -

Der für eine Profileigenschaft angegebene type konnte nicht gefunden werden.

- oder -

Es wurde eine Profileigenschaft mit einem Namen angegeben, der einem Eigenschaftennamen für die im inherits-Attribut des Abschnitts profile angegebene Basisklasse entspricht.

Beispiele

Im folgenden Codebeispiel wird eine Instanz eines benutzerdefinierten Profilobjekts erstellt, eine Eigenschaft festgelegt und das Profil in der Datenquelle gespeichert.

MyCustomProfile myProfile = (MyCustomProfile)ProfileBase.Create("username");
myProfile.ZipCode = "98052";
myProfile.Save();
Dim myProfile As MyCustomProfile = CType(ProfileBase.Create("username"), MyCustomProfile)
myProfile.ZipCode = "98052"
myProfile.Save()

Hinweise

Die Create Methode erstellt und initialisiert eine neue Profilinstanz und ist nützlich für Anwendungen, die ein benutzerdefiniertes Profilobjekt verwenden oder Benutzerprofile in einer non-ASP.NET Umgebung verwalten.

Bei dieser Überladung der Create Methode wird davon ausgegangen, dass es sich bei dem angegebenen Benutzernamen um einen authentifizierten Benutzer handelt.

Weitere Informationen

Gilt für:

Create(String, Boolean)

Wird von ASP.NET verwendet, um eine Instanz eines Profils für den angegebenen Benutzernamen zu erstellen. Akzeptiert einen Parameter, der angibt, ob der Benutzer authentifiziert oder anonym ist.

public:
 static System::Web::Profile::ProfileBase ^ Create(System::String ^ username, bool isAuthenticated);
public static System.Web.Profile.ProfileBase Create (string username, bool isAuthenticated);
static member Create : string * bool -> System.Web.Profile.ProfileBase
Public Shared Function Create (username As String, isAuthenticated As Boolean) As ProfileBase

Parameter

username
String

Der Name des Benutzers, für den ein Profil erstellt werden soll.

isAuthenticated
Boolean

true, um anzugeben, dass der Benutzer authentifiziert ist. false, um anzugeben, dass der Benutzer anonym ist.

Gibt zurück

Ein ProfileBase-Objekt, das das Profil für den angegebenen Benutzer darstellt.

Ausnahmen

Das enabled-Attribut des profile-Abschnitts der Datei „Web.config“ ist false.

Die aktuelle Berechtigungsebene für Hosting ist niedriger als Medium.

Ein im Abschnitt profile der Datei „Web.config“ angegebener Eigenschaftentyp konnte nicht erstellt werden.

- oder -

Das allowAnonymous-Attribut für eine Eigenschaft im Abschnitt profile der Datei „Web.config“ ist auf true festgelegt, und das enabled-Attribut des <anonymousIdentification>-Elements ist auf false festgelegt.

- oder -

Das serializeAs-Attribut für eine Eigenschaft im Abschnitt profile der Datei „Web.config“ ist auf Binary festgelegt, und die IsSerializable-Eigenschaft vom angegebenen type gibt false zurück.

- oder -

Der mithilfe des provider-Attributs einer Profileigenschaft angegebene Name eines Anbieters konnte nicht in der Providers-Auflistung gefunden werden.

- oder -

Der für eine Profileigenschaft angegebene type konnte nicht gefunden werden.

- oder -

Es wurde eine Profileigenschaft mit einem Namen angegeben, der einem Eigenschaftennamen für die im inherits-Attribut des Abschnitts profile angegebene Basisklasse entspricht.

Beispiele

Im folgenden Codebeispiel wird eine Instanz eines benutzerdefinierten Profilobjekts erstellt, eine Eigenschaft festgelegt und das Profil in der Datenquelle gespeichert.

MyCustomProfile profile = (MyCustomProfile)ProfileBase.Create("username", true);
profile.ZipCode = "98052";
profile.Save();
Dim profile As MyCustomProfile = CType(ProfileBase.Create("username", True), MyCustomProfile)
profile.ZipCode = "98052"
profile.Save()

Hinweise

Die Create Methode erstellt und initialisiert eine neue Profilinstanz und ist nützlich für Anwendungen, die ein benutzerdefiniertes Profilobjekt verwenden oder Benutzerprofile in einer non-ASP.NET Umgebung verwalten.

Diese Überladung der Create Methode kann verwendet werden, um ein Profil für einen authentifizierten Benutzer oder einen anonymen Benutzer zu erstellen.

Weitere Informationen

Gilt für: