Binding.TargetNullValue Proprietà

Definizione

Spazio dei nomi:

Windows.UI.Xaml.Data

Ottiene o imposta il valore utilizzato nella destinazione quando il valore dell'origine è Null.

public:
 property Platform::Object ^ TargetNullValue { Platform::Object ^ get(); void set(Platform::Object ^ value); };

IInspectable TargetNullValue();

void TargetNullValue(IInspectable value);

public object TargetNullValue { get; set; }

var object = binding.targetNullValue;
binding.targetNullValue = object;

Public Property TargetNullValue As Object

<Binding TargetNullValue="nullValueString" />
- or -
<Binding>
  <Binding.TargetNullValue>
    nullValue
  </Binding.TargetNullValue>
</Binding>

Valore della proprietà

Object

Platform::Object

IInspectable

Valore utilizzato nella destinazione di associazione quando il valore dell'origine è Null.

Commenti

TargetNullValue può essere usato per le associazioni che associano una raccolta e i dati di origine usano Null per informazioni mancanti solo in alcuni elementi. Può essere usato anche per i casi generali in cui i dati provengono da un database che usa valori Null come informazioni di origine per firmare un elemento, ad esempio un record che necessita di ulteriori informazioni dall'utente e non è completo nell'origine.

Esistono due modelli consigliati per l'uso del comportamento TargetNullValue in un'associazione:

• L'origine di associazione fornisce un valore separato accessibile da un percorso diverso, che funge da valore singleton che può sostituire qualsiasi valore Null proveniente da un elemento di dati specifico nell'origine. Ad esempio:

<Button Content="{Binding Path=NextItem, Mode=OneWay, TargetNullValue={Binding Path=NullValue}}"/>

Di seguito è NullValue riportato il percorso del valore sostitutivo e viene fatto riferimento a un'altra associazione.

• Usare le risorse per fornire un valore specifico per l'app nei casi in cui l'origine dati ha fornito Null e non ha alcuna proprietà appropriata in un altro percorso da usare come valore di sostituzione. Ad esempio:

<Button Content="{Binding Path=NextItem, Mode=OneWay, TargetNullValue={StaticResource AppStringForNullInAStringABinding}}"/>

In questo caso, AppStringForNullInAStringABinding è una stringa di risorsa simile a "(valore non disponibile)" che consente all'utente di sapere che la maggior parte dei dati deve essere presente nella maggior parte dei dati, ma questo particolare elemento non disponeva di tali dati dall'origine. Usare le risorse in modo che il valore possa essere localizzato.

FallbackValue è una proprietà simile con scenari simili. La differenza è che un'associazione usa FallbackValue per i casi in cui il percorsoe l'origine non valutano l'origine dati in tutto o se si tenta di impostarlo sull'origine con un'associazione bidirezionale genera un'eccezione. Usa TargetNullValue se il percorso valuta, ma il valore trovato è null.

Non è possibile impostare i valori delle proprietà di un oggetto Binding dopo che tale associazione è stata associata a un elemento di destinazione e a una proprietà di destinazione. Se si tenta di ottenere un'eccezione di runtime.

Vedi anche

• FallbackValue
• Esempio di data binding XAML
• Informazioni approfondite sul data binding