Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese
Questa documentazione è stata archiviata e non viene gestita.

Metodo DependencyObject.ClearValue (DependencyProperty)

Cancella il valore locale di una proprietà. La proprietà da cancellare viene specificata da un identificatore DependencyProperty.

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

public void ClearValue(
	DependencyProperty dp
)

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 Dependency Property Value Precedence.

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 = locallySetProperties.Current.Property;
            if (!propertyToClear.ReadOnly) { uie.ClearValue(propertyToClear); }
        }
    }
}


.NET Framework

Supportato in: 4, 3.5, 3.0

.NET Framework Client Profile

Supportato in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 o versione successiva, Windows XP SP3, Windows Server 2008 (componenti di base del server non supportati), Windows Server 2008 R2 (componenti di base del server supportati con SP1 o versione successiva), Windows Server 2003 SP2

.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.
Mostra: