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
| Name | Beschreibung |
|---|---|
| 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. Verwendet 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
Ein ProfileBase Wert, der das Profil für den angegebenen Benutzer darstellt.
Ausnahmen
Das enabled Attribut des Profilabschnitts der datei Web.config ist false.
Die aktuelle Hostingberechtigungsstufe ist kleiner als Medium.
Ein im Profilabschnitt der Web.config Datei angegebener Eigenschaftstyp konnte nicht erstellt werden.
-oder-
Das allowAnonymous Attribut für eine Eigenschaft im Profilabschnitt der datei Web.config wird auf und true das enabled Attribut des <anonymousIdentification-Elements> auf festgelegt false.
-oder-
Das serializeAs Attribut für eine Eigenschaft im Profilabschnitt der Web.config Datei wird auf Binary und die IsSerializable Eigenschaft der angegebenen type Rückgaben falsefestgelegt.
-oder-
Der Name eines anbieters, der mithilfe des provider Attributs einer Profileigenschaft angegeben wurde, wurde in der Providers Auflistung nicht gefunden.
-oder-
Die type angegebene Eigenschaft für eine Profileigenschaft wurde nicht gefunden.
-oder-
Eine Profileigenschaft wurde mit einem Namen angegeben, der einem Eigenschaftsnamen in der basisklasse entspricht, die inherits im Attribut des Profilabschnitts angegeben ist.
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 methode Create erstellt und initialisiert eine neue Profilinstanz und ist nützlich für Anwendungen, die ein benutzerdefiniertes Profilobjekt verwenden oder Benutzerprofile in einer Umgebung ohne ASP.NET verwalten.
Bei dieser Überladung der Create Methode wird davon ausgegangen, dass der angegebene Benutzername ein authentifizierter Benutzer ist.
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. Verwendet 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 Profilabschnitts der datei Web.config ist false.
Die aktuelle Hostingberechtigungsstufe ist kleiner als Medium.
Ein im Profilabschnitt der Web.config Datei angegebener Eigenschaftstyp konnte nicht erstellt werden.
-oder-
Das allowAnonymous Attribut für eine Eigenschaft im Profilabschnitt der datei Web.config wird auf und true das enabled Attribut des <anonymousIdentification-Elements> auf festgelegt false.
-oder-
Das serializeAs Attribut für eine Eigenschaft im Profilabschnitt der Web.config Datei wird auf Binary und die IsSerializable Eigenschaft der angegebenen type Rückgaben falsefestgelegt.
-oder-
Der Name eines anbieters, der mithilfe des provider Attributs einer Profileigenschaft angegeben wurde, wurde in der Providers Auflistung nicht gefunden.
-oder-
Die type angegebene Eigenschaft für eine Profileigenschaft wurde nicht gefunden.
-oder-
Eine Profileigenschaft wurde mit einem Namen angegeben, der einem Eigenschaftsnamen in der basisklasse entspricht, die inherits im Attribut des Profilabschnitts angegeben ist.
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 methode Create erstellt und initialisiert eine neue Profilinstanz und ist nützlich für Anwendungen, die ein benutzerdefiniertes Profilobjekt verwenden oder Benutzerprofile in einer Umgebung ohne ASP.NET verwalten.
Diese Überladung der Create Methode kann verwendet werden, um ein Profil für einen authentifizierten Benutzer oder einen anonymen Benutzer zu erstellen.
