ProfileBase.Create Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Crée une instance d'un profil utilisateur.
Surcharges
| Create(String) |
Utilisé par ASP.NET afin de créer une instance d'un profil pour le nom d'utilisateur spécifié. |
| Create(String, Boolean) |
Utilisé par ASP.NET afin de créer une instance d'un profil pour le nom d'utilisateur spécifié. Prend un paramètre qui indique si l'utilisateur est authentifié ou anonyme. |
Create(String)
Utilisé par ASP.NET afin de créer une instance d'un profil pour le nom d'utilisateur spécifié.
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 ProfileBaseParamètres
- username
- String
Nom de l'utilisateur pour lequel créer un profil.
Retours
ProfileBase représentant le profil de l'utilisateur spécifié.
Exceptions
L’attribut enabled de la section profile du fichier Web.config est false.
Le niveau d'autorisation d'hébergement en cours est inférieur à Medium.
Un type de propriété spécifié dans la section profile du fichier Web.config n’a pas pu être créé.
- ou -
L’attribut allowAnonymous d’une propriété de la section profile du fichier Web.config est défini avec la valeur true, tandis que l’attribut enabled de l’élément <anonymousIdentification> est défini avec la valeur false.
- ou -
L’attribut serializeAs d’une propriété de la section profile du fichier Web.config est défini avec la valeur Binary et la propriété IsSerializable du type spécifié retourne false.
- ou -
Le nom d'un fournisseur spécifié à l'aide de l'attribut provider d'une propriété de profil est introuvable dans la collection Providers.
- ou -
Impossible de trouver le type spécifié d'une propriété de profil.
- ou -
Une propriété de profil a été spécifiée avec un nom qui correspond à un nom de propriété de la classe de base spécifiée dans l’attribut inherits de la section profile.
Exemples
L’exemple de code suivant crée une instance d’un objet de profil personnalisé, définit une propriété et enregistre le profil dans la source de données.
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()
Remarques
La Create méthode crée et initialise une nouvelle instance de profil et est utile pour les applications qui utilisent un objet de profil personnalisé ou gèrent des profils utilisateur dans un environnement non ASP.NET.
Cette surcharge de la Create méthode suppose que le nom d’utilisateur spécifié est un utilisateur authentifié.
Voir aussi
S’applique à
Create(String, Boolean)
Utilisé par ASP.NET afin de créer une instance d'un profil pour le nom d'utilisateur spécifié. Prend un paramètre qui indique si l'utilisateur est authentifié ou anonyme.
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 ProfileBaseParamètres
- username
- String
Nom de l'utilisateur pour lequel créer un profil.
- isAuthenticated
- Boolean
true pour indiquer que l'utilisateur est authentifié ; false pour indiquer que l'utilisateur est anonyme.
Retours
Objet ProfileBase représentant le profil de l'utilisateur spécifié.
Exceptions
L’attribut enabled de la section profile du fichier Web.config est false.
Le niveau d'autorisation d'hébergement en cours est inférieur à Medium.
Un type de propriété spécifié dans la section profile du fichier Web.config n’a pas pu être créé.
- ou -
L’attribut allowAnonymous d’une propriété de la section profile du fichier Web.config est défini avec la valeur true, tandis que l’attribut enabled de l’élément <anonymousIdentification> est défini avec la valeur false.
- ou -
L’attribut serializeAs d’une propriété de la section profile du fichier Web.config est défini avec la valeur Binary et la propriété IsSerializable du type spécifié retourne false.
- ou -
Le nom d'un fournisseur spécifié à l'aide de l'attribut provider d'une propriété de profil est introuvable dans la collection Providers.
- ou -
Impossible de trouver le type spécifié d'une propriété de profil.
- ou -
Une propriété de profil a été spécifiée avec un nom qui correspond à un nom de propriété de la classe de base spécifiée dans l’attribut inherits de la section profile.
Exemples
L’exemple de code suivant crée une instance d’un objet de profil personnalisé, définit une propriété et enregistre le profil dans la source de données.
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()
Remarques
La Create méthode crée et initialise une nouvelle instance de profil et est utile pour les applications qui utilisent un objet de profil personnalisé ou gèrent des profils utilisateur dans un environnement non ASP.NET.
Cette surcharge de la Create méthode peut être utilisée pour créer un profil pour un utilisateur authentifié ou un utilisateur anonyme.