WeakReference.Target Proprietà

Riferimento

Definizione

Spazio dei nomi:: System

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Origine:: WeakReference.CoreCLR.cs

Origine:: WeakReference.cs

Origine:: WeakReference.cs

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.

Ottiene o imposta l'oggetto o la destinazione a cui fa riferimento l'oggetto WeakReference corrente.

public:
 virtual property System::Object ^ Target { System::Object ^ get(); void set(System::Object ^ value); };

public virtual object Target { get; set; }

public virtual object? Target { get; set; }

member this.Target : obj with get, set

Public Overridable Property Target As Object

Valore della proprietà

Object

null se l'oggetto cui fa riferimento l'oggetto WeakReference è stato sottoposto alla procedura di Garbage Collection. In caso contrario, un riferimento all'oggetto cui fa riferimento l'oggetto WeakReference corrente.

Eccezioni

InvalidOperationException

Il riferimento all'oggetto di destinazione non è valido. Questa eccezione può essere generata durante l'impostazione della proprietà se il valore è un riferimento null o se l'oggetto è stato finalizzato durante l'operazione set.

Esempio

L'esempio seguente tenta di ottenere un oggetto da una cache di oggetti con riferimenti deboli. Se l'oggetto è stato recuperato per Garbage Collection, viene generato un nuovo oggetto. Questo esempio fa parte di un esempio più grande fornito per la WeakReference classe.

Data d = _cache[index].Target as Data;
if (d == null) {
    // If the object was reclaimed, generate a new one.
    Console.WriteLine("Regenerate object at {0}: Yes", index);
    d = new Data(index);
    _cache[index].Target = d;
    regenCount++;
}
else {
    // Object was obtained with the weak reference.
    Console.WriteLine("Regenerate object at {0}: No", index);
}

return d;

match _cache[index].Target with
| :? Data as d->
    // Object was obtained with the weak reference.
    printfn $"Regenerate object at {index}: No"
    d
| _ ->
    // If the object was reclaimed, generate a new one.
    printfn $"Regenerate object at {index}: Yes"
    let d = Data index
    _cache[index].Target <- d
    regenCount <- regenCount + 1
    d

 Dim d As Data = TryCast(_cache(index).Target, Data)
 ' If the object was reclaimed, generate a new one.
 If d Is Nothing Then 
     Console.WriteLine("Regenerate object at {0}: Yes", index)
     d = New Data(index)
     _cache(index).Target = d
     regenCount += 1
Else 
     ' Object was obtained with the weak reference.
     Console.WriteLine("Regenerate object at {0}: No", index.ToString())
 End If 
 Return d

Commenti

Dopo aver impostato questa proprietà sull'oggetto di destinazione, assicurarsi che non siano presenti altri riferimenti sicuri all'oggetto; in caso contrario, non verrà raccolto.

Si applica a