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)	アンマネージドオブジェクトのマネージド表現を作成するときに使用されるコンストラクター。ランタイムによって呼び出されます。
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 の逆シリアル化中に) 非アーキテクチャからクラスを初期化できるようにするために提供されます。これはプロトコルの NSCoding 一部です。

開発者がこのオブジェクトのサブクラスを作成し、アーカイブからの逆シリアル化を引き続きサポートする場合は、同じシグネチャを持つコンストラクターを実装する必要があります。型 NSCoder のパラメーターを 1 つ取得し、[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 を渡します。

注釈

このコンストラクターは、マネージドコードでオブジェクトを完全に構築し、ランタイムが NSObject を割り当てて初期化するだけで済む場合に、派生クラスによって呼び出される必要があります。これは Objective-C が使用する 2 段階の初期化プロセスを実装するために必要です。最初の手順はオブジェクトの割り当てを実行し、2 番目の手順はオブジェクトを初期化することです。開発者は、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

PropertyList 形式の NSDictionary を含むリソースの URL。

属性: ExportAttribute

適用対象

NSDictionary(IntPtr)

アンマネージドオブジェクトのマネージド表現を作成するときに使用されるコンストラクター。ランタイムによって呼び出されます。

protected internal NSDictionary (IntPtr handle);

new Foundation.NSDictionary : nativeint -> Foundation.NSDictionary

パラメーター

handle: IntPtr
nativeint

アンマネージオブジェクトへのポインター (ハンドル)。

注釈

このコンストラクターは、ランタイムインフラストラクチャ (GetNSObject(IntPtr)) によって呼び出され、アンマネージ Objective-C オブジェクトへのポインターの新しいマネージド表現を作成します。開発者は、このメソッドを直接呼び出さないでください。代わりに GetNSObject メソッドを呼び出す必要があります。これにより、マネージドオブジェクトの 2 つのインスタンスが同じネイティブオブジェクトを指すのを防ぐことができます。

適用対象

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

最初のキー。

second: Object

最初の値。

args: Object[]

キーと値の残りのパイ。

注釈

各 C# オブジェクトは、を呼び出 FromObject(Object)すことによって NSObject としてボックス化されます。

キーと値のリストは、ディクショナリの作成に使用されます。この関数に渡されるパラメーターの数は偶数である必要があります。

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

適用対象

次の方法で共有

NSDictionary コンストラクター

定義

オーバーロード

NSDictionary()

適用対象

NSDictionary(NSCoder)

パラメーター

注釈

適用対象

NSDictionary(NSDictionary)

パラメーター

適用対象

NSDictionary(NSObjectFlag)

パラメーター

注釈

適用対象

NSDictionary(NSUrl)

パラメーター

適用対象

NSDictionary(IntPtr)

パラメーター

注釈

適用対象

NSDictionary(String)

パラメーター

適用対象

NSDictionary(NSDictionary, Boolean)

パラメーター

適用対象

NSDictionary(NSUrl, NSError)

パラメーター

適用対象

NSDictionary(NSObject, NSObject, NSObject[])

パラメーター

注釈

適用対象

NSDictionary(Object, Object, Object[])

パラメーター

注釈

適用対象

その他のリソース