NSObject Classe

Définition

[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>

Héritage

Object

NSObject

Dérivé

Accounts.ACAccount

Accounts.ACAccountCredential

Accounts.ACAccountStore

Accounts.ACAccountType

AddressBookUI.ABNewPersonViewControllerDelegate

Plus…

Attributs

RegisterAttribute

Implémente

INSObjectProtocol INativeObject IDisposable IEquatable<NSObject>

Remarques

Il s’agit de la classe de base utilisée pour lier des classes Objective-C à des classes C#. La simple sous-classification de NSObject génère une classe qui peut être passée à Objective-C.

La classe NSObject C# et ses sous-classes sont des représentations managées des instances Objective-C sous-jacentes. Le pointeur vers l’objet Objective-C du code non managé est stocké dans la Handle propriété .

Il est important de noter qu’actuellement, le compilateur ne prend pas en charge les sous-classes génériques de NSObject.

Inscription de classe

Lorsque vous créez une sous-classe de NSObject, cette sous-classe est inscrite auprès du runtime Objective-C avec un nom basé sur le nom de type .NET complet, qui est un détail d’implémentation. Si vous devez vous assurer qu’une classe C# est exposée avec un nom spécifique dans le runtime Objective-C, vous pouvez appliquer le T:ObjCRuntime.RegisterAttribute à la classe et spécifier le nom que vous souhaitez que votre classe ait.

Les éléments ci-dessus sont généralement utilisés dans les cas où vous souhaitez référencer la classe par un nom sur un code Objective-C, lors de l’utilisation de fichiers XIB et Storyboard du Générateur d’interface ou lorsque vous utilisez une configuration de sérialisation Objective-C (par exemple, lors de l’utilisation NSCoderde ).

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

}

Méthodes Objective-C

En général, les classes MonoTouch mappent un à un aux classes Objective-C sous-jacentes. Par exemple, la classe C# « MonoTouch.Foundation.NSObject » est mappée à la classe Objective-C « NSObject ». Mais les méthodes sont différentes. Les méthodes Objective-C ne se traduisent pas correctement en méthodes C#, de sorte qu’elles ont été en général modifiées pour correspondre à la fois au langage C#, aux idiomes C# et aux instructions de conception du .NET Framework.

Les méthodes Objective-C sont exposées en C# en tant que méthodes virtuelles auxquelles la T:ObjCRuntime.ExportAttribute spéciale leur est appliquée. Cet attribut est utilisé par le compilateur pour mapper les noms C# aux noms Objective-C. Ces attributs sont présentés dans la documentation de l’API en plus de chaque fonction, pour vous aider à identifier la méthode Objective-C qu’une méthode C# particulière appelle.

Pour modifier le comportement d’une classe, vous utilisez les idiomes C# standard : créez une sous-classe et remplacez les méthodes que vous souhaitez modifier et utilisez la « base ». fonctionnalité de langage pour appeler éventuellement votre classe de 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);
	}
}

Par défaut, seules les méthodes qui ont été remplacées sont exposées au monde Objective-C. Si vous souhaitez exposer une méthode C# arbitraire au monde Objective-C, vous devez appliquer la T:ObjCRuntime.ExportAttribute à votre méthode publique. Et cela peut être effectué à la fois pour les méthodes statiques et d’instance. Une fois l’attribut appliqué, la méthode est exposée à Objective-C et les opérations de marshaling de type de données standard prises en charge par le runtime sont mises à la disposition de ces méthodes.

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

Cycle de vie

Le NSObject C# et ses sous-classes sont des wrappers managés pour l’objet Objective-C sous-jacent. Celles-ci sont créées à partir de C#, lorsque vous créez une instance à l’aide de l’opérateur « new » ou lorsqu’un objet non managé existant est exposé dans le monde C#.

Lorsque vous créez un objet à partir de C# à l’aide de l’opérateur « new », l’objet appartient initialement à C#, et C# conserve une référence à l’objet . Cette référence n’est supprimée que lorsque le garbage collector détermine qu’il n’y a aucune référence managée en attente, ou lorsque vous appelez manuellement la méthode Dispose sur l’objet .

Les NSObjects C# sont également créés à la demande lorsque vous appelez une méthode ou une propriété qui retourne un NSObject. À ce stade, le runtime examine un cache d’objets et détermine si un NSObject Objective-C donné a déjà été exposé dans le monde managé ou non. Si l’objet a été exposé, l’objet existant est retourné. Sinon, un constructeur qui prend un IntPtr comme paramètre est appelé pour construire l’objet.

Les « homologues » purs aux objets framework (ceux qui sont simplement des représentations C# d’un objet Objective-C et qui n’ont pas d’état managé associé supplémentaire) peuvent être recréés par le runtime à la demande à l’aide du constructeur mentionné précédemment.

Les sous-classes utilisateur de NSObjects contiennent souvent l’état C#. Par conséquent, chaque fois que le runtime Objective-C effectue une opération de « conservation » sur l’un de ces objets, le runtime crée un GCHandle qui maintient l’objet managé actif, même s’il n’existe aucune référence C# visible à l’objet. Cela simplifie beaucoup l’boométrie, car l’état est conservé automatiquement pour vous.

L’opération Supprimer sur un NSObject supprime toujours la référence à l’objet Objective-C sous-jacent, mais ne détruit pas l’état managé. Cela ne se produit que lorsque le code managé et le code non managé ont tous deux libéré les objets. Cela diffère légèrement de .NET, car sur .NET, une fois qu’un objet est supprimé, il n’est pas possible d’appeler des méthodes sur l’objet, car il est considéré comme inutile. Ce n’est pas le cas avec NSObjects.

Adoption de protocoles

Dans MonoTouch, la plupart des protocoles Objective-C sont mappés à des classes auxquelles T:ObjCRuntime.ModelAttribute est appliqué. Et la façon dont vous adoptez un protocole consiste à sous-classer et à remplacer les méthodes que vous souhaitez adopter.

Il existe quelques rares cas où vous souhaitez adopter un protocole ad hoc par vous-même. Si vous devez adopter un protocole Objective-C, vous devez utiliser sur AdoptsAttribute votre classe et fournir le nom du protocole que vous souhaitez adopter. En règle générale, lors de l’adoption d’un protocole, vous devez également répertorier tous les sélecteurs Objective-C que vous adoptez à l’aide de T:ObjCRuntime.ExportAttribute.

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

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

Codage de valeur clé

Le codage valeur de clé est un mécanisme qui vous permet d’accéder aux propriétés d’un objet par leur nom, au lieu d’y accéder directement avec une méthode C#.

Pour exposer une propriété C# au système de codage Key-Value, il vous suffit d’ajouter le T:ObjCRuntime.ExportAttribute à votre propriété. Les noms doivent uniquement contenir des caractères ASCII, commencer par une lettre minuscule et ne pas contenir d’espaces.

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

	// ...
}

Vous utilisez les méthodes M:Foundation.ValueForKey(Foundation.NSString);* pour rechercher une propriété à l’aide d’un nom, et vous utilisez les fonctions M:Foundation.SetValueForKey(Foundation.NSObject, Foundation.NSString);* » pour définir la valeur de la propriété spécifiée. Par exemple, vous pouvez appeler foo. ValueForKey (« utilisateur ») pour récupérer la valeur de la propriété user dans un objet .

En outre, vous pouvez utiliser des chemins d’accès de clé pour que le runtime appelle à plusieurs reprises valueForKey ou SetValueForKey pour vous. Vous séparez les clés à l’aide d’un point. Par exemple, le chemin de touche « user.address.phone.mobile » demande la propriété de l’utilisateur, puis demande la propriété address sur l’utilisateur, puis demande la propriété de téléphone sur l’adresse et enfin demande la propriété mobile sur le téléphone et enfin utilise le résultat comme valeur. Vous utilisez M:Foundation.ValueForKeyPath(Foundation.NSString);* pour rechercher une propriété à l’aide d’un chemin de clé, et vous utilisez M:Foundation.SetValueForKeyPath(Foundation.NSObject, Foundation.NSString);* pour définir une valeur à l’aide d’un chemin de clé.

Lors de l’utilisation de chemins de clés, si une recherche échoue, le est appelé lors de la SetValueForUndefinedKey(NSObject, NSString) définition d’une valeur et le est appelé lors de la ValueForUndefinedKey(NSString) recherche d’une valeur. Par défaut, les deux méthodes déclenchent une exception Objective-C. Vous pouvez modifier ce comportement en remplaçant les méthodes.

Observation de la valeur clé

L’observation de la valeur de clé est un mécanisme implémenté par NSObject qui peut être utilisé pour surveiller les modifications apportées à un NSObject via le système de codage de valeur de clé.

Pour que votre classe observe une notification, vous devez remplacer la ObserveValue(NSString, NSObject, NSDictionary, IntPtr) méthode qui sera appelée avec les informations sur les modifications de valeur d’un chemin de clé spécifique. Ensuite, vous utilisez pour AddObserver(NSObject, NSString, NSKeyValueObservingOptions, IntPtr) commencer à observer les modifications et la RemoveObserver(NSObject, NSString, IntPtr) méthode pour arrêter de recevoir des notifications.

Constructeurs

Champs

Propriétés

Méthodes

Méthodes d’extension

S’applique à

Voir aussi

• Documentation Apple pour NSObject