ConditionalWeakTable<TKey,TValue>.TryGetValue(TKey, TValue) 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
取得指定之索引鍵的值。
public:
bool TryGetValue(TKey key, [Runtime::InteropServices::Out] TValue % value);public bool TryGetValue (TKey key, out TValue value);member this.TryGetValue : 'Key * 'Value -> boolPublic Function TryGetValue (key As TKey, ByRef value As TValue) As Boolean參數
- key
- TKey
索引鍵，代表具有附加屬性的物件。
- value
- TValue
這個方法傳回的內容會包含附加的屬性值。 如果找不到 key，則 value 會包含預設值。
傳回
如果找到 true 則為 key，否則為 false。
例外狀況
key 為 null。
範例
下列範例會 MainClass 定義 類別和 MainInfo 類別，以提供 實例的相關信息 MainClass 。 此範例會 Add呼叫、 GetOrCreateValue和 GetValue 方法，將索引鍵/值組新增至 ConditionalWeakTable<TKey,TValue> 數據表。 在每個案例中，此範例都會呼叫 TryGetValue 方法來確認索引鍵/值組已新增至數據表。
using System;
using System.Reflection;
using System.Runtime.CompilerServices;
public class Example
{
string Name;
public Example(string name)
{
this.Name = name;
}
public override string ToString()
{
return this.Name;
}
}
// Define a class to contain information about each Example instance.
public class ExampleInfo
{
public string Name;
public int Methods;
public int Properties;
public override string ToString()
{
return String.Format("{0}: {1} Methods, {2} Properties",
this.Name, this.Methods, this.Properties);
}
}
public class ExampleTest
{
private static BindingFlags flags = BindingFlags.Public | BindingFlags.Instance;
public static void Main()
{
Example ex1 = new Example("ex1");
Example ex2 = new Example("ex2");
Example ex3 = new Example("ex3");
ExampleInfo exInfo1 = new ExampleInfo();
exInfo1.Name = ex1.ToString();
exInfo1.Methods = ex1.GetType().GetMethods(flags).Length;
exInfo1.Properties = ex1.GetType().GetProperties(flags).Length;
ExampleInfo exInfo3 = new ExampleInfo();
exInfo3.Name = ex3.ToString();
exInfo3.Methods = ex3.GetType().GetMethods(flags).Length;
exInfo3.Properties = ex3.GetType().GetProperties(flags).Length;
var attached = new ConditionalWeakTable<Example, ExampleInfo>();
ExampleInfo value = null;
// Attach a property to ex1 using the Add method, then retrieve it.
attached.Add(ex1, exInfo1);
if (attached.TryGetValue(ex1, out value))
Console.WriteLine("{0}, {1}", ex1, value);
else
Console.WriteLine("{0} does not have an attached property.", ex1);
// Attempt to retrieve the value attached to ex2.
value = attached.GetValue(ex2, ExampleTest.CreateAttachedValue);
if (attached.TryGetValue(ex2, out value))
Console.WriteLine("{0}, {1}", ex2, value);
else
Console.WriteLine("{0} does not have an attached property.", ex2);
// Attempt to retrieve the value attached to ex3.
value = attached.GetOrCreateValue(ex3);
Console.WriteLine("{0}, {1}", ex3, value);
}
public static ExampleInfo CreateAttachedValue(Example ex)
{
ExampleInfo info = new ExampleInfo();
info.Name = ex.ToString();
info.Methods = ex.GetType().GetMethods(flags).Length;
info.Properties = ex.GetType().GetProperties(flags).Length;
return info;
}
}
// The example displays the following output:
// ex1, ex1: 4 Methods, 0 Properties
// ex2, ex2: 4 Methods, 0 Properties
// ex3, : 0 Methods, 0 Properties
Imports System.Reflection
Imports System.Runtime.CompilerServices
Public Class Example
Public Name As String
Public Sub New(name As String)
Me.Name = name
End Sub
Public Overrides Function ToString() As String
Return Me.Name
End Function
End Class
' Define a class to contain information about each Example instance.
Public Class ExampleInfo
Public Name As String
Public Methods As Integer
Public Properties As Integer
Public Overrides Function ToString() As String
Return String.Format("{0}: {1} Methods, {2} Properties", _
Me.Name, Me.Methods, Me.Properties)
End Function
End Class
Module TestExample
Private flags As BindingFlags = BindingFlags.Public Or BindingFlags.Instance
Public Sub Main()
Dim ex1 As New Example("ex1")
Dim ex2 As New Example("ex2")
Dim ex3 As New Example("ex3")
Dim exInfo1 As New ExampleInfo()
exInfo1.Name = ex1.ToString()
exInfo1.Methods = ex1.GetType().GetMethods(flags).Count
exInfo1.Properties = ex1.GetType().GetProperties(flags).Count
Dim exInfo3 As New ExampleInfo()
exInfo3.Name = ex3.ToString()
exInfo3.Methods = ex3.GetType().GetMethods(flags).Count
exInfo3.Properties = ex3.GetType().GetProperties(flags).Count
Dim attached As New ConditionalWeakTable(Of Example, ExampleInfo)
Dim value As ExampleInfo = Nothing
' Attach a property to ex1 using the Add method, then retrieve it.
attached.Add(ex1, exInfo1)
If attached.TryGetValue(ex1, value) Then
Console.WriteLine("{0}, {1}", ex1, value)
Else
Console.WriteLine("{0} does not have an attached property.", ex1)
End If
' Attempt to retrieve the value attached to ex2.
value = attached.GetValue(ex2, AddressOf TestExample.CreateAttachedValue)
If attached.TryGetValue(ex2, value) Then
Console.WriteLine("{0}, {1}", ex2, value)
Else
Console.WriteLine("{0} does not have an attached property.", ex2)
End If
' Atttempt to retrieve the value attached to ex3.
value = attached.GetOrCreateValue(ex3)
Console.WriteLine("{0}, {1}", ex3, value)
End Sub
Public Function CreateAttachedValue(ex As Example) As ExampleInfo
Dim info As New ExampleInfo()
info.Name = ex.ToString()
info.Methods = ex.GetType().GetMethods(flags).Count
info.Properties = ex.GetType().GetProperties(flags).Count
Return info
End Function
End Module
' The example displays the following output:
' ex1, ex1: 4 Methods, 0 Properties
' ex2, ex2: 4 Methods, 0 Properties
' ex3, : 0 Methods, 0 Properties
備註
如果此作業期間會垃圾收集密鑰，方法可能會傳回 false 並設定 value 為預設值 (，就如同索引鍵不存在) 一樣。
