MenuItemBinding.Target Propriedade
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém ou define a janela ou o quadro de destino no qual será exibido o conteúdo da página da Web associado a um item de menu ao qual o objeto MenuItemBinding está aplicado.
public:
property System::String ^ Target { System::String ^ get(); void set(System::String ^ value); };
public string Target { get; set; }
member this.Target : string with get, set
Public Property Target As String
A janela de destino ou quadro no qual exibir o conteúdo da página da Web vinculada. O valor padrão é uma cadeia de caracteres vazia (""), que atualiza a janela ou quadro com o foco.
O exemplo de código a seguir demonstra como usar a Target propriedade para especificar a janela na qual exibir o conteúdo da Web associado a um item de menu, quando esse item de menu é clicado. Para que este exemplo funcione corretamente, você deve copiar os dados XML de exemplo abaixo para um arquivo chamado Menu.xml.
<%@ page language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>MenuItemBinding Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>MenuItemBinding Example</h3>
<asp:menu id="NavigationMenu"
datasourceid="MenuSource"
runat="server">
<DataBindings>
<asp:menuitembinding datamember="MapHomeNode"
formatstring="({0})"
textfield="Title"
valuefield="Description"
imageurlfield="ImageUrl"
tooltipfield="ToolTip"
target="_self" />
<asp:menuitembinding datamember="MapNode"
depth="1"
formatstring="[{0}]"
textfield="Title"
valuefield="Description"
imageurlfield="ImageUrl"
tooltipfield="ToolTip"
target="_blank"/>
<asp:menuitembinding datamember="MapNode"
depth="2"
formatstring="<{0}>"
textfield="Title"
valuefield="Description"
imageurlfield="ImageUrl"
tooltipfield="ToolTip"
target="_blank"/>
</DataBindings>
</asp:menu>
<asp:xmldatasource id="MenuSource"
datafile="Menu.xml"
runat="server"/>
</form>
</body>
</html>
<%@ page language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>MenuItemBinding Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>MenuItemBinding Example</h3>
<asp:menu id="NavigationMenu"
datasourceid="MenuSource"
runat="server">
<DataBindings>
<asp:menuitembinding datamember="MapHomeNode"
formatstring="({0})"
textfield="Title"
valuefield="Description"
imageurlfield="ImageUrl"
tooltipfield="ToolTip"
target="_self" />
<asp:menuitembinding datamember="MapNode"
depth="1"
formatstring="[{0}]"
textfield="Title"
valuefield="Description"
imageurlfield="ImageUrl"
tooltipfield="ToolTip"
target="_blank"/>
<asp:menuitembinding datamember="MapNode"
depth="2"
formatstring="<{0}>"
textfield="Title"
valuefield="Description"
imageurlfield="ImageUrl"
tooltipfield="ToolTip"
target="_blank"/>
</DataBindings>
</asp:menu>
<asp:xmldatasource id="MenuSource"
datafile="Menu.xml"
runat="server"/>
</form>
</body>
</html>
O código a seguir é um exemplo de dados do mapa do site para o exemplo anterior.
<MapHomeNode ImageUrl="~\Images\Home.gif"
Title="Home"
Description="Root Page"
ToolTip="Home Page">
<MapNode ImageUrl="~\Images\Music.gif"
Title="Music"
Description="Music Category"
ToolTip="Music Page">
<MapNode ImageUrl="~\Images\Classical.gif"
Title="Classical"
Description="Classical Section"
ToolTip="Classical Page"/>
<MapNode ImageUrl="~\Images\Rock.gif"
Title="Rock"
Description="Rock Section"
ToolTip="Rock Page"/>
<MapNode ImageUrl="~\Images\Jazz.gif"
Title="Jazz"
Description="Jazz Section"
ToolTip="Jazz Page"/>
</MapNode>
<MapNode ImageUrl="~\Images\Movies.gif"
Title="Movies"
Description="Movies Category"
ToolTip="Movies Page">
<MapNode ImageUrl="~\Images\Action.gif"
Title="Action"
Description="Action Section"
ToolTip="Action Page"/>
<MapNode ImageUrl="~\Images\Drama.gif"
Title="Drama"
Description="Drama Section"
ToolTip="Drama Page"/>
<MapNode ImageUrl="~\Images\Musical.gif"
Title="Musical"
Description="Musical Section"
ToolTip="Musical Page"/>
</MapNode>
</MapHomeNode>
Quando o Menu controle estiver associado a uma fonte de dados, use a Target propriedade para especificar a janela ou quadro no qual exibir o conteúdo da Web vinculado a um item de menu quando esse item de menu for clicado.
Observação
Definir essa propriedade substitui a Menu.Target propriedade do Menu controle para os itens de menu aos quais o MenuItemBinding objeto é aplicado. Você pode substituir seletivamente essa propriedade definindo a MenuItem.Target propriedade de cada item de menu diretamente.
Os valores de destino devem começar com uma letra no intervalo de A a Z (que 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. |
_search |
Renderiza o conteúdo no painel de pesquisa. |
_self |
Renderiza o conteúdo no quadro com foco. |
_top |
Renderiza o conteúdo na janela inteira sem quadros. |
Observação
Verifique a documentação do navegador para determinar se há suporte para o valor _search
. Por exemplo, o Microsoft Internet Explorer 5.0 e posterior dão suporte ao valor de destino _search
.
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 para o MenuItemBinding objeto precisar 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 a outra janela. Para obter mais informações, consulte Acessibilidade ASP.NET.
Comentários do .NET
O .NET é um projeto código aberto. Selecione um link para fornecer comentários: