NSDictionary 建構函式

參考

定義

命名空間:: Foundation

組件:: Xamarin.iOS.dll

組件:: Xamarin.Mac.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

多載

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

NSDictionary()

預設建構函式，這個建構函式會初始化這個類別的新實例，不含任何參數。

[Foundation.Export("init")]
[ObjCRuntime.DesignatedInitializer]
public NSDictionary ();

屬性: ExportAttribute DesignatedInitializerAttribute

適用於

NSDictionary(NSCoder)

從儲存在 unarchiver 物件中的資料初始化物件的建構函式。

[Foundation.Export("initWithCoder:")]
[ObjCRuntime.DesignatedInitializer]
public NSDictionary (Foundation.NSCoder coder);

new Foundation.NSDictionary : Foundation.NSCoder -> Foundation.NSDictionary

參數

coder: NSCoder

unarchiver 物件。

屬性: ExportAttribute DesignatedInitializerAttribute

備註

提供這個建構函式，以允許在 NIB 還原序列化) 期間，從 unarchiver (初始化類別。這是通訊協定的 NSCoding 一部分。

如果開發人員想要建立這個物件的子類別，並繼續支援從封存還原序列化，他們應該實作具有相同簽章的建構函式：採用類型的 NSCoder 單一參數，並使用 [Export (「initWithCoder：」] 屬性宣告加以裝飾。

您也可以使用隨附方法 EncodeTo 序列化這個物件的狀態。

適用於

NSDictionary(NSDictionary)

從現有的 NSDictionary 建立新的 NSDictionary。

[Foundation.Export("initWithDictionary:")]
public NSDictionary (Foundation.NSDictionary other);

new Foundation.NSDictionary : Foundation.NSDictionary -> Foundation.NSDictionary

參數

other: NSDictionary

來源字典。

屬性: ExportAttribute

適用於

NSDictionary(NSObjectFlag)

呼叫衍生類別的建構函式，以略過初始化，並只配置物件。

protected NSDictionary (Foundation.NSObjectFlag t);

new Foundation.NSDictionary : Foundation.NSObjectFlag -> Foundation.NSDictionary

參數

t: NSObjectFlag

未使用的 sentinel 值，傳遞 NSObjectFlag.Empty。

備註

當衍生類別在 Managed 程式碼中完全建構物件時，應該呼叫這個建構函式，並只想要讓執行時間配置和初始化 NSObject。這是實作 Objective-C 所使用的雙步驟初始化程式的必要條件，第一個步驟是執行物件配置，第二個步驟是初始化物件。當開發人員叫用採用 NSObjectFlag.Empty 的建構函式時，它們會利用直接路徑，而直接路徑會移至 NSObject，只設定物件的記憶體，並將 Objective-C 和 C# 物件系結在一起。物件的實際初始化會由開發人員決定。

系結產生器通常會使用此建構函式來設定物件，但會防止實際初始化發生。配置完成之後，建構函式必須初始化物件。使用系結產生器所產生的建構函式，這表示它會手動叫用其中一個「init」方法來初始化物件。

如果開發人員使用 NSObjectFlag.Empty 路徑鏈結物件，開發人員必須負責完全初始化物件。

一般而言，如果開發人員的建構函式叫用 NSObjectFlag.Empty 基底實作，則它應該呼叫 Objective-C init 方法。如果這不是這種情況，開發人員應該改為將其類別中的適當建構函式鏈結在一起。

忽略引數值，而且只會確保唯一執行的程式碼是建構階段是基本的 NSObject 配置和執行時間類型註冊。通常鏈結看起來會像這樣：

//
// The NSObjectFlag merely allocates the object and registers the
// C# class with the Objective-C runtime if necessary, but no actual
// initXxx method is invoked, that is done later in the constructor
//
// This is taken from Xamarin.iOS's source code:
//
[Export ("initWithFrame:")]
public UIView (System.Drawing.RectangleF frame) : base (NSObjectFlag.Empty)
{
// Invoke the init method now.
	var initWithFrame = new Selector ("initWithFrame:").Handle;
	if (IsDirectBinding)
		Handle = ObjCRuntime.Messaging.IntPtr_objc_msgSend_CGRect (this.Handle, initWithFrame, frame);
	else
		Handle = ObjCRuntime.Messaging.IntPtr_objc_msgSendSuper_CGRect (this.SuperHandle, initWithFrame, frame);
}

適用於

NSDictionary(NSUrl)

從位於指定 URL 的 PropertyList 內容建立新的字典。

[Foundation.Export("initWithContentsOfURL:")]
public NSDictionary (Foundation.NSUrl url);

new Foundation.NSDictionary : Foundation.NSUrl -> Foundation.NSDictionary

參數

url: NSUrl

Url 至資源，其中包含 PropertyList 格式的 NSDictionary。

屬性: ExportAttribute

適用於

NSDictionary(IntPtr)

建立 Unmanaged 物件的 Managed 標記法時所使用的建構函式;由執行時間呼叫。

protected internal NSDictionary (IntPtr handle);

new Foundation.NSDictionary : nativeint -> Foundation.NSDictionary

參數

handle: IntPtr
nativeint

指向 Unmanaged 物件的指標 (控制碼) 。

備註

執行時間基礎結構會叫用此建構函式 () GetNSObject(IntPtr) ，為 Unmanaged Objective-C 物件的指標建立新的 Managed 標記法。開發人員不應該直接叫用此方法，而是應該呼叫 GetNSObject 方法，因為它會防止 Managed 物件的兩個實例指向相同的原生物件。

適用於

NSDictionary(String)

從位於指定檔案的 PropertyList 內容建立新的字典。

[Foundation.Export("initWithContentsOfFile:")]
public NSDictionary (string fileName);

new Foundation.NSDictionary : string -> Foundation.NSDictionary

參數

fileName: String

包含屬性清單格式化字典的檔案。

屬性: ExportAttribute

適用於

NSDictionary(NSDictionary, Boolean)

[Foundation.Export("initWithDictionary:copyItems:")]
public NSDictionary (Foundation.NSDictionary other, bool copyItems);

new Foundation.NSDictionary : Foundation.NSDictionary * bool -> Foundation.NSDictionary

參數

other: NSDictionary

copyItems: Boolean

屬性: ExportAttribute

適用於

NSDictionary(NSUrl, NSError)

[Foundation.Export("initWithContentsOfURL:error:")]
[ObjCRuntime.Introduced(ObjCRuntime.PlatformName.WatchOS, 4, 0, ObjCRuntime.PlatformArchitecture.All, null)]
[ObjCRuntime.Introduced(ObjCRuntime.PlatformName.TvOS, 11, 0, ObjCRuntime.PlatformArchitecture.All, null)]
[ObjCRuntime.Introduced(ObjCRuntime.PlatformName.MacOSX, 10, 13, ObjCRuntime.PlatformArchitecture.All, null)]
[ObjCRuntime.Introduced(ObjCRuntime.PlatformName.iOS, 11, 0, ObjCRuntime.PlatformArchitecture.All, null)]
public NSDictionary (Foundation.NSUrl url, out Foundation.NSError error);

new Foundation.NSDictionary : Foundation.NSUrl *  -> Foundation.NSDictionary

參數

url: NSUrl

error: NSError

屬性: ExportAttribute IntroducedAttribute

適用於

NSDictionary(NSObject, NSObject, NSObject[])

從 NSObject 索引鍵和 NSObject 值清單中建立 NSDictionary。

public NSDictionary (Foundation.NSObject first, Foundation.NSObject second, params Foundation.NSObject[] args);

new Foundation.NSDictionary : Foundation.NSObject * Foundation.NSObject * Foundation.NSObject[] -> Foundation.NSDictionary

參數

first: NSObject

第一個索引鍵。

second: NSObject

第一個值。

args: NSObject[]

索引鍵和值的其餘分頁。

備註

索引鍵和值的清單可用來建立字典。傳遞至此函式的參數數目必須是偶數。

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);

適用於

NSDictionary(Object, Object, Object[])

從索引鍵和值清單中建立 NSDictionary。

public NSDictionary (object first, object second, params object[] args);

new Foundation.NSDictionary : obj * obj * obj[] -> Foundation.NSDictionary

參數

first: Object