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 do usuário.
Sobrecargas
| Create(String) |
Usado pelo ASP.NET para criar uma instância de um perfil para o nome de usuário especificado. |
| Create(String, Boolean) |
Usado pelo ASP.NET para criar uma instância de um perfil para o nome de usuário especificado. Aceita um parâmetro que indica se o usuário é autenticado ou anônimo. |
Create(String)
Usado pelo 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.ProfileBasePublic Shared Function Create (username As String) As ProfileBaseParâmetros
- username
- String
O nome do usuário para o qual um perfil será criado.
Retornos
Um ProfileBase que representa o perfil do usuário especificado.
Exceções
O atributo enabled da seção 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 perfil do arquivo Web.config.
- ou -
O atributo allowAnonymous de uma propriedade na seção perfil do arquivo Web.config é definido como true e o atributo enabled do elemento <anonymousIdentification> é definido como false.
- ou -
O atributo serializeAs de uma propriedade na seção perfil do arquivo Web.config é definido como Binary e a propriedade IsSerializable do type especificado retorna false.
- ou -
O nome de um provedor especificado que usa o atributo provider de uma propriedade de perfil não pôde ser encontrado na coleção Providers.
- ou -
Não foi possível encontrar o type especificado para uma propriedade de perfil.
- ou -
Uma propriedade de perfil foi especificada com um nome que corresponde a um nome de propriedade na classe base especificada no atributo inherits da seção 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 Create método 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 non-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 pelo ASP.NET para criar uma instância de um perfil para o nome de usuário especificado. Aceita 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.ProfileBasePublic Shared Function Create (username As String, isAuthenticated As Boolean) As ProfileBaseParâmetros
- username
- String
O nome do usuário para o qual um perfil será criado.
- isAuthenticated
- Boolean
true para indicar que o usuário é autenticado; false para indicar que o usuário é anônimo.
Retornos
Um objeto ProfileBase que representa o perfil do usuário especificado.
Exceções
O atributo enabled da seção 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 perfil do arquivo Web.config.
- ou -
O atributo allowAnonymous de uma propriedade na seção perfil do arquivo Web.config é definido como true e o atributo enabled do elemento <anonymousIdentification> é definido como false.
- ou -
O atributo serializeAs de uma propriedade na seção perfil do arquivo Web.config é definido como Binary e a propriedade IsSerializable do type especificado retorna false.
- ou -
O nome de um provedor especificado que usa o atributo provider de uma propriedade de perfil não pôde ser encontrado na coleção Providers.
- ou -
Não foi possível encontrar o type especificado para uma propriedade de perfil.
- ou -
Uma propriedade de perfil foi especificada com um nome que corresponde a um nome de propriedade na classe base especificada no atributo inherits da seção 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 Create método 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 non-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.
