NSDictionary Construtores

Referência

Definição

Namespace:: Foundation

Assembly:: Xamarin.iOS.dll

Assembly:: Xamarin.Mac.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Sobrecargas

NSDictionary()	Construtor padrão que inicializa uma nova instância dessa classe sem parâmetros.
NSDictionary(NSCoder)	Um construtor que inicializa o objeto dos dados armazenados no objeto unarchiver.
NSDictionary(NSDictionary)	Cria um novo NSDictionary de um NSDictionary existente.
NSDictionary(NSObjectFlag)	Construtor para chamar em classes derivadas para ignorar a inicialização e simplesmente alocar o objeto.
NSDictionary(NSUrl)	Cria um novo dicionário com base no conteúdo de uma PropertyList localizada em uma URL especificada.
NSDictionary(IntPtr)	Um construtor usado ao criar representações gerenciadas de objetos não gerenciados; Chamado pelo runtime.
NSDictionary(String)	Cria um novo dicionário com base no conteúdo de um PropertyList localizado no arquivo especificado.
NSDictionary(NSDictionary, Boolean)
NSDictionary(NSUrl, NSError)
NSDictionary(NSObject, NSObject, NSObject[])	Cria um NSDictionary com base em uma lista de chaves NSObject e valores NSObject.
NSDictionary(Object, Object, Object[])	Cria um NSDictionary com base em uma lista de chaves e valores.

NSDictionary()

Construtor padrão que inicializa uma nova instância dessa classe sem parâmetros.

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

Atributos: ExportAttribute DesignatedInitializerAttribute

Aplica-se a

NSDictionary(NSCoder)

Um construtor que inicializa o objeto dos dados armazenados no objeto unarchiver.

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

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

Parâmetros

coder: NSCoder

O objeto unarchiver.

Atributos: ExportAttribute DesignatedInitializerAttribute

Comentários

Esse construtor é fornecido para permitir que a classe seja inicializada de um unarchiver (por exemplo, durante a desserialização nib). Isso faz parte do NSCoding protocolo.

Se os desenvolvedores quiserem criar uma subclasse desse objeto e continuar a dar suporte à desserialização de um arquivo morto, eles deverão implementar um construtor com uma assinatura idêntica: pegar um único parâmetro do tipo NSCoder e decorá-lo com a declaração de atributo [Export("initWithCoder:"].

O estado desse objeto também pode ser serializado usando o método complementar EncodeTo.

Aplica-se a

NSDictionary(NSDictionary)

Cria um novo NSDictionary de um NSDictionary existente.

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

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

Parâmetros

other: NSDictionary

O dicionário de origem.

Atributos: ExportAttribute

Aplica-se a

NSDictionary(NSObjectFlag)

Construtor para chamar em classes derivadas para ignorar a inicialização e simplesmente alocar o objeto.

protected NSDictionary (Foundation.NSObjectFlag t);

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

Parâmetros

t: NSObjectFlag

Valor sentinela não utilizado, passe NSObjectFlag.Empty.

Comentários

Esse construtor deve ser chamado por classes derivadas quando eles constroem completamente o objeto no código gerenciado e apenas querem que o runtime aloque e inicialize o NSObject. Isso é necessário para implementar o processo de inicialização em duas etapas que Objective-C usa, a primeira etapa é executar a alocação de objeto, a segunda etapa é inicializar o objeto. Quando os desenvolvedores invocam o construtor que usa o NSObjectFlag.Empty, eles aproveitam um caminho direto que vai até NSObject para simplesmente alocar a memória do objeto e associar os objetos Objective-C e C#. A inicialização real do objeto cabe ao desenvolvedor.

Esse construtor normalmente é usado pelo gerador de associação para alocar o objeto, mas impede que a inicialização real ocorra. Depois que a alocação tiver ocorrido, o construtor precisará inicializar o objeto . Com construtores gerados pelo gerador de associação, isso significa que ele invoca manualmente um dos métodos "init" para inicializar o objeto.

É responsabilidade do desenvolvedor inicializar completamente o objeto se ele se encadear usando o caminho NSObjectFlag.Empty.

Em geral, se o construtor do desenvolvedor invocar a implementação base NSObjectFlag.Empty, ele deverá chamar um método objective-C init. Se esse não for o caso, os desenvolvedores deverão encadear o construtor adequado em sua classe.

O valor do argumento é ignorado e apenas garante que o único código executado seja a fase de construção é a alocação básica de NSObject e o registro de tipo de runtime. Normalmente, o encadeamento teria esta aparência:

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

Aplica-se a

NSDictionary(NSUrl)

Cria um novo dicionário com base no conteúdo de uma PropertyList localizada em uma URL especificada.

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

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

Parâmetros

url: NSUrl

URL para o recurso que contém um NSDictionary no formato PropertyList.

Atributos: ExportAttribute

Aplica-se a

NSDictionary(IntPtr)

Um construtor usado ao criar representações gerenciadas de objetos não gerenciados; Chamado pelo runtime.

protected internal NSDictionary (IntPtr handle);

new Foundation.NSDictionary : nativeint -> Foundation.NSDictionary

Parâmetros

handle: IntPtr
nativeint

Ponteiro (identificador) para o objeto não gerenciado.

Comentários

Esse construtor é invocado pela infraestrutura de runtime (GetNSObject(IntPtr)) para criar uma nova representação gerenciada para um ponteiro para um objeto Objective-C não gerenciado. Os desenvolvedores não devem invocar esse método diretamente, em vez disso, devem chamar o método GetNSObject, pois ele impedirá que duas instâncias de um objeto gerenciado apontem para o mesmo objeto nativo.

Aplica-se a

NSDictionary(String)

Cria um novo dicionário com base no conteúdo de um PropertyList localizado no arquivo especificado.

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

new Foundation.NSDictionary : string -> Foundation.NSDictionary

Parâmetros

fileName: String

Arquivo que contém um dicionário formatado da Lista de Propriedades.

Atributos: ExportAttribute

Aplica-se a

NSDictionary(NSDictionary, Boolean)

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

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

Parâmetros

other: NSDictionary

copyItems: Boolean

Atributos: ExportAttribute

Aplica-se a

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

Parâmetros

url: NSUrl

error: NSError

Atributos: ExportAttribute IntroducedAttribute

Aplica-se a

NSDictionary(NSObject, NSObject, NSObject[])

Cria um NSDictionary com base em uma lista de chaves NSObject e valores NSObject.

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

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

Parâmetros

first: NSObject

Primeira chave.

second: NSObject

Primeiro valor.

args: NSObject[]

Pais restantes de chaves e valores.

Comentários

A lista de chaves e valores é usada para criar o dicionário. O número de parâmetros passados para essa função deve ser par.

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

Aplica-se a

NSDictionary(Object, Object, Object[])

Cria um NSDictionary com base em uma lista de chaves e valores.

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

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

Parâmetros

first: Object

Primeira chave.

second: Object

Primeiro valor.

args: Object[]

Pais restantes de chaves e valores.

Comentários

Cada objeto C# é colocado em caixa como um NSObject chamando FromObject(Object).

A lista de chaves e valores é usada para criar o dicionário. O número de parâmetros passados para essa função deve ser par.

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

Aplica-se a

Compartilhar via

NSDictionary Construtores

Definição

Sobrecargas

NSDictionary()

Aplica-se a

NSDictionary(NSCoder)

Parâmetros

Comentários

Aplica-se a

NSDictionary(NSDictionary)

Parâmetros

Aplica-se a

NSDictionary(NSObjectFlag)

Parâmetros

Comentários

Aplica-se a

NSDictionary(NSUrl)

Parâmetros

Aplica-se a

NSDictionary(IntPtr)

Parâmetros

Comentários

Aplica-se a

NSDictionary(String)

Parâmetros

Aplica-se a

NSDictionary(NSDictionary, Boolean)

Parâmetros

Aplica-se a

NSDictionary(NSUrl, NSError)

Parâmetros

Aplica-se a

NSDictionary(NSObject, NSObject, NSObject[])

Parâmetros

Comentários

Aplica-se a

NSDictionary(Object, Object, Object[])

Parâmetros

Comentários

Aplica-se a

Recursos adicionais