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 метода можно использовать для создания профиля для пользователя, прошедшего проверку подлинности, или анонимного пользователя.