Conjunto de adaptador WML
O conjunto de adaptador WML consiste de classes que podem ser usados para processar páginas de Web móveis ASP.NET em clientes que oferecem suporte a WML v1.1 ou WML v1.2.Alguns métodos e propriedades não podem ser incluídas nesta documentação.A tabela a seguir lista as classes principais que estão incluídas no conjunto de adaptador WML.
Adaptador conjunto para dispositivos WML |
Núcleo adaptador classe namespace |
|---|---|
ControlAdapter classe base abstrata |
|
Classe HtmlFormAdapter |
|
PageAdapter classe abstrata |
|
Classe MobileTextWriter |
Um Openwave UP.navegador usa um adaptador de página diferentes e Texto writer.A tabela a seguir lista as classes principais usadas pelo adaptador conjunto suporte desses navegadores.
Adaptador conjunto para UP.Browsers |
Núcleo adaptador classe namespace |
|---|---|
ControlAdapter classe base abstrata |
|
Classe HtmlFormAdapter |
|
PageAdapter classe abstrata |
|
Classe MobileTextWriter |
.gif "Observação") Observação: |
|---|
With UP.navegador 4.1 ou UP.navegador 3.2, o Redirect método sempre se comporta sistema autônomo se o valor da SupportsRedirectWithCookie propriedade das HttpBrowserCapabilities o objeto é false, a menos que o Cookieless propriedade no SessionState seção do Web.config tenha sido explicitamente conjunto para true. No ASP.NET 1.1, foram as opções para esta configuração true ou false , mas com o ASP.NET 2.0, as opções são expandidas, e AutoDetect é agora a configuração padrão.Se seu aplicativo Web Web tiver o cookieless atributo das <sessionState> seção no Web.conjunto de configurações como um valor booliano, o Redirect método funcionará conforme o esperado para esses navegadores. |
Selection
O conjunto de adaptador WML é selecionado se o PreferredRenderingType propriedade das MobileCapabilities classe retorna PreferredRenderingTypeWml11 ou PreferredRenderingTypeWml12.
renderização adaptável
O conjunto de adaptador WML é capaz de adaptar-se significativamente os vários recursos de celulares baseado em WML.Assim, o adaptador definido realmente chamadas a Render método duas vezes para cada formulário e seus controles filho. Na primeira passagem, o gravador estiver no modo de análise e utiliza todas as chamadas feitas a ele para analisar a saída do formulário.Na segunda etapa, o formulário, na verdade, é processado.
Evite criar adaptadores de distinguir entre passagens.Se for absolutamente necessário, você pode escrever um adaptador que pode acessar o modo corrente, verificando o AnalyzeMode propriedade das WmlMobileTextWriter classe.
Processamento padrão
As etapas a seguir mostram as renderizações padrão de página e forma adaptador classes no conjunto de adaptador WML.
O adaptador de página executa as seguintes etapas:
Chama o BeginResponse e BeginFile métodos para o gravador. Tipo de conteúdo é text/vnd.wap.wml.
Escreve uma abertura <wml> marca.
Processa o formulário ativo.
Processa formulários vinculados sistema autônomo parte do WML mesmo baralho, se possível.
Grava um fechamento </wml> marca.
Chama o EndFile e EndResponse métodos.
O adaptador de formulário executa as seguintes etapas:
Configura o gravador para o modo de análise.
Chama BeginForm método.
Processa o Sumário do formulário.Os resultados não são enviados para o dispositivo, mas são analisados pelo gravador.
Chama EndForm método.
Configura o gravador para o modo ao vivo.
Chama BeginForm método.
Processa o Sumário do formulário.
Chama EndForm método.
Usando estilos
The WmlMobileTextWriter classe fornece uma série de métodos auxiliares que ajudam você a usando informações de estilo para processar conteúdo:
The EnterLayout e ExitLayout métodos permitem que um adaptador de marcação para começar a emitir e participante um bloco usando a formatação de um determinado estilo de parágrafo.
The EnterFormat e ExitFormat métodos permitem que um adaptador emitir marcação para iniciar e terminar um bloco usando a formatação de um determinado estilo de caractere.
The ResetFormattingState método permite que um adaptador reiniciar o estado de formatação para o estado padrão.
Métodos de renderização adaptável
The WmlMobileTextWriter CLsistema autônomos fornece vários métodos de alto nível para renderização, sistema autônomo mostrado na tabela a seguir.
Adaptadores WML devem usar esses métodos para processar conteúdo porque o gravador pode adaptar automaticamente a saída ideal com base em recursos do dispositivo de destino.
Para obter detalhes sobre cada um desses métodos, consulte a documentação para o WmlMobileTextWriter classe.
Método de gravador |
Descrição |
|---|---|
Processa um elemento de texto. |
|
Processa um elemento de imagem. |
|
Processa um elemento da caixa de entrada de texto. |
|
Processa um elemento de hiperlink. telefonar the RenderText ou RenderImage método para processar texto ou uma imagem dentro do hiperlink. |
|
Processa um elemento de postback. telefonar the RenderText ou RenderImage método para processar texto ou uma imagem dentro o postback. |
|
Processa um elemento da lista de seleção. Chama o RenderSelectOption método para processar cada opção na lista de seleção. |
|
Adiciona uma variável e um valor inicial para serem processadas com o formulário.Quando um dispositivo WML processa o formulário, ele inicializa a variável para o valor inicial especificado. |
Além disso, a WmlControlAdapter classe base fornece vários métodos de nível superior, conforme mostrado na tabela a seguir. Cada um desses métodos processa usando os métodos de gravador listados anteriormente.
Método do adaptador |
Descrição |
|---|---|
Apresenta um vínculo.O adaptador determina automaticamente sistema autônomo processar o link, links para formulários na mesma página sistema autônomo postbacks de renderização e processar outros links sistema autônomo hiperlinks. Chamar o RenderText ou RenderImage método sobre o gravador para processar texto ou uma imagem dentro do link. |
|
Apresenta um vínculo com o texto interno. |
|
Processa um evento de postagem com o controle sistema autônomo um destino. |
Menus de renderização
Em alguns dispositivos WML, um formulário que consiste em vários links ou âncoras são mais renderizado sistema autônomo um menu de itens usando <select> e <option> elementos com uma interface de usuário de navegação do teclado numérico gerada automaticamente (UI). Um Openwave UP.navegador é um exemplo de um dispositivo desse tipo.
O adaptador de formulário WML pode processar um formulário sistema autônomo um menu se o formulário consiste em zero ou mais controles que processam sistema autônomo texto estático, seguido por um ou mais controles que podem processar <select> e <option> elementos.
Se o RendersWmlSelectsAsMenuCards propriedade das MobileCapabilities classe é conjunto para true, o dispositivo pode processar <select> elementos sistema autônomo placas de menu em vez de uma caixa de combinação.
The CanCombineFormsInDeck propriedade é conjunto para true Se o navegador pode lidar com coleções que contêm vários formulários sistema autônomo cartões separados. O adaptador pode dar saída em várias formas da mesma página sistema autônomo cartões de um único baralho.
Formulário de renderização aceitar controles
Quando um formulário renderizado inclui interface de usuário para enviar o formulário ao servidor, alguns dispositivos baseado em WML exigem que a interface do usuário para o dispositivo especificado sejam um <do> elemento no início do formulário. Um Openwave UP.navegador é um exemplo de um dispositivo desse tipo.
Quando um dispositivo requer que a interface do usuário usar um <do> elemento, as verificações de adaptador de formulário se qualquer um dos controles no formulário precisa enviar a interface do usuário e se qualquer um dos controles fornecem tal interface do usuário. Para determinar isso, o adaptador no formulário consulta os adaptadores de cada um dos controles no formulário.
Renderização para Softkeys
Alguns controles processam a interface do usuário que pode ser mapeado para uma tecla de função em um dispositivo baseado em WML.The RendersWmlDoAcceptsInline propriedade das MobileCapabilities classe é definida sistema autônomo true Se o dispositivo processa um WML <do> elemento sistema autônomo um botão in-line em vez de uma tecla de função.
Interface do usuário secundário
O conjunto de adaptador WML suporta interface do usuário secundário, que é usado pelos controles para mostrar telas adicionais da interface do usuário.Para usar interface do usuário secundário, um adaptador de controle executa as seguintes etapas:
Em resposta a alguma interação do usuário (normalmente no substituível HandlePostBackEvent método), o adaptador de controle Especifica o modo de interface do usuário secundário, definindo o SecondaryUIMode propriedade das WmlControlAdapter classe base.
Em renderização, as verificações de controle seja no modo de interface do usuário secundário, se isso ocorrer, processa a interface do usuário secundário apropriado.
Em resposta a interação do usuário da interface do usuário secundário, o adaptador de controle pode alterar o modo de interface do usuário secundário para outro valor ou ele pode sair do modo de interface do usuário secundário chamando o ExitSecondaryUIMode método para o WmlControlAdapter classe base.
Recursos adicionais
Dispositivos WML exponham recursos adicionais podem ser usados para alterar o renderização.Esses recursos podem ser acessados por meio de HasCapability método para o MobileCapabilities classe.
Consulte também
Conceitos
Funcionalidade de conjuntos de adaptador