ProfileBase.Create Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Cria uma instância de um perfil de usuário.
Sobrecargas
| Nome | Description |
|---|---|
| Create(String) |
Usado por ASP.NET para criar uma instância de um perfil para o nome de usuário especificado. |
| Create(String, Boolean) |
Usado por ASP.NET para criar uma instância de um perfil para o nome de usuário especificado. Usa um parâmetro que indica se o usuário é autenticado ou anônimo. |
Create(String)
Usado por ASP.NET para criar uma instância de um perfil para o nome de usuário especificado.
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
Parâmetros
- username
- String
O nome do usuário para o qual criar um perfil.
Retornos
Um ProfileBase que representa o perfil do usuário especificado.
Exceções
O enabled atributo da seção de perfil do arquivo Web.config é false.
O nível de permissão de hospedagem atual é menor que Medium.
Não foi possível criar um tipo de propriedade especificado na seção de perfil do arquivo Web.config.
- ou -
O allowAnonymous atributo de uma propriedade na seção de perfil do arquivo Web.config é definido true como e o enabled atributo do <elemento anonymousIdentification> é definido como false.
- ou -
O serializeAs atributo de uma propriedade na seção de perfil do arquivo Web.config é definido Binary e a IsSerializable propriedade dos retornos especificados typefalse.
- ou -
O nome de um provedor especificado usando o provider atributo de uma propriedade de perfil não pôde ser encontrado na Providers coleção.
- ou -
Não type foi possível encontrar a propriedade especificada para um perfil.
- ou -
Uma propriedade de perfil foi especificada com um nome que corresponde a um nome de propriedade na classe base especificada no inherits atributo da seção de perfil .
Exemplos
O exemplo de código a seguir cria uma instância de um objeto de perfil personalizado, define uma propriedade e salva o perfil na fonte de dados.
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()
Comentários
O método Create cria e inicializa uma nova instância de perfil e é útil para aplicativos que usam um objeto de perfil personalizado ou gerenciam perfis de usuário em um ambiente não ASP.NET.
Essa sobrecarga do Create método pressupõe que o nome de usuário especificado seja um usuário autenticado.
Confira também
Aplica-se a
Create(String, Boolean)
Usado por ASP.NET para criar uma instância de um perfil para o nome de usuário especificado. Usa um parâmetro que indica se o usuário é autenticado ou anônimo.
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
Parâmetros
- username
- String
O nome do usuário para o qual criar um perfil.
- isAuthenticated
- Boolean
true para indicar que o usuário está autenticado; false para indicar que o usuário é anônimo.
Retornos
Um ProfileBase objeto que representa o perfil do usuário especificado.
Exceções
O enabled atributo da seção de perfil do arquivo Web.config é false.
O nível de permissão de hospedagem atual é menor que Medium.
Não foi possível criar um tipo de propriedade especificado na seção de perfil do arquivo Web.config.
- ou -
O allowAnonymous atributo de uma propriedade na seção de perfil do arquivo Web.config é definido true como e o enabled atributo do <elemento anonymousIdentification> é definido como false.
- ou -
O serializeAs atributo de uma propriedade na seção de perfil do arquivo Web.config é definido Binary e a IsSerializable propriedade dos retornos especificados typefalse.
- ou -
O nome de um provedor especificado usando o provider atributo de uma propriedade de perfil não pôde ser encontrado na Providers coleção.
- ou -
Não type foi possível encontrar a propriedade especificada para um perfil.
- ou -
Uma propriedade de perfil foi especificada com um nome que corresponde a um nome de propriedade na classe base especificada no inherits atributo da seção de perfil .
Exemplos
O exemplo de código a seguir cria uma instância de um objeto de perfil personalizado, define uma propriedade e salva o perfil na fonte de dados.
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()
Comentários
O método Create cria e inicializa uma nova instância de perfil e é útil para aplicativos que usam um objeto de perfil personalizado ou gerenciam perfis de usuário em um ambiente não ASP.NET.
Essa sobrecarga do Create método pode ser usada para criar um perfil para um usuário autenticado ou um usuário anônimo.