NSDictionary 類別

定義

命名空間:

Foundation

組件:

Xamarin.iOS.dll

字典，提供從索引鍵到值的對應。

[Foundation.Register("NSDictionary", true)]
public class NSDictionary : Foundation.NSObject, CoreData.INSFetchRequestResult, Foundation.INSMutableCopying, Foundation.INSSecureCoding, IDisposable, System.Collections.Generic.ICollection<System.Collections.Generic.KeyValuePair<Foundation.NSObject,Foundation.NSObject>>, System.Collections.Generic.IDictionary<Foundation.NSObject,Foundation.NSObject>, System.Collections.Generic.IEnumerable<System.Collections.Generic.KeyValuePair<Foundation.NSObject,Foundation.NSObject>>, System.Collections.IDictionary

type NSDictionary = class
    inherit NSObject
    interface INSCoding
    interface INativeObject
    interface IDisposable
    interface INSCopying
    interface INSMutableCopying
    interface INSSecureCoding
    interface INSFetchRequestResult
    interface IDictionary
    interface ICollection
    interface IEnumerable
    interface IDictionary<NSObject, NSObject>
    interface ICollection<KeyValuePair<NSObject, NSObject>>
    interface seq<KeyValuePair<NSObject, NSObject>>

繼承

Object

NSObject

NSDictionary

衍生

Foundation.NSDictionary<TKey,TValue>

Foundation.NSMutableDictionary

屬性

RegisterAttribute

實作

INSFetchRequestResult INSCoding INSCopying INSMutableCopying INSSecureCoding INativeObject ICollection<KeyValuePair<NSObject,NSObject>> ICollection<KeyValuePair<TKey,TValue>> IDictionary<NSObject,NSObject> IEnumerable<KeyValuePair<NSObject,NSObject>> IEnumerable<KeyValuePair<TKey,TValue>> IEnumerable<T> ICollection IDictionary IEnumerable IDisposable

備註

這是不可變的字典，若要建立可變動的字典，請使用 NSMutableDictionary 類型。

有一個方便的建構函式會採用至少一個索引鍵和一個值，而選擇性值會藉由將每個索引鍵與值配對來建立字典。 如果您使用 .NET 物件，索引鍵和值會先使用 FromObject(Object) Boxed 到 NSObjects。

//
// Using C# objects, strings and ints, produces
// a dictionary with 2 NSString keys, "key1" and "key2"
// and two NSNumbers with the values 1 and 2
//
var dict = new NSDictionary ("key1", 1, "key2", 2);

//
// Using NSObjects directly, gives you fine control
//
var key1 = new NSString ("key1");
var value1 = new NSNumber ((byte) 1);
var key2 = new NSString ("key2");
var value2 = new NSNumber ((byte) 2);

var dict2 = new NSDictionary (key1, value1, key2, value2);

有時候，您可能已經有索引鍵和值的陣列，因此您可以使用下列 Factory 方法：

var keys = new object [] { "key1", "key2" };
var values = new object [] { "value1", "value2" }:

var dict = NSDictionary.FromObjectsAndKeys (values, keys);

NSDictionary 類型會實作 ICollection、IDictionary 和泛型 ICollection 和 IDictionary 介面，這可讓您方便搭配現有的 .NET API 使用，並提供採用 NSObject、NSString 或 C# 字串以及列舉值的索引子。

在某些情況下，您可能會逐一查看迴圈，或尚未呈現系結型別，但有索引鍵的控制碼，您可以使用 LowlevelObjectForKey(IntPtr) 會取得索引鍵控制碼的 ，並傳回傳回物件的控制碼。

建構函式

NSDictionary()	預設建構函式，這個建構函式會初始化這個類別的新實例，不含任何參數。
NSDictionary(IntPtr)	建立 Unmanaged 物件的 Managed 標記法時所使用的建構函式;由執行時間呼叫。
NSDictionary(NSCoder)	從儲存在 unarchiver 物件中的資料初始化 物件的建構函式。
NSDictionary(NSDictionary)	從現有的 NSDictionary 建立新的 NSDictionary。
NSDictionary(NSDictionary, Boolean)	字典，提供從索引鍵到值的對應。
NSDictionary(NSObject, NSObject, NSObject[])	從 NSObject 索引鍵和 NSObject 值清單中建立 NSDictionary。
NSDictionary(NSObjectFlag)	在衍生類別上呼叫的建構函式，以略過初始化，並只配置 物件。
NSDictionary(NSUrl)	從位於指定 URL 的 PropertyList 內容建立新的字典。
NSDictionary(NSUrl, NSError)	字典，提供從索引鍵到值的對應。
NSDictionary(Object, Object, Object[])	從索引鍵和值清單建立 NSDictionary。
NSDictionary(String)	從位於指定檔案的 PropertyList 內容建立新的字典。

屬性

Class	字典，提供從索引鍵到值的對應。 (繼承來源 NSObject)
ClassHandle	這個類別的控制碼。
Count	傳回字典中的索引鍵數目。
DebugDescription	此物件的開發人員有意義描述。 (繼承來源 NSObject)
Description	物件的描述，ToString 的 Objective-C 版本。 (繼承來源 NSObject)
DescriptionInStringsFileFormat	字典的內容，格式為 .strings 檔案格式。
Handle	處理 unmanaged 物件標記法) (指標。 (繼承來源 NSObject)
IsDirectBinding	字典，提供從索引鍵到值的對應。 (繼承來源 NSObject)
IsProxy	字典，提供從索引鍵到值的對應。 (繼承來源 NSObject)
Item[NSObject]	傳回字典中索引鍵相關聯的值，如果找不到索引鍵，則傳回 null。
Item[NSString]	傳回字典中索引鍵相關聯的值，如果找不到索引鍵，則傳回 null。
Item[String]	傳回字典中索引鍵相關聯的值，如果找不到索引鍵，則傳回 null。
Keys	NSDictionary 的索引鍵集。
ObjectEnumerator	NSDictionary 中值的 NSEnumerator。
RetainCount	傳回物件的目前 Objective-C 保留計數。 (繼承來源 NSObject)
Self	字典，提供從索引鍵到值的對應。 (繼承來源 NSObject)
Superclass	字典，提供從索引鍵到值的對應。 (繼承來源 NSObject)
SuperHandle	用來表示這個 NSObject 基類中方法的控制碼。 (繼承來源 NSObject)
Values	NSDictionary 中的值陣列。
Zone	字典，提供從索引鍵到值的對應。 (繼承來源 NSObject)

方法

AddObserver(NSObject, NSString, NSKeyValueObservingOptions, IntPtr)	使用 NSString keyPath) ，註冊物件以供外部 (觀察。   觀察到的變更會分派至觀察者的 物件 ObserveValue(NSString, NSObject, NSDictionary, IntPtr) 方法。 (繼承來源 NSObject)
AddObserver(NSObject, String, NSKeyValueObservingOptions, IntPtr)	使用字串 keyPath) ，註冊物件以供外部觀察 (。   觀察到的變更會分派至觀察者的 物件 ObserveValue(NSString, NSObject, NSDictionary, IntPtr) 方法。 (繼承來源 NSObject)
AddObserver(NSString, NSKeyValueObservingOptions, Action<NSObservedChange>)	註冊物件，以使用任意方法在外部觀察。 (繼承來源 NSObject)
AddObserver(String, NSKeyValueObservingOptions, Action<NSObservedChange>)	註冊物件，以使用任意方法在外部觀察。 (繼承來源 NSObject)
AwakeFromNib()	從 nib 檔案載入物件之後呼叫。 覆寫程式必須呼叫基底。AwakeFromNib () 。 (繼承來源 NSObject)
BeginInvokeOnMainThread(Action)	字典，提供從索引鍵到值的對應。 (繼承來源 NSObject)
BeginInvokeOnMainThread(Selector, NSObject)	在主要 UI 執行緒上以非同步方式叫用指定的程式碼。 (繼承來源 NSObject)
Bind(NSString, NSObject, String, NSDictionary)	字典，提供從索引鍵到值的對應。 (繼承來源 NSObject)
Bind(String, NSObject, String, NSDictionary)	字典，提供從索引鍵到值的對應。 (繼承來源 NSObject)
BindingInfo(String)	字典，提供從索引鍵到值的對應。 (繼承來源 NSObject)
BindingOptionDescriptions(String)	字典，提供從索引鍵到值的對應。 (繼承來源 NSObject)
BindingValueClass(String)	字典，提供從索引鍵到值的對應。 (繼承來源 NSObject)
CommitEditing()	字典，提供從索引鍵到值的對應。 (繼承來源 NSObject)
CommitEditing(NSObject, Selector, IntPtr)	字典，提供從索引鍵到值的對應。 (繼承來源 NSObject)
ConformsToProtocol(IntPtr)	叫用以判斷這個物件是否實作指定的通訊協定。 (繼承來源 NSObject)
ContainsKey(NSObject)	判斷指定的索引鍵是否存在於字典中。
Copy()	執行基礎 Objective-C 物件的複本。 (繼承來源 NSObject)
Copy(NSZone)	執行基礎 Objective-C 物件的複本。
DangerousAutorelease()	字典，提供從索引鍵到值的對應。 (繼承來源 NSObject)
DangerousRelease()	字典，提供從索引鍵到值的對應。 (繼承來源 NSObject)
DangerousRetain()	字典，提供從索引鍵到值的對應。 (繼承來源 NSObject)
DidChange(NSKeyValueChange, NSIndexSet, NSString)	表示對多關聯性的索引發生變更。 (繼承來源 NSObject)
DidChange(NSString, NSKeyValueSetMutationKind, NSSet)	字典，提供從索引鍵到值的對應。 (繼承來源 NSObject)
DidChangeValue(String)	表示在指定的索引鍵上發生變更。 (繼承來源 NSObject)
Dispose()	釋放 NSObject 物件所使用的資源。 (繼承來源 NSObject)
Dispose(Boolean)	釋放 NSObject 物件所使用的資源。 (繼承來源 NSObject)
DoesNotRecognizeSelector(Selector)	表示這個物件無法辨識指定的選取器。 (繼承來源 NSObject)
EncodeTo(NSCoder)	編碼所提供編碼器上物件的狀態
Equals(NSObject)	字典，提供從索引鍵到值的對應。 (繼承來源 NSObject)
Equals(Object)	字典，提供從索引鍵到值的對應。 (繼承來源 NSObject)
ExposedBindings()	字典，提供從索引鍵到值的對應。 (繼承來源 NSObject)
FromDictionary(NSDictionary)	Factory 方法，用來建立新的 NSDictionary，該 NSDictionary 是指定來源 NSDictionary 的複本。
FromFile(String)	從位於指定檔案的 PropertyList 內容建立新的字典。
FromObjectAndKey(NSObject, NSObject)	Factory 方法，以指定的 obj (值) 和索引鍵，建立初始化的新 NSDictionary。
FromObjectsAndKeys(NSObject[], NSObject[])	從一組值和索引鍵建立字典。
FromObjectsAndKeys(NSObject[], NSObject[], nint)	從一組值和索引鍵建立字典。
FromObjectsAndKeys(Object[], Object[])	從一組值和索引鍵建立字典。
FromObjectsAndKeys(Object[], Object[], nint)	從一組值和索引鍵建立字典。
FromUrl(NSUrl)	從位於指定 URL 的 PropertyList 內容建立新的字典。
FromUrl(NSUrl, NSError)	字典，提供從索引鍵到值的對應。
GetBindingInfo(NSString)	字典，提供從索引鍵到值的對應。 (繼承來源 NSObject)
GetBindingOptionDescriptions(NSString)	字典，提供從索引鍵到值的對應。 (繼承來源 NSObject)
GetBindingValueClass(NSString)	字典，提供從索引鍵到值的對應。 (繼承來源 NSObject)
GetDictionaryOfValuesFromKeys(NSString[])	擷取指定索引鍵的值。 (繼承來源 NSObject)
GetEnumerator()	字典，提供從索引鍵到值的對應。
GetHashCode()	產生目前實例的雜湊碼。 (繼承來源 NSObject)
GetMethodForSelector(Selector)	字典，提供從索引鍵到值的對應。 (繼承來源 NSObject)
GetNativeField(String)	已淘汰. 字典，提供從索引鍵到值的對應。 (繼承來源 NSObject)
GetNativeHash()	字典，提供從索引鍵到值的對應。 (繼承來源 NSObject)
GetSharedKeySetForKeys(NSObject[])	為指定的金鑰建立共用金鑰集。
Init()	字典，提供從索引鍵到值的對應。 (繼承來源 NSObject)
InitializeHandle(IntPtr)	字典，提供從索引鍵到值的對應。 (繼承來源 NSObject)
InitializeHandle(IntPtr, String)	字典，提供從索引鍵到值的對應。 (繼承來源 NSObject)
Invoke(Action, Double)	字典，提供從索引鍵到值的對應。 (繼承來源 NSObject)
Invoke(Action, TimeSpan)	字典，提供從索引鍵到值的對應。 (繼承來源 NSObject)
InvokeOnMainThread(Action)	字典，提供從索引鍵到值的對應。 (繼承來源 NSObject)
InvokeOnMainThread(Selector, NSObject)	在主要 UI 執行緒上，以同步方式叫用指定的程式碼。 (繼承來源 NSObject)
IsEqual(NSObject)	字典，提供從索引鍵到值的對應。 (繼承來源 NSObject)
IsEqualToDictionary(NSDictionary)	如果字典具有相同的專案數目，而且對於所有索引鍵，則值會針對 Equals 傳回 true。
IsKindOfClass(Class)	字典，提供從索引鍵到值的對應。 (繼承來源 NSObject)
IsMemberOfClass(Class)	字典，提供從索引鍵到值的對應。 (繼承來源 NSObject)
KeysForObject(NSObject)	陣列，可能是空的索引鍵，其值等於指定的 obj。
LowlevelObjectForKey(IntPtr)	低階索引鍵查閱。
MarkDirty()	將一般對等物件升階 (IsDirectBinding 為 true) 為 toggleref 物件。 (繼承來源 NSObject)
MutableCopy()	建立指定之 NSObject 的可變動複本。 (繼承來源 NSObject)
MutableCopy(NSZone)	執行基礎 Objective-C 物件的複本。
ObjectDidEndEditing(NSObject)	字典，提供從索引鍵到值的對應。 (繼承來源 NSObject)
ObjectForKey(NSObject)	對應至指定索引鍵或 Null 的物件。
ObjectsForKeys(NSArray, NSObject)	指定索引鍵的 物件陣列。 如果找不到索引鍵，標記物件會放在傳回的陣列中，位於適當的索引處。
ObserveValue(NSString, NSObject, NSDictionary, IntPtr)	表示相對於這個物件的指定 keyPath 值已變更。 (繼承來源 NSObject)
PerformSelector(Selector)	字典，提供從索引鍵到值的對應。 (繼承來源 NSObject)
PerformSelector(Selector, NSObject)	字典，提供從索引鍵到值的對應。 (繼承來源 NSObject)
PerformSelector(Selector, NSObject, Double)	在目前的實例上叫用選取器，如果 obj 不是 null，它會將這個 當做其單一參數傳遞。 (繼承來源 NSObject)
PerformSelector(Selector, NSObject, Double, NSString[])	字典，提供從索引鍵到值的對應。 (繼承來源 NSObject)
PerformSelector(Selector, NSObject, NSObject)	字典，提供從索引鍵到值的對應。 (繼承來源 NSObject)
PerformSelector(Selector, NSThread, NSObject, Boolean)	字典，提供從索引鍵到值的對應。 (繼承來源 NSObject)
PerformSelector(Selector, NSThread, NSObject, Boolean, NSString[])	字典，提供從索引鍵到值的對應。 (繼承來源 NSObject)
PrepareForInterfaceBuilder()	字典，提供從索引鍵到值的對應。 (繼承來源 NSObject)
RemoveObserver(NSObject, NSString)	停止指定的觀察者接收指定 keyPath 變更值的進一步通知。 (繼承來源 NSObject)
RemoveObserver(NSObject, NSString, IntPtr)	停止指定的觀察者接收指定 keyPath 和內容之已變更值的進一步通知。 (繼承來源 NSObject)
RemoveObserver(NSObject, String)	停止指定的觀察者接收指定 keyPath 變更值的進一步通知。 (繼承來源 NSObject)
RemoveObserver(NSObject, String, IntPtr)	停止指定的觀察者接收指定 keyPath 和內容之已變更值的進一步通知。 (繼承來源 NSObject)
RespondsToSelector(Selector)	這個物件是否可辨識指定的選取器。 (繼承來源 NSObject)
SetNativeField(String, NSObject)	已淘汰. 字典，提供從索引鍵到值的對應。 (繼承來源 NSObject)
SetNilValueForKey(NSString)	將指定索引鍵的值設定為 null。 (繼承來源 NSObject)
SetValueForKey(NSObject, NSString)	將索引鍵所指定的屬性值設定為指定的值。 (繼承來源 NSObject)
SetValueForKeyPath(IntPtr, NSString)	建立 Unmanaged 物件的 Managed 標記法時所使用的建構函式;由執行時間呼叫。 (繼承來源 NSObject)
SetValueForKeyPath(NSObject, NSString)	設定可以使用索引鍵路徑到達的屬性值。 (繼承來源 NSObject)
SetValueForUndefinedKey(NSObject, NSString)	表示嘗試將值寫入未定義的索引鍵。 如果未覆寫，則會引發 NSUndefinedKeyException。 (繼承來源 NSObject)
SetValuesForKeysWithDictionary(NSDictionary)	將這個 NSObject 的值設定為指定字典中的值。 (繼承來源 NSObject)
ToFileAttributes()	字典，提供從索引鍵到值的對應。
ToString()	傳回目前實例值的字串表示。 (繼承來源 NSObject)
TryGetValue(NSObject, NSObject)	字典，提供從索引鍵到值的對應。
Unbind(NSString)	字典，提供從索引鍵到值的對應。 (繼承來源 NSObject)
Unbind(String)	字典，提供從索引鍵到值的對應。 (繼承來源 NSObject)
ValueForKey(NSString)	傳回與指定索引鍵相關聯的屬性值。 (繼承來源 NSObject)
ValueForKeyPath(NSString)	傳回可以使用索引鍵路徑到達的屬性值。 (繼承來源 NSObject)
ValueForUndefinedKey(NSString)	表示嘗試讀取未定義索引鍵的值。 如果未覆寫，則會引發 NSUndefinedKeyException。 (繼承來源 NSObject)
WillChange(NSKeyValueChange, NSIndexSet, NSString)	表示指定索引鍵中指定索引的值即將變更。 (繼承來源 NSObject)
WillChange(NSString, NSKeyValueSetMutationKind, NSSet)	字典，提供從索引鍵到值的對應。 (繼承來源 NSObject)
WillChangeValue(String)	表示指定的索引鍵值即將變更。 (繼承來源 NSObject)
WriteToFile(String, Boolean)	嘗試將 NSDictionary 寫入指定的路徑。 如果 useAuxiliaryFile 為 true，則會以不可部分完成的方式寫入檔案。 傳回成功或失敗。
WriteToUrl(NSUrl, Boolean)	嘗試將 NSDictionary 寫入指定的 URL，以及是否要以不可部分完成的方式執行此動作。 傳回成功或失敗。

明確介面實作

ICollection.CopyTo(Array, Int32)	字典，提供從索引鍵到值的對應。
ICollection.Count	字典，提供從索引鍵到值的對應。
ICollection.IsSynchronized	字典，提供從索引鍵到值的對應。
ICollection.SyncRoot	字典，提供從索引鍵到值的對應。
ICollection<KeyValuePair<NSObject,NSObject>>.Add(KeyValuePair<NSObject,NSObject>)	字典，提供從索引鍵到值的對應。
ICollection<KeyValuePair<NSObject,NSObject>>.Clear()	字典，提供從索引鍵到值的對應。
ICollection<KeyValuePair<NSObject,NSObject>>.Contains(KeyValuePair<NSObject,NSObject>)	字典，提供從索引鍵到值的對應。
ICollection<KeyValuePair<NSObject,NSObject>>.CopyTo(KeyValuePair<NSObject,NSObject>[], Int32)	建立這個 物件的複本，從指定的區域配置記憶體，如果引數為 Null，則從預設區域配置記憶體。
ICollection<KeyValuePair<NSObject,NSObject>>.Count	字典，提供從索引鍵到值的對應。
ICollection<KeyValuePair<NSObject,NSObject>>.IsReadOnly	字典，提供從索引鍵到值的對應。
ICollection<KeyValuePair<NSObject,NSObject>>.Remove(KeyValuePair<NSObject,NSObject>)	字典，提供從索引鍵到值的對應。
IDictionary.Add(Object, Object)	字典，提供從索引鍵到值的對應。
IDictionary.Clear()	字典，提供從索引鍵到值的對應。
IDictionary.Contains(Object)	字典，提供從索引鍵到值的對應。
IDictionary.GetEnumerator()	字典，提供從索引鍵到值的對應。
IDictionary.IsFixedSize	字典，提供從索引鍵到值的對應。
IDictionary.IsReadOnly	字典，提供從索引鍵到值的對應。
IDictionary.Item[Object]	字典，提供從索引鍵到值的對應。
IDictionary.Keys	字典，提供從索引鍵到值的對應。
IDictionary.Remove(Object)	字典，提供從索引鍵到值的對應。
IDictionary.Values	字典，提供從索引鍵到值的對應。
IDictionary<NSObject,NSObject>.Add(NSObject, NSObject)	字典，提供從索引鍵到值的對應。
IDictionary<NSObject,NSObject>.Keys	字典，提供從索引鍵到值的對應。
IDictionary<NSObject,NSObject>.Remove(NSObject)	字典，提供從索引鍵到值的對應。
IDictionary<NSObject,NSObject>.Values	字典，提供從索引鍵到值的對應。
IEnumerable.GetEnumerator()	字典，提供從索引鍵到值的對應。

擴充方法

GetDebugDescription(INSObjectProtocol)	字典，提供從索引鍵到值的對應。
GetAccessibilityCustomRotors(NSObject)	取得適用于 this 物件的陣列 UIAccessibilityCustomRotor 。
SetAccessibilityCustomRotors(NSObject, UIAccessibilityCustomRotor[])	設定適用于 this 物件的陣列 UIAccessibilityCustomRotor 。

另請參閱

• Apple 檔 NSDictionary