NSError Constructeurs

[Foundation.Advice("Always specify a domain and error code when creating an NSError instance")]
public NSError ();

Attributs

AdviceAttribute

Remarques

Le constructeur par défaut pour NSError laisse l’objet dans un état partiel qui ne peut être initialisé que par une poignée d’API Objective-C de bas niveau. En général, vous ne devez pas utiliser ce constructeur, mais plutôt utiliser le constructeur qui accepte un argument de domaine d’erreur NSString.

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

new Foundation.NSError : Foundation.NSCoder -> Foundation.NSError

Paramètres

Attributs

ExportAttribute DesignatedInitializerAttribute

Remarques

Ce constructeur est fourni pour permettre à la classe d’être initialisée à partir d’un déséquilibreur (par exemple, lors de la désérialisation niB). Cela fait partie du NSCoding protocole.

Si les développeurs souhaitent créer une sous-classe de cet objet et continuer à prendre en charge la désérialisation à partir d’une archive, ils doivent implémenter un constructeur avec une signature identique : prendre un paramètre unique de type NSCoder et le décorer avec la déclaration d’attribut [Export(« initWithCoder:"] .

L’état de cet objet peut également être sérialisé à l’aide de la méthode complémentaire EncodeTo.

protected NSError (Foundation.NSObjectFlag t);

new Foundation.NSError : Foundation.NSObjectFlag -> Foundation.NSError

Paramètres

Remarques

Ce constructeur doit être appelé par les classes dérivées lorsqu’elles construisent complètement l’objet en code managé et veulent simplement que le runtime alloue et initialise le NSObject. Cela est nécessaire pour implémenter le processus d’initialisation en deux étapes utilisé par Objective-C, la première étape consiste à effectuer l’allocation d’objets, la deuxième étape consiste à initialiser l’objet. Lorsque les développeurs appellent le constructeur qui utilise NSObjectFlag.Empty, ils tirent parti d’un chemin d’accès direct qui va jusqu’à NSObject pour allouer simplement la mémoire de l’objet et lier les objets Objective-C et C#. L’initialisation réelle de l’objet appartient au développeur.

Ce constructeur est généralement utilisé par le générateur de liaisons pour allouer l’objet, mais empêche l’initialisation réelle de se produire. Une fois l’allocation effectuée, le constructeur doit initialiser l’objet . Avec les constructeurs générés par le générateur de liaisons, cela signifie qu’il appelle manuellement l’une des méthodes « init » pour initialiser l’objet.

Il incombe au développeur d’initialiser complètement l’objet s’il est enchaîné à l’aide du chemin NSObjectFlag.Empty.

En général, si le constructeur du développeur appelle l’implémentation de base NSObjectFlag.Empty, il doit appeler une méthode d’init Objective-C. Si ce n’est pas le cas, les développeurs doivent plutôt chaîner au constructeur approprié dans leur classe.

La valeur de l’argument est ignorée et garantit simplement que le seul code exécuté est la phase de construction est l’allocation NSObject de base et l’inscription du type d’exécution. En règle générale, le chaînage ressemble à ceci :

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

protected internal NSError (IntPtr handle);

new Foundation.NSError : nativeint -> Foundation.NSError

Paramètres

Remarques

Ce constructeur est appelé par l’infrastructure d’exécution (GetNSObject(IntPtr)) pour créer une représentation managée pour un pointeur vers un objet Objective-C non managé. Les développeurs ne doivent pas appeler cette méthode directement, mais ils doivent appeler la méthode GetNSObject, car elle empêchera deux instances d’un objet managé de pointer vers le même objet natif.

public NSError (Foundation.NSString domain, nint code);

new Foundation.NSError : Foundation.NSString * nint -> Foundation.NSError

Paramètres

[Foundation.Export("initWithDomain:code:userInfo:")]
[ObjCRuntime.DesignatedInitializer]
public NSError (Foundation.NSString domain, nint code, Foundation.NSDictionary userInfo);

new Foundation.NSError : Foundation.NSString * nint * Foundation.NSDictionary -> Foundation.NSError

Paramètres

Attributs

ExportAttribute DesignatedInitializerAttribute