NSError Constructeurs

Définition

Espace de noms:

Foundation

Assembly:

Xamarin.iOS.dll

Surcharges

NSError()	N’utilisez pas le constructeur par défaut, sauf si vous avez affaire à une API de bas niveau qui initialise l’objet pour vous.
NSError(NSCoder)	Constructeur qui initialise l’objet à partir des données stockées dans l’objet unarchiver.
NSError(NSObjectFlag)	Constructeur pour appeler sur des classes dérivées pour ignorer l’initialisation et allouer simplement l’objet.
NSError(IntPtr)	Constructeur utilisé lors de la création de représentations managées d’objets non managés ; Appelé par le runtime.
NSError(NSString, nint)	Constructeur qui initialise l’objet avec un domaine et un code d’erreur spécifiés.
NSError(NSString, nint, NSDictionary)

NSError()

N’utilisez pas le constructeur par défaut, sauf si vous avez affaire à une API de bas niveau qui initialise l’objet pour vous.

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

NSError(NSCoder)

Constructeur qui initialise l’objet à partir des données stockées dans l’objet unarchiver.

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

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

Paramètres

coder

NSCoder

Objet unarchiver.

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.

NSError(NSObjectFlag)

Constructeur pour appeler sur des classes dérivées pour ignorer l’initialisation et allouer simplement l’objet.

protected NSError (Foundation.NSObjectFlag t);

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

Paramètres

t

NSObjectFlag

Valeur sentinel inutilisée, transmettez NSObjectFlag.Empty.

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

NSError(IntPtr)

Constructeur utilisé lors de la création de représentations managées d’objets non managés ; Appelé par le runtime.

protected internal NSError (IntPtr handle);

new Foundation.NSError : nativeint -> Foundation.NSError

Paramètres

handle

IntPtr

nativeint

Pointeur (handle) vers l’objet non managé.

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.

NSError(NSString, nint)

Constructeur qui initialise l’objet avec un domaine et un code d’erreur spécifiés.

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

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

Paramètres

domain

NSString

Domaine d’erreur

code

System.System.IntPtr System.nativeint

Code d’erreur.

NSError(NSString, nint, NSDictionary)

[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

domain

NSString

code

System.System.IntPtr System.nativeint

userInfo

NSDictionary

À ajouter.

Ce paramètre peut être null.

Attributs

ExportAttribute DesignatedInitializerAttribute