ProfileBase.Create Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Cria uma instância de um perfil de utilizador.
Sobrecargas
| Name | Description |
|---|---|
| Create(String) |
Usado pelo ASP.NET para criar uma instância de um perfil para o nome de utilizador especificado. |
| Create(String, Boolean) |
Usado pelo ASP.NET para criar uma instância de um perfil para o nome de utilizador especificado. Utiliza um parâmetro que indica se o utilizador é autenticado ou anónimo. |
Create(String)
Usado pelo ASP.NET para criar uma instância de um perfil para o nome de utilizador 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 utilizador para criar um perfil.
Devoluções
E ProfileBase que representa o perfil do utilizador especificado.
Exceções
O enabled atributo da secção de perfil do ficheiro Web.config é false.
O nível atual de permissões de alojamento é inferior a Medium.
Um tipo de propriedade especificado na secção de perfil do ficheiro Web.config não podia ser criado.
-ou-
O allowAnonymous atributo de uma propriedade na secção de perfil do ficheiro Web.config é definido como true e o enabled atributo do <elemento anonymousIdentification> é definido como false.
-ou-
O serializeAs atributo de uma propriedade na secção de perfil do ficheiro Web.config é definido como Binary e a IsSerializable propriedade dos retornos typeespecificados false .
-ou-
O nome de um fornecedor especificado usando o provider atributo de uma propriedade de perfil não podia ser encontrado na Providers coleção.
-ou-
O type especificado para uma propriedade de perfil não foi encontrado.
-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 secção de perfil .
Exemplos
O exemplo de código seguinte cria uma instância de um objeto de perfil personalizado, define uma propriedade e guarda 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()
Observações
O método Create cria e inicializa uma nova instância de perfil e é útil para aplicações que utilizam um objeto de perfil personalizado ou gerem perfis de utilizador num ambiente não ASP.NET.
Esta sobrecarga do Create método assume que o nome de utilizador especificado é um utilizador autenticado.
Ver também
Aplica-se a
Create(String, Boolean)
Usado pelo ASP.NET para criar uma instância de um perfil para o nome de utilizador especificado. Utiliza um parâmetro que indica se o utilizador é 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 utilizador para criar um perfil.
- isAuthenticated
- Boolean
true para indicar que o utilizador está autenticado; false para indicar que o utilizador é anónimo.
Devoluções
Um ProfileBase objeto que representa o perfil do utilizador especificado.
Exceções
O enabled atributo da secção de perfil do ficheiro Web.config é false.
O nível atual de permissões de alojamento é inferior a Medium.
Um tipo de propriedade especificado na secção de perfil do ficheiro Web.config não podia ser criado.
-ou-
O allowAnonymous atributo de uma propriedade na secção de perfil do ficheiro Web.config é definido como true e o enabled atributo do <elemento anonymousIdentification> é definido como false.
-ou-
O serializeAs atributo de uma propriedade na secção de perfil do ficheiro Web.config é definido como Binary e a IsSerializable propriedade dos retornos typeespecificados false .
-ou-
O nome de um fornecedor especificado usando o provider atributo de uma propriedade de perfil não podia ser encontrado na Providers coleção.
-ou-
O type especificado para uma propriedade de perfil não foi encontrado.
-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 secção de perfil .
Exemplos
O exemplo de código seguinte cria uma instância de um objeto de perfil personalizado, define uma propriedade e guarda 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()
Observações
O método Create cria e inicializa uma nova instância de perfil e é útil para aplicações que utilizam um objeto de perfil personalizado ou gerem perfis de utilizador num ambiente não ASP.NET.
Esta sobrecarga do Create método pode ser usada para criar um perfil para um utilizador autenticado ou para um utilizador anónimo.