ProfileBase.Create Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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.ProfileBasePublic Shared Function Create (username As String) As ProfileBaseParameter
- 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 nicht ASP.NET Umgebung verwalten.
Diese Überladung der Create Methode geht davon aus, dass der angegebene Benutzername ein authentifizierter Benutzer ist.
Siehe auch
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.ProfileBasePublic Shared Function Create (username As String, isAuthenticated As Boolean) As ProfileBaseParameter
- 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 nicht 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.