MenuItemBinding.TargetField Propriedade

Definição

Namespace:

System.Web.UI.WebControls

Assembly:

System.Web.dll

Obtém ou define o nome do campo da fonte de dados a ser associado à propriedade Target de um objeto MenuItem ao qual o objeto MenuItemBinding é aplicado.

public:
 property System::String ^ TargetField { System::String ^ get(); void set(System::String ^ value); };

[System.ComponentModel.TypeConverter("System.Web.UI.Design.DataSourceViewSchemaConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string TargetField { get; set; }

[<System.ComponentModel.TypeConverter("System.Web.UI.Design.DataSourceViewSchemaConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.TargetField : string with get, set

Public Property TargetField As String

Valor da propriedade

String

O nome do campo a ser associado ao Target de um MenuItem ao qual o MenuItemBinding é aplicado. O padrão é uma cadeia de caracteres vazia (""), que indica que essa propriedade não está definida.

Atributos

TypeConverterAttribute

Comentários

Quando o Menu controle estiver associado a uma fonte de dados, use a TargetField propriedade para especificar o nome do campo a ser associado à MenuItem.Target propriedade de um MenuItem objeto .

A MenuItem.Target propriedade especifica a janela ou quadro no qual exibir o conteúdo da Web vinculado a um item de menu quando esse item de menu é clicado. Os valores devem começar com uma letra no intervalo de A a Z (não diferencia maiúsculas de minúsculas), exceto para determinados valores especiais que começam com um sublinhado, conforme mostrado na tabela a seguir.

Valor de destino	Descrição
_blank	Renderiza o conteúdo em uma nova janela sem quadros.
_parent	Renderiza o conteúdo no pai do conjunto de quadros imediato.
_self	Renderiza o conteúdo no quadro com foco.
_top	Renderiza o conteúdo na janela inteira sem quadros.

Observação

A Target propriedade é renderizada como um target atributo. O target atributo em anchor elementos não é permitido na definição de tipo de documento XHTML 1.1. Não defina a Target propriedade se a saída renderizada do MenuItemBinding deve ser compatível com XHTML 1.1. Para obter mais informações, consulte o tópico Padrões XHTML no Visual Studio e ASP.NET.

Ao criar páginas da Web acessíveis, é altamente recomendável que você evite usar a Target propriedade para direcionar outra janela. Para obter mais informações, consulte ASP.NET Acessibilidade.

Observe que definir essa propriedade substitui a Menu.Target propriedade do Menu controle para este item de menu. Definir a Menu.Target propriedade para abrir uma nova janela pode dificultar o uso da página pelos usuários de dispositivos de tecnologia adaptativa.

Observação

Você pode substituir a habilitação de um item de menu individual definindo sua MenuItem.Target propriedade diretamente.

Se a fonte de dados contiver várias tabelas ou atributos, primeiro você deverá estabelecer os critérios de associação definindo a Depth propriedade, a DataMember propriedade ou ambos.

Observação

Se as Target propriedades e TargetField estiverem definidas, a TargetField propriedade terá precedência.

Confira também

• Menu
• MenuItem
• MenuItemBindingCollection
• XmlDataSource
• DataBindings
• DataMember