CreateDefaultValueCallback Delegato
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Rappresenta il metodo che può essere richiamato come parte di un costruttore PropertyMetadata per rinviare la definizione di un valore predefinito della proprietà di dipendenza.
public delegate Platform::Object ^ CreateDefaultValueCallback();[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.Guid(2139130885, 10948, 23257, 172, 138, 38, 137, 3, 51, 216, 30)]
public delegate object CreateDefaultValueCallback();Public Delegate Function CreateDefaultValueCallback() As Object Valore restituito
Platform::Object
Valore predefinito desiderato.
- Attributi
Esempio
Questo esempio mostra lo pseudocodice per l'uso di CreateDefaultValueCallback in uno scenario di proprietà di dipendenza personalizzato. In particolare, crea PropertyMetadata da usare in una chiamata DependencyProperty.Register (non visualizzata).
PropertyMetadata metadata = PropertyMetadata.Create(
new CreateDefaultValueCallback(() =>
{
return new CustomClass() //a DependencyObject
{
CustomProperty1 = "default", //DependencyProperty of type String
CustomProperty2 = -1; //DependencyProperty of type Int32
}
})
Commenti
Quando si registra una proprietà di dipendenza personalizzata, è possibile fornire metadati (un valore PropertyMetadata ) che fornisce un valore predefinito per tutti gli usi della proprietà di dipendenza. Molte volte è sufficiente fornire tale valore direttamente nei metadati come valore immediato. Questo funzionerà sempre per qualsiasi valore di tipo valore, ad esempio specificando un valore predefinito di -1 per una int proprietà value. Tuttavia, se si desidera segnalare un valore predefinito per una proprietà di riferimento, ad esempio un valore DependencyObject , è possibile riscontrare un problema di threading correlato al funzionamento delle proprietà di dipendenza. Tutti gli oggetti DependencyObject vengono sempre creati in un thread dell'interfaccia utente. Tuttavia, è possibile che il thread che registra la proprietà e il thread che alla fine usa un'istanza dell'oggetto e tenti di accedere al valore predefinito non siano lo stesso thread dell'interfaccia utente. Se si specifica un oggetto CreateDefaultValueCallback in PropertyMetadata anziché un'istanza fissa, il valore predefinito della proprietà viene creato just-in-time ed è garantito che sia accessibile dal thread che usa effettivamente la proprietà . In altre parole, la proprietà come registra rinvia il valore predefinito, ma la proprietà utilizzata ora può fornire un valore predefinito thread-safe.
Un tipico CreateDefaultValueCallback non deve eseguire alcuna operazione oltre a chiamare un costruttore per il tipo di riferimento usato come valore e impostare le proprietà di tale tipo di riferimento, quindi restituirlo.
Per specificare un oggetto CreateDefaultValueCallback all'interno di un'istanza propertyMetadata , è necessario utilizzare PropertyMetadata.Create per creare l'istanza, non un costruttore PropertyMetadata .