ProfileBase.Create Método

Definição

Namespace:

System.Web.Profile

Assembly:

System.Web.dll

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.ProfileBase

Public Shared Function Create (username As String) As ProfileBase

Parâmetros

username

String

O nome do usuário para o qual um perfil será criado.

Retornos

ProfileBase

Um ProfileBase que representa o perfil do usuário especificado.

Exceções

ProviderException

O atributo enabled da seção perfil do arquivo Web.config é false.

HttpException

O nível de permissão de hospedagem atual é menor que Medium.

ConfigurationErrorsException

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

• Visão geral das propriedades do perfil ASP.NET

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.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 um perfil será criado.

isAuthenticated

Boolean

true para indicar que o usuário é autenticado; false para indicar que o usuário é anônimo.

Retornos

ProfileBase

Um objeto ProfileBase que representa o perfil do usuário especificado.

Exceções

ProviderException

O atributo enabled da seção perfil do arquivo Web.config é false.

HttpException

O nível de permissão de hospedagem atual é menor que Medium.

ConfigurationErrorsException

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.

Confira também

• Visão geral das propriedades do perfil ASP.NET