NSDictionary Constructeurs

Définition

Espace de noms:

Foundation

Assembly:

Xamarin.iOS.dll

Surcharges

NSDictionary()	Constructeur par défaut qui initialise une nouvelle instance de cette classe sans paramètres.
NSDictionary(NSCoder)	Constructeur qui initialise l’objet à partir des données stockées dans l’objet unarchiver.
NSDictionary(NSDictionary)	Crée un NSDictionary à partir d’un NSDictionary existant.
NSDictionary(NSObjectFlag)	Constructeur pour appeler sur des classes dérivées pour ignorer l’initialisation et allouer simplement l’objet.
NSDictionary(NSUrl)	Crée un dictionnaire à partir du contenu d’un PropertyList situé à une URL spécifiée.
NSDictionary(IntPtr)	Constructeur utilisé lors de la création de représentations managées d’objets non managés ; Appelé par le runtime.
NSDictionary(String)	Crée un dictionnaire à partir du contenu d’un PropertyList situé dans le fichier spécifié.
NSDictionary(NSDictionary, Boolean)
NSDictionary(NSUrl, NSError)
NSDictionary(NSObject, NSObject, NSObject[])	Crée un NSDictionary à partir d’une liste de clés NSObject et de valeurs NSObject.
NSDictionary(Object, Object, Object[])	Crée un NSDictionary à partir d’une liste de clés et de valeurs.

NSDictionary()

Constructeur par défaut qui initialise une nouvelle instance de cette classe sans paramètres.

[Foundation.Export("init")]
[ObjCRuntime.DesignatedInitializer]
public NSDictionary ();

Attributs

ExportAttribute DesignatedInitializerAttribute

NSDictionary(NSCoder)

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

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

new Foundation.NSDictionary : Foundation.NSCoder -> Foundation.NSDictionary

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.

NSDictionary(NSDictionary)

Crée un NSDictionary à partir d’un NSDictionary existant.

[Foundation.Export("initWithDictionary:")]
public NSDictionary (Foundation.NSDictionary other);

new Foundation.NSDictionary : Foundation.NSDictionary -> Foundation.NSDictionary

Paramètres

other

NSDictionary

Dictionnaire source.

Attributs

ExportAttribute

NSDictionary(NSObjectFlag)

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

protected NSDictionary (Foundation.NSObjectFlag t);

new Foundation.NSDictionary : Foundation.NSObjectFlag -> Foundation.NSDictionary

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

NSDictionary(NSUrl)

Crée un dictionnaire à partir du contenu d’un PropertyList situé à une URL spécifiée.

[Foundation.Export("initWithContentsOfURL:")]
public NSDictionary (Foundation.NSUrl url);

new Foundation.NSDictionary : Foundation.NSUrl -> Foundation.NSDictionary

Paramètres

url

NSUrl

URL de la ressource contenant un NSDictionary au format PropertyList.

Attributs

ExportAttribute

NSDictionary(IntPtr)

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

protected internal NSDictionary (IntPtr handle);

new Foundation.NSDictionary : nativeint -> Foundation.NSDictionary

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.

NSDictionary(String)

Crée un dictionnaire à partir du contenu d’un PropertyList situé dans le fichier spécifié.

[Foundation.Export("initWithContentsOfFile:")]
public NSDictionary (string fileName);

new Foundation.NSDictionary : string -> Foundation.NSDictionary

Paramètres

fileName

String

Fichier contenant un dictionnaire au format liste de propriétés.

Attributs

ExportAttribute

NSDictionary(NSDictionary, Boolean)

[Foundation.Export("initWithDictionary:copyItems:")]
public NSDictionary (Foundation.NSDictionary other, bool copyItems);

new Foundation.NSDictionary : Foundation.NSDictionary * bool -> Foundation.NSDictionary

Paramètres

other

NSDictionary

copyItems

Boolean

Attributs

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

Paramètres

url

NSUrl

error

NSError

Attributs

ExportAttribute IntroducedAttribute

NSDictionary(NSObject, NSObject, NSObject[])

Crée un NSDictionary à partir d’une liste de clés NSObject et de valeurs NSObject.

public NSDictionary (Foundation.NSObject first, Foundation.NSObject second, params Foundation.NSObject[] args);

new Foundation.NSDictionary : Foundation.NSObject * Foundation.NSObject * Foundation.NSObject[] -> Foundation.NSDictionary

Paramètres

first

NSObject

Première clé.

second

NSObject

Première valeur.

args

NSObject[]

Nombre restant de clés et de valeurs.

Remarques

La liste des clés et des valeurs est utilisée pour créer le dictionnaire. Le nombre de paramètres passés à cette fonction doit être pair.

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

Crée un NSDictionary à partir d’une liste de clés et de valeurs.

public NSDictionary (object first, object second, params object[] args);

new Foundation.NSDictionary : obj * obj * obj[] -> Foundation.NSDictionary

Paramètres

first

Object

Première clé.

second

Object

Première valeur.

args

Object[]

Nombre restant de clés et de valeurs.

Remarques

Chaque objet C# est boxé en tant que NSObject en appelant FromObject(Object).

La liste des clés et des valeurs est utilisée pour créer le dictionnaire. Le nombre de paramètres passés à cette fonction doit être pair.

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