Elemento <choice>(guia do desenvolvedor do .NET estrutura)

Artigo
08/25/2010

Fornece uma única escolha entre um conjunto de opções em um <DeviceSpecific>/<Choice> Construa. Durante renderização, uma das opções em um <devicespecific> elemento é selecionado com base nas características do dispositivo de destino.

A <Choice> elemento pode incluir qualquer número de modelos. If a <Choice> elemento inclui modelos, pode ser usado sistema autônomo um modelo conjunto. Para obter detalhes, consulte:Conjuntos de modelo e modelos de controles.

The <Choice> elemento também pode incluir propriedades substituem propriedades do controle pai ou estilo. Os seguintes tipos de propriedades podem ser substituídos:

Any property that can be declaratively set to a literal value, except for the ID and runatattributes.Propriedades definidas para objetos, sistema autônomo DataSource não é possível conjunto propriedades de controles.
Qualquer evento manipulador de propriedade.O manipulador de eventos de substituir adiciona a quaisquer manipuladores de eventos existentes, mas não as substitui.

Qualquer atributo personalizado.Qualquer propriedade que não é reconhecida é armazenada sistema autônomo um atributo personalizado, se a página permite que sistema autônomo atributos personalizados a serem definidas para controles.

Observação:
A escolha padrão deve ser sempre a última opção em uma seleção de dispositivo (caso contrário, opções que aparecem após a escolha padrão nunca será avaliada, porque sempre irá ser selecionada a opção padrão).É possível declarar qualquer número de atributos adicionais dentro de um <Choice> elemento. Isso fornece uma maneira para conjunto propriedades do recipiente de controle em uma base específica ao dispositivo.Quando um <Choice> elemento é selecionado para um controle, cada um desses atributos adicionais é usada para substituir a propriedade correspondente do recipiente de controle.

A escolha padrão deve ser sempre a última opção em uma seleção de dispositivo (caso contrário, opções que aparecem após a escolha padrão nunca será avaliada, porque sempre irá ser selecionada a opção padrão).É possível declarar qualquer número de atributos adicionais dentro de um <Choice> elemento. Isso fornece uma maneira para conjunto propriedades do recipiente de controle em uma base específica ao dispositivo.Quando um <Choice> elemento é selecionado para um controle, cada um desses atributos adicionais é usada para substituir a propriedade correspondente do recipiente de controle.

<Choice Filter="deviceFilterName"
    Other attributes here.>
        templates
</Choice>

Propriedades

Propriedade	Descrição
Filter	Especifica filtro de dispositivo para avaliar.Se esta propriedade for omitida, a opção é selecionada por padrão.
Contents	Retorna as propriedades substituídas definidas para uma opção.Alterar essa coleção depois Propriedades substituídas foram processadas (em OnDeviceCustomize não terá efeito.
HasTemplates	Retornatrue Se a <Choice> elemento tem quaisquer modelos definidos; caso contrário, retornará false.
Templates	Retorna o conjunto de modelos definido para um <Choice> elemento.
Xmlns	Usada pelo designer para determinar o tipo de marcação dentro de modelos de um <Choice> elemento. Não se destina ao uso geral do desenvolvedor.

O nome do filtro deve ser o nome de um método na página ou no arquivo .ascx associado ou o nome de um filtro de dispositivo válido definido no <devicefilters> seção da Web. arquivo de configuração.Se for especificado um nome de método com o Filter propriedade, esse método deve ter a seguinte assinatura:

public bool methodName(
    System.Web.Mobile.MobileCapabilities capabilities,
    String optionalArgument)

Por exemplo, se o Filter propriedade é conjunto para myChoiceMethod, um método com a assinatura a seguir deve existir:

public bool myChoiceMethod(
    System.Web.Mobile.MobileCapabilities capabilities, 
    String optionalArgument)

Ao avaliar o <Choice> elemento, é feita uma verificação para determinar se existe um método para a assinatura apropriada na página. Caso contrário, a <deviceFilters> seção do arquivo Web.config é verificada.

Para obter mais informações sobre a avaliação de filtro de dispositivo, consulte renderização específico do dispositivo e a documentação para o Filter propriedade.

Descrição

Para obter um exemplo detalhado, consulte o Filter propriedade.

Código

<DeviceSpecific>
  <Choice Filter = "isHTML32">
    <HeaderTemplate>
      <mobile:Image runat=server ImageUrl="defaul1.gif" />
    </HeaderTemplate>
  </Choice>
  <Choice Filter="prefersWBMP">
    <HeaderTemplate>
      <mobile:Image  ImageUrl="default1.wbmp" />
        Wbmp Image<br />
    </HeaderTemplate>
  </Choice>
</DeviceSpecific>

Consulte também

Conceitos

renderização específico do dispositivo

Suporte de modelo do dispositivo

Conjuntos de modelo e modelos de controles

Referência

Compartilhar via