NSObject クラス

定義

[Foundation.Register("NSObject", true)]
public class NSObject : Foundation.INSObjectProtocol, IDisposable, IEquatable<Foundation.NSObject>

type NSObject = class
    interface INSObjectProtocol
    interface INativeObject
    interface IDisposable
    interface IEquatable<NSObject>

継承

Object

NSObject

派生

Accounts.ACAccount

Accounts.ACAccountCredential

Accounts.ACAccountStore

Accounts.ACAccountType

AddressBookUI.ABNewPersonViewControllerDelegate

その他…

属性

RegisterAttribute

実装

INSObjectProtocol INativeObject IDisposable IEquatable<NSObject>

注釈

これは、Objective-C クラスを C# クラスにバインドするために使用される基本クラスです。 NSObject からサブクラス化するだけで、Objective-C に渡すことができるクラスが生成されます。

C# NSObject クラスとそのサブクラスは、基になる Objective-C インスタンスのマネージド表現です。 アンマネージ コード Objective-C オブジェクトへのポインターは、 プロパティに Handle 格納されます。

現時点では、コンパイラでは NSObject のジェネリック サブクラスはサポートされていないことに注意してください。

クラスの登録

NSObject のサブクラスを作成すると、このサブクラスは、実装の詳細である完全な .NET 型名に基づく名前で Objective-C ランタイムに登録されます。 Objective-C ランタイムで C# クラスが特定の名前で公開されるようにする必要がある場合は、 T:ObjCRuntime.RegisterAttribute を クラスに適用し、クラスに含める名前を指定できます。

上記は、通常、一部の Objective-C コードでクラスを名前で参照する場合、Interface Builder XIB ファイルとストーリーボード ファイルを使用する場合、または Objective-C シリアル化セットアップを使用している場合 (たとえば、 を使用する場合) に使用 NSCoderされます。

//
// This exposes the C# class _MySampleView as the Objective-C MyView
//
[Export ("MyView")]
public class _MySampleView : UIView {

}

Objective-C メソッド

一般に、MonoTouch クラスは 1 つを基になる Objective-C クラスにマップします。 たとえば、C# クラス "MonoTouch.Foundation.NSObject" は Objective-C "NSObject" クラスにマップされます。 しかし、メソッドは異なります。 Objective-C メソッドは C# メソッドに適切に変換されないため、C# 言語、C# イディオム、および.NET Framework設計ガイドラインの両方に一致するように一般的に変更されています。

Objective-C メソッドは、特殊な が適用された仮想メソッドとして C# に表示されます。 この属性は、C# 名を Objective-C 名にマップするためにコンパイラによって使用されます。 これらの属性は、特定の C# メソッドが呼び出している Objective-C メソッドを識別するのに役立つ、各関数の上にある API ドキュメントに示されています。

クラスの動作を変更するには、標準の C# イディオムを使用します。サブクラスを作成し、変更するメソッドをオーバーライドし、"base" を使用します。 言語機能を使用して、必要に応じて基底クラスを呼び出すことができます。

public class MyView : UISlider {
	public override void Draw (RectangleF rect)
	{
		// Let the base class draw first
		base.Draw (rect);

		// Our custom code
		var ctx = UIGraphics.GetCurrentContext ();
		UIColor.Gray.SetColor ();
		ctx.StrokeEllipseInRect (rect);
	}
}

既定では、上書きされたメソッドのみが Objective-C の世界に公開されます。 任意の C# メソッドを Objective-C ワールドに公開する場合は、 T:ObjCRuntime.ExportAttribute をパブリック メソッドに適用する必要があります。 また、これは静的メソッドとインスタンス メソッドの両方に対して実行できます。 属性が適用されると、メソッドは Objective-C に公開され、ランタイムでサポートされている標準データ型マーシャリング操作がそれらのメソッドで使用できるようになります。

//
// Exposes the class StringUtilities to Objective-C with the 
// method:
//    - (NSString *) joinArray:(NSArray *) stringArray withSeparator:(NSString *sep);
//
// Used like this:
//   id utilities = [[StringUtilities alloc] init];
//   NSLog (@"Joined: %@", [utilities joinArray:users withSeparator:@", "]);
//
public class StringUtilities : NSObject {
	[Export ("joinArray:withSeparator:")]
	public string Join (string [] array, string separator)
	{
		return string.Join (separator, array);
	}
}

ライフサイクル

C# NSObject とそのサブクラスは、基になる Objective-C オブジェクトのマネージド ラッパーです。 これらは、"new" 演算子を使用して新しいインスタンスを作成するとき、または既存のアンマネージド オブジェクトが C# ワールドに表示されるときに、C# から作成されます。

"new" 演算子を使用して C# からオブジェクトを作成すると、オブジェクトは最初は C# によって所有され、C# は オブジェクトへの参照を保持します。 この参照は、ガベージ コレクターが保留中のマネージド参照がないと判断した場合、またはオブジェクトに対して Dispose メソッドを手動で呼び出した場合にのみ削除されます。

C# NSObjects は、NSObject を返すメソッドまたはプロパティを呼び出すときにも、必要に応じて作成されます。 この時点で、ランタイムはオブジェクト キャッシュを調べて、特定の Objective-C NSObject が既にマネージド ワールドに表示されているかどうかを判断します。 オブジェクトが表示されている場合は、既存のオブジェクトが返されます。それ以外の場合は、IntPtr をパラメーターとして受け取るコンストラクターが呼び出され、オブジェクトが構築されます。

フレームワーク オブジェクト (Objective-C オブジェクトの単なる C# 表現であり、追加の管理された関連付けられた状態を持たないオブジェクト) に対する純粋な "ピア" は、前に説明したコンストラクターを使用して、必要に応じてランタイムによって再作成できます。

NSObjects のユーザー サブクラスには C# 状態が含まれることがよくあります。そのため、Objective-C ランタイムがこれらのオブジェクトのいずれかに対して "保持" 操作を実行するたびに、ランタイムは、オブジェクトへの C# 参照がない場合でも、マネージド オブジェクトを維持する GCHandle を作成します。 これにより、状態が自動的に保持されるため、予約が大幅に簡略化されます。

NSObject に対する Dispose 操作では、基になる Objective-C オブジェクトへの参照は常に削除されますが、マネージド状態は破棄されません。これは、マネージド コードとアンマネージ コードの両方がオブジェクトを解放した場合にのみ発生します。 これは .NET とは若干異なります。.NET では、オブジェクトが破棄されると、オブジェクトに対してメソッドを呼び出すことはできません。これは役に立たないと見なされるためです。 これは NSObjects の場合ではありません。

プロトコルの採用

MonoTouch では、ほとんどの Objective-C プロトコルは :ObjCRuntime.ModelAttribute が適用されているクラスにマップされます。 また、プロトコルを採用する方法は、採用するメソッドをサブクラス化して上書きすることです。

まれに、アドホック プロトコルを独自に採用する場合があります。 Objective-C プロトコルを採用する必要がある場合は、クラスで を AdoptsAttribute 使用し、採用するプロトコルの名前を指定する必要があります。 通常、プロトコルを採用する場合は、 を使用して採用しているすべての Objective-C セレクターも一覧表示する必要があります。

[Adopts ("NSLocking")]
public class MyLockeingObject : NSObject {
	[Export ("lock")]
	public void Lock ()
	{
		// ...
	}

	[Export ("unlock")]
	public void Unlock ()
	{
		// ...
	}
}

キー値のコーディング

キー値のコーディングは、C# メソッドを使用して直接アクセスするのではなく、オブジェクトのプロパティに名前でアクセスできるようにするメカニズムです。

C# プロパティをKey-Valueコーディング システムに公開するには、 T:ObjCRuntime.ExportAttribute をプロパティに追加するだけです。 名前には ASCII 文字のみを含める必要があり、小文字で始まり、スペースを含めることはできません。

public class CircleLayer : CALayer {
	[Export ("radius")]
	public double Radius { get; set; }

	// ...
}

M:Foundation.ValueForKey(Foundation.NSString);* メソッドを使用して名前を使用してプロパティを検索し、M:Foundation.SetValueForKey(Foundation.NSObject, Foundation.NSString);*" メソッドを使用して、指定したプロパティの値を設定します。 たとえば、foo を呼び出します。オブジェクト内の user プロパティの値を取得する ValueForKey ("user")。

さらに、キー パスを使用して、ランタイムで ValueForKey または SetValueForKey を繰り返し呼び出すことができます。 ドットを使用してキーを区切る。 たとえば、キーパス "user.address.phone.mobile" はユーザー プロパティを要求し、ユーザーに対して address プロパティを要求した後、アドレスの phone プロパティを要求し、最後に電話でモバイル プロパティを要求し、最後に結果を値として使用します。 キーパスを使用してプロパティを検索するには M:Foundation.ValueForKeyPath(Foundation.NSString);* を 使用し、キーパスを使用して値を設定するには M:Foundation.SetValueForKeyPath(Foundation.NSObject, Foundation.NSString);* を使用します。

キーパスを使用する場合、ルックアップが失敗した場合、値の設定時に が SetValueForUndefinedKey(NSObject, NSString) 呼び出され、値を検索するときに が ValueForUndefinedKey(NSString) 呼び出されます。 既定では、どちらのメソッドでも Objective-C 例外が発生します。メソッドをオーバーライドすることで、その動作を変更できます。

キー値の監視

キー値監視は、NSObject によって実装されるメカニズムであり、キー値コーディング システムを介して NSObject に対して行われた変更を監視するために使用できます。

クラスで通知を確認するには、呼び出されるメソッドを ObserveValue(NSString, NSObject, NSDictionary, IntPtr) 、特定のキーパスの値の変更に関する情報でオーバーライドする必要があります。 次に、 を AddObserver(NSObject, NSString, NSKeyValueObservingOptions, IntPtr) 使用して変更の監視を開始し、 メソッドを RemoveObserver(NSObject, NSString, IntPtr) 使用して通知の受信を停止します。

コンストラクター

フィールド

プロパティ

メソッド

拡張メソッド

適用対象

こちらもご覧ください

• Apple のドキュメント NSObject