VirtualizingLayoutContext.GetOrCreateElementAt Metodo

Definizione

Spazio dei nomi:

Microsoft.UI.Xaml.Controls

Overload

GetOrCreateElementAt(Int32)	Recupera un oggetto UIElement che rappresenta l'elemento di dati nell'origine trovata in corrispondenza dell'indice specificato. Per impostazione predefinita, se esiste già un elemento, viene restituito; in caso contrario, viene creato un nuovo elemento.
GetOrCreateElementAt(Int32, ElementRealizationOptions)	Recupera un oggetto UIElement che rappresenta l'elemento di dati nell'origine trovata in corrispondenza dell'indice specificato utilizzando le opzioni specificate.

GetOrCreateElementAt(Int32)

Recupera un oggetto UIElement che rappresenta l'elemento di dati nell'origine trovata in corrispondenza dell'indice specificato. Per impostazione predefinita, se esiste già un elemento, viene restituito; in caso contrario, viene creato un nuovo elemento.

public:
 virtual UIElement ^ GetOrCreateElementAt(int index) = GetOrCreateElementAt;

/// [Windows.Foundation.Metadata.Overload("GetOrCreateElementAt")]
UIElement GetOrCreateElementAt(int const& index);

[Windows.Foundation.Metadata.Overload("GetOrCreateElementAt")]
public UIElement GetOrCreateElementAt(int index);

function getOrCreateElementAt(index)

Public Function GetOrCreateElementAt (index As Integer) As UIElement

Parametri

index

Int32

int

Indice dell'elemento di dati per il quale recuperare un oggetto UIElement.

Restituisce

UIElement

UIElement che rappresenta l'elemento di dati.

Attributi

OverloadAttribute

Commenti

Questo metodo chiama GetOrCreateElementAtCore(System.Int32,Microsoft.UI.Xaml.Controls.ElementRealizationOptions) con opzioni impostate su None.

GetElementAtCore deve essere implementato in una classe derivata.

GetOrCreateElementAt(Int32, ElementRealizationOptions)

Recupera un oggetto UIElement che rappresenta l'elemento di dati nell'origine trovata in corrispondenza dell'indice specificato utilizzando le opzioni specificate.

public:
 virtual UIElement ^ GetOrCreateElementAt(int index, ElementRealizationOptions options) = GetOrCreateElementAt;

/// [Windows.Foundation.Metadata.Overload("GetOrCreateElementAt2")]
UIElement GetOrCreateElementAt(int const& index, ElementRealizationOptions const& options);

[Windows.Foundation.Metadata.Overload("GetOrCreateElementAt2")]
public UIElement GetOrCreateElementAt(int index, ElementRealizationOptions options);

function getOrCreateElementAt(index, options)

Public Function GetOrCreateElementAt (index As Integer, options As ElementRealizationOptions) As UIElement

Parametri

index

Int32

int

Indice dell'elemento di dati per il quale recuperare un oggetto UIElement.

options

ElementRealizationOptions

Valore di ElementRealizationOptions che specifica se eliminare il riciclo automatico dell'elemento recuperato o forzare la creazione di un nuovo elemento.

Restituisce

UIElement

UIElement che rappresenta l'elemento di dati.

Attributi

OverloadAttribute

Commenti

Questo metodo chiama GetOrCreateElementAtCore(System.Int32,Microsoft.UI.Xaml.Controls.ElementRealizationOptions), che deve essere implementato in una classe derivata.

Quando si richiede un elemento per l'indice specificato, è possibile specificare facoltativamente se eliminare il riciclo automatico dell'elemento recuperato o forzare la creazione di un nuovo elemento. Gli elementi recuperati con riciclo automatico eliminato (SuppressAutoRecycle) vengono ignorati dalla logica di riciclo automatico che cancella gli elementi realizzati che non sono stati recuperati come parte del passaggio di layout corrente. È necessario riciclare in modo esplicito questi elementi passandoli al metodo RecycleElement per evitare perdite di memoria.

Queste opzioni sono destinate a layout più avanzati che scelgono di gestire in modo esplicito la realizzazione e il riciclo degli elementi come ottimizzazione delle prestazioni.