Esporta (0) Stampa
Espandi tutto

Metodo DependencyObject.ClearValue (DependencyProperty)

Aggiornamento: novembre 2007

Cancella il valore locale di una proprietà. La proprietà da cancellare è indicata da un identificatore DependencyProperty.

Spazio dei nomi:  System.Windows
Assembly:  WindowsBase (in WindowsBase.dll)

public void ClearValue(
	DependencyProperty dp
)
public void ClearValue(
	DependencyProperty dp
)
public function ClearValue(
	dp : DependencyProperty
)
Non è possibile utilizzare metodi in XAML.

Parametri

dp
Tipo: System.Windows.DependencyProperty

Proprietà di dipendenza da cancellare, identificata da un riferimento all'oggetto DependencyProperty.

EccezioneCondizione
InvalidOperationException

È stato effettuato un tentativo di chiamare ClearValue su un oggetto DependencyObject sealed.

La cancellazione del valore della proprietà mediante chiamata a ClearValue non attribuisce necessariamente a una proprietà di dipendenza il valore predefinito specificato nei metadati della proprietà di dipendenza. La cancellazione della proprietà comporta solo la cancellazione specifica di qualsiasi valore locale applicato. Per ulteriori informazioni, vedere Precedenza del valore della proprietà di dipendenza.

Nell'esempio seguente vengono iterate tutte le proprietà che presentano valori locali impostati su un oggetto, quindi viene chiamato ClearValue per cancellare i valori di tali proprietà.

void RestoreDefaultProperties(object sender, RoutedEventArgs e)
{
    UIElementCollection uic = Sandbox.Children;
    foreach (Shape uie in uic)
    {
        LocalValueEnumerator locallySetProperties = uie.GetLocalValueEnumerator();
        while (locallySetProperties.MoveNext())
        {
            DependencyProperty propertyToClear = (DependencyProperty)locallySetProperties.Current.Property;
            if (!propertyToClear.ReadOnly) { uie.ClearValue(propertyToClear); }
        }
    }
}


Windows Vista

.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.

.NET Framework

Supportato in: 3.5, 3.0

Aggiunte alla community

AGGIUNGI
Mostra:
© 2014 Microsoft