MenuItemBinding.TargetField Proprietà

Definizione

Spazio dei nomi:

System.Web.UI.WebControls

Assembly:

System.Web.dll

Ottiene o imposta il nome del campo dall'origine dati per l'associazione alla proprietà Target di un oggetto MenuItem a cui è applicato l'oggetto MenuItemBinding.

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

Valore della proprietà

String

Nome del campo da associare alla proprietà Target di un oggetto MenuItem a cui è applicato l'oggetto MenuItemBinding. Il valore predefinito è una stringa vuota (""), a indicare che questa proprietà non è impostata.

Attributi

TypeConverterAttribute

Commenti

Quando il Menu controllo è associato a un'origine dati, utilizzare la TargetField proprietà per specificare il nome del campo da associare alla MenuItem.Target proprietà di un MenuItem oggetto .

La MenuItem.Target proprietà specifica la finestra o il frame in cui visualizzare il contenuto Web collegato a una voce di menu quando si fa clic su tale voce di menu. I valori devono iniziare con una lettera compresa tra A e Z, senza distinzione tra maiuscole e minuscole, ad eccezione dei seguenti valori speciali che iniziano con un carattere di sottolineatura come illustrato nella tabella riportata di seguito.

Valore di destinazione	Descrizione
_blank	Visualizza il contenuto in una nuova finestra senza frame.
_parent	Visualizza il contenuto nell'elemento padre immediato del set di frame.
_self	Consente di visualizzare il contenuto nel frame attivo.
_top	Visualizza il contenuto in tutta la finestra senza frame.

Nota

Il rendering della Target proprietà viene eseguito come target attributo. L'attributo target sugli anchor elementi non è consentito nella definizione del tipo di documento XHTML 1.1. Non impostare la Target proprietà se l'output di cui è stato eseguito il rendering per deve MenuItemBinding essere conforme a XHTML 1.1. Per altre informazioni, vedere l'argomento Standard XHTML in Visual Studio e ASP.NET.

Quando si creano pagine Web accessibili, è consigliabile evitare di usare la Target proprietà per impostare come destinazione un'altra finestra. Per altre informazioni, vedere ASP.NET Accessibilità.

Si noti che l'impostazione di questa proprietà sostituisce la Menu.Target proprietà del Menu controllo per questa voce di menu. L'impostazione della Menu.Target proprietà per aprire una nuova finestra può rendere difficile per gli utenti di dispositivi assistive technology usare la pagina.

Nota

È possibile eseguire l'override dell'abilitazione di una singola voce di menu impostandone direttamente la MenuItem.Target proprietà.

Se l'origine dati contiene più tabelle o attributi, è prima necessario stabilire i criteri di associazione impostando la Depth proprietà, la DataMember proprietà o entrambe.

Nota

Se le Target proprietà e TargetField sono entrambe impostate, la proprietà ha la TargetField precedenza.

Vedi anche

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