ProfileBase.Create Metoda

Definicja

Przestrzeń nazw:

System.Web.Profile

Zestaw:

System.Web.dll

Tworzy wystąpienie profilu użytkownika.

Przeciążenia

Create(String)	Używany przez ASP.NET do tworzenia wystąpienia profilu dla określonej nazwy użytkownika.
Create(String, Boolean)	Używany przez ASP.NET do tworzenia wystąpienia profilu dla określonej nazwy użytkownika. Przyjmuje parametr wskazujący, czy użytkownik jest uwierzytelniony, czy anonimowy.

Create(String)

Używany przez ASP.NET do tworzenia wystąpienia profilu dla określonej nazwy użytkownika.

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

Parametry

username

String

Nazwa użytkownika do utworzenia profilu.

Zwraca

ProfileBase

Element ProfileBase reprezentujący profil określonego użytkownika.

Wyjątki

ProviderException

Atrybut enabled sekcji profilu pliku Web.config to false.

HttpException

Bieżący poziom uprawnień hostingu jest mniejszy niż Medium.

ConfigurationErrorsException

Nie można utworzyć typu właściwości określonego w sekcji profilu pliku Web.config.

-lub-

Atrybut allowAnonymous właściwości w sekcji profilu pliku Web.config jest ustawiony na true , a enabled atrybut elementu <anonymousIdentification> ma wartość false.

-lub-

Atrybut serializeAs właściwości w sekcji profilu pliku Web.config jest ustawiony na Binary , a IsSerializable właściwość określonego type zwraca wartość false.

-lub-

Nie można odnaleźć nazwy dostawcy określonego przy użyciu provider atrybutu właściwości profilu w kolekcji Providers .

-lub-

type Nie można odnaleźć określonej właściwości profilu.

-lub-

Właściwość profilu została określona z nazwą zgodną z nazwą właściwości w klasie bazowej określonej w atrybucie inherits sekcji profilu .

Przykłady

Poniższy przykład kodu tworzy wystąpienie obiektu profilu niestandardowego, ustawia właściwość i zapisuje profil w źródle danych.

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()

Uwagi

Metoda Create tworzy i inicjuje nowe wystąpienie profilu i jest przydatna w przypadku aplikacji korzystających z niestandardowego obiektu profilu lub zarządzania profilami użytkowników w środowisku non-ASP.NET.

To przeciążenie Create metody zakłada, że określona nazwa użytkownika jest uwierzytelniony użytkownik.

Zobacz też

• Omówienie właściwości profilu ASP.NET

Create(String, Boolean)

Używany przez ASP.NET do tworzenia wystąpienia profilu dla określonej nazwy użytkownika. Przyjmuje parametr wskazujący, czy użytkownik jest uwierzytelniony, czy anonimowy.

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

Parametry

username

String

Nazwa użytkownika do utworzenia profilu.

isAuthenticated

Boolean

true aby wskazać, że użytkownik jest uwierzytelniony; false aby wskazać, że użytkownik jest anonimowy.

Zwraca

ProfileBase

ProfileBase Obiekt reprezentujący profil określonego użytkownika.

Wyjątki

ProviderException

Atrybut enabled sekcji profilu pliku Web.config to false.

HttpException

Bieżący poziom uprawnień hostingu jest mniejszy niż Medium.

ConfigurationErrorsException

Nie można utworzyć typu właściwości określonego w sekcji profilu pliku Web.config.

-lub-

Atrybut allowAnonymous właściwości w sekcji profilu pliku Web.config jest ustawiony na true , a enabled atrybut elementu <anonymousIdentification> ma wartość false.

-lub-

Atrybut serializeAs właściwości w sekcji profilu pliku Web.config jest ustawiony na Binary , a IsSerializable właściwość określonego type zwraca wartość false.

-lub-

Nie można odnaleźć nazwy dostawcy określonego przy użyciu provider atrybutu właściwości profilu w kolekcji Providers .

-lub-

type Nie można odnaleźć określonej właściwości profilu.

-lub-

Właściwość profilu została określona z nazwą zgodną z nazwą właściwości w klasie bazowej określonej w atrybucie inherits sekcji profilu .

Przykłady

Poniższy przykład kodu tworzy wystąpienie obiektu profilu niestandardowego, ustawia właściwość i zapisuje profil w źródle danych.

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()

Uwagi

Metoda Create tworzy i inicjuje nowe wystąpienie profilu i jest przydatna w przypadku aplikacji korzystających z niestandardowego obiektu profilu lub zarządzania profilami użytkowników w środowisku non-ASP.NET.

To przeciążenie Create metody może służyć do tworzenia profilu dla uwierzytelnionego użytkownika lub użytkownika anonimowego.

Zobacz też

• Omówienie właściwości profilu ASP.NET