WeakReference.Target Propriedade

  • Referência

Definição

Namespace:
System
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

Obtém ou define o objeto (o destino) referenciado pelo objeto WeakReference atual.

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

Valor da propriedade

Object

null se o objeto referenciado pelo objeto WeakReference atual passou pela coleta de lixo; caso contrário, uma referência ao objeto referenciado pelo objeto WeakReference atual.

Exceções

InvalidOperationException

A referência ao objeto de destino é inválida. Essa exceção pode ser gerada ao configurar essa propriedade se o valor for uma referência nula ou se o objeto tiver sido finalizado durante a operação de conjuntos.

Exemplos

O exemplo a seguir tenta obter um objeto de um cache de objetos com referências fracas. Se o objeto foi recuperado para coleta de lixo, um novo objeto será gerado. Este exemplo faz parte de um exemplo maior fornecido para a 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

Comentários

Depois de definir essa propriedade para o objeto de destino, verifique se não há outras referências fortes ao objeto; caso contrário, ele não será coletado.

Aplica-se a

Confira também