ProfileBase.Create Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Создает экземпляр профиля пользователя.
Перегрузки
Create(String) |
Используется ASP.NET для создания экземпляра профиля для заданного имени пользователя. |
Create(String, Boolean) |
Используется ASP.NET для создания экземпляра профиля для заданного имени пользователя. Принимает параметр, указывающий, прошел ли пользователь проверку подлинности или является анонимным пользователем. |
Create(String)
Используется ASP.NET для создания экземпляра профиля для заданного имени пользователя.
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
Параметры
- username
- String
Имя пользователя, для которого создается профиль.
Возвращаемое значение
Объект ProfileBase, представляющий профиль для заданного пользователя.
Исключения
Атрибут enabled
раздела profile файла Web.config имеет значение false
.
Текущий уровень разрешения среды ниже, чем Medium.
Не удалось создать тип свойства, заданный в разделе profile файла Web.config.
-или-
Атрибут allowAnonymous
свойства в разделе profile файла Web.config имеет значение true
, а атрибут enabled
элемента <anonymousIdentification> имеет значение false
.
-или-
Атрибут serializeAs
свойства в разделе profile файла Web.config имеет значение Binary, а свойство IsSerializable заданного типа type
возвращает false
.
-или-
Имя поставщика, заданное с помощью атрибута provider
свойства профиля не удалось найти в коллекции Providers.
-или-
Не удалось найти тип type
, заданный для свойства профиля.
-или-
Свойство профиля было задано с именем, совпадающим с именем свойства базового класса, указанного в атрибуте inherits
раздела profile.
Примеры
В следующем примере кода создается экземпляр объекта пользовательского профиля, устанавливается свойство и сохраняется профиль в источнике данных.
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()
Комментарии
Метод Create создает и инициализирует новый экземпляр профиля и полезен для приложений, которые используют пользовательский объект профиля или управляют профилями пользователей в non-ASP.NET среде.
Эта перегрузка Create метода предполагает, что указанное имя пользователя является пользователем, прошедшим проверку подлинности.
См. также раздел
Применяется к
Create(String, Boolean)
Используется ASP.NET для создания экземпляра профиля для заданного имени пользователя. Принимает параметр, указывающий, прошел ли пользователь проверку подлинности или является анонимным пользователем.
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
Параметры
- username
- String
Имя пользователя, для которого создается профиль.
- isAuthenticated
- Boolean
Значение true
— пользователь прошел проверку подлинности; если пользователь анонимный — false
.
Возвращаемое значение
Объект ProfileBase, представляющий профиль для указанного пользователя.
Исключения
Атрибут enabled
раздела profile файла Web.config имеет значение false
.
Текущий уровень разрешения среды ниже, чем Medium.
Не удалось создать тип свойства, заданный в разделе profile файла Web.config.
-или-
Атрибут allowAnonymous
свойства в разделе profile файла Web.config имеет значение true
, а атрибут enabled
элемента <anonymousIdentification> имеет значение false
.
-или-
Атрибут serializeAs
свойства в разделе profile файла Web.config имеет значение Binary, а свойство IsSerializable заданного типа type
возвращает false
.
-или-
Имя поставщика, заданное с помощью атрибута provider
свойства профиля не удалось найти в коллекции Providers.
-или-
Не удалось найти тип type
, заданный для свойства профиля.
-или-
Свойство профиля было задано с именем, совпадающим с именем свойства базового класса, указанного в атрибуте inherits
раздела profile.
Примеры
В следующем примере кода создается экземпляр объекта пользовательского профиля, устанавливается свойство и сохраняется профиль в источнике данных.
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()
Комментарии
Метод Create создает и инициализирует новый экземпляр профиля и полезен для приложений, которые используют пользовательский объект профиля или управляют профилями пользователей в non-ASP.NET среде.
Эту перегрузку Create метода можно использовать для создания профиля для пользователя, прошедшего проверку подлинности, или анонимного пользователя.