NSDictionary Classe

Definição

Namespace:

Foundation

Assembly:

Xamarin.iOS.dll

Dicionário que fornece mapeamento de chaves para valores.

[Foundation.Register("NSDictionary", true)]
public class NSDictionary : Foundation.NSObject, CoreData.INSFetchRequestResult, Foundation.INSMutableCopying, Foundation.INSSecureCoding, IDisposable, System.Collections.Generic.ICollection<System.Collections.Generic.KeyValuePair<Foundation.NSObject,Foundation.NSObject>>, System.Collections.Generic.IDictionary<Foundation.NSObject,Foundation.NSObject>, System.Collections.Generic.IEnumerable<System.Collections.Generic.KeyValuePair<Foundation.NSObject,Foundation.NSObject>>, System.Collections.IDictionary

type NSDictionary = class
    inherit NSObject
    interface INSCoding
    interface INativeObject
    interface IDisposable
    interface INSCopying
    interface INSMutableCopying
    interface INSSecureCoding
    interface INSFetchRequestResult
    interface IDictionary
    interface ICollection
    interface IEnumerable
    interface IDictionary<NSObject, NSObject>
    interface ICollection<KeyValuePair<NSObject, NSObject>>
    interface seq<KeyValuePair<NSObject, NSObject>>

Herança

Object

NSObject

NSDictionary

Derivado

Foundation.NSDictionary<TKey,TValue>

Foundation.NSMutableDictionary

Atributos

RegisterAttribute

Implementações

INSFetchRequestResult INSCoding INSCopying INSMutableCopying INSSecureCoding INativeObject ICollection<KeyValuePair<NSObject,NSObject>> ICollection<KeyValuePair<TKey,TValue>> IDictionary<NSObject,NSObject> IEnumerable<KeyValuePair<NSObject,NSObject>> IEnumerable<KeyValuePair<TKey,TValue>> IEnumerable<T> ICollection IDictionary IEnumerable IDisposable

Comentários

Esse é um dicionário imutável, para criar os mutáveis, use o NSMutableDictionary tipo .

Há um construtor conveniente que usa pelo menos uma chave e um valor, com valores opcionais que criarão o dicionário emparelhando cada chave com um valor. Se você usar objetos .NET, as chaves e os valores serão primeiro colocados em caixa em NSObjects usando FromObject(Object).

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

//
// Using NSObjects directly, gives you fine control
//
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);

Às vezes, talvez você já tenha uma matriz de chaves e valores para poder usar os seguintes métodos de fábrica:

var keys = new object [] { "key1", "key2" };
var values = new object [] { "value1", "value2" }:

var dict = NSDictionary.FromObjectsAndKeys (values, keys);

O tipo NSDictionary implementa as interfaces ICollection, IDictionary e ICollection e IDictionary genéricas, o que torna conveniente usar com APIs .NET existentes e também fornece indexadores que usam um NSObject, um NSString ou uma cadeia de caracteres C#, bem como um enumerador.

Em alguns casos, em que você pode estar iterando em um loop ou não tiver exibido um tipo associado, mas tiver o identificador para a chave, você pode usar o LowlevelObjectForKey(IntPtr) que usa um identificador para a chave e retorna um identificador para o objeto retornado.

Construtores

NSDictionary()	Construtor padrão que inicializa uma nova instância dessa classe sem parâmetros.
NSDictionary(IntPtr)	Um construtor usado ao criar representações gerenciadas de objetos não gerenciados; Chamado pelo runtime.
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(NSDictionary, Boolean)	Dicionário que fornece mapeamento de chaves para valores.
NSDictionary(NSObject, NSObject, NSObject[])	Cria um NSDictionary a partir de uma lista de chaves NSObject e valores NSObject.
NSDictionary(NSObjectFlag)	Construtor para chamar classes derivadas para ignorar a inicialização e apenas alocar o objeto.
NSDictionary(NSUrl)	Cria um novo dicionário do conteúdo de uma PropertyList localizada em uma URL especificada.
NSDictionary(NSUrl, NSError)	Dicionário que fornece mapeamento de chaves para valores.
NSDictionary(Object, Object, Object[])	Cria um NSDictionary de uma lista de chaves e valores.
NSDictionary(String)	Cria um novo dicionário do conteúdo de um PropertyList localizado no arquivo especificado.

Propriedades

Class	Dicionário que fornece mapeamento de chaves para valores. (Herdado de NSObject)
ClassHandle	O identificador dessa classe.
Count	Retorna o número de chaves no dicionário.
DebugDescription	Uma descrição significativa do desenvolvedor desse objeto. (Herdado de NSObject)
Description	Descrição do objeto, a versão Objective-C do ToString. (Herdado de NSObject)
DescriptionInStringsFileFormat	O conteúdo do dicionário, formatado no formato de arquivo .strings.
Handle	Manipule (ponteiro) para a representação de objeto não gerenciado. (Herdado de NSObject)
IsDirectBinding	Dicionário que fornece mapeamento de chaves para valores. (Herdado de NSObject)
IsProxy	Dicionário que fornece mapeamento de chaves para valores. (Herdado de NSObject)
Item[NSObject]	Retorna o valor associado de uma chave no dicionário ou nulo se a chave não for encontrada.
Item[NSString]	Retorna o valor associado de uma chave no dicionário ou nulo se a chave não for encontrada.
Item[String]	Retorna o valor associado de uma chave no dicionário ou nulo se a chave não for encontrada.
Keys	O conjunto de chaves para o NSDictionary.
ObjectEnumerator	Um NSEnumerator dos valores no NSDictionary.
RetainCount	Retorna a contagem de retenção Objective-C atual para o objeto . (Herdado de NSObject)
Self	Dicionário que fornece mapeamento de chaves para valores. (Herdado de NSObject)
Superclass	Dicionário que fornece mapeamento de chaves para valores. (Herdado de NSObject)
SuperHandle	Identificador usado para representar os métodos na classe base para este NSObject. (Herdado de NSObject)
Values	A matriz de valores no NSDictionary.
Zone	Dicionário que fornece mapeamento de chaves para valores. (Herdado de NSObject)

Métodos

AddObserver(NSObject, NSString, NSKeyValueObservingOptions, IntPtr)	Registra um objeto para ser observado externamente (usando NSString keyPath).   As alterações observadas são enviadas para o método de objeto ObserveValue(NSString, NSObject, NSDictionary, IntPtr) do observador. (Herdado de NSObject)
AddObserver(NSObject, String, NSKeyValueObservingOptions, IntPtr)	Registra um objeto para ser observado externamente (usando keyPath de cadeia de caracteres).   As alterações observadas são enviadas para o método de objeto ObserveValue(NSString, NSObject, NSDictionary, IntPtr) do observador. (Herdado de NSObject)
AddObserver(NSString, NSKeyValueObservingOptions, Action<NSObservedChange>)	Registra um objeto para ser observado externamente usando um método arbitrário. (Herdado de NSObject)
AddObserver(String, NSKeyValueObservingOptions, Action<NSObservedChange>)	Registra um objeto para ser observado externamente usando um método arbitrário. (Herdado de NSObject)
AwakeFromNib()	Chamado depois que o objeto tiver sido carregado do arquivo nib. Os substituidores devem chamar base. AwakeFromNib(). (Herdado de NSObject)
BeginInvokeOnMainThread(Action)	Dicionário que fornece mapeamento de chaves para valores. (Herdado de NSObject)
BeginInvokeOnMainThread(Selector, NSObject)	Invoca de forma assíncrona o código especificado no thread principal da interface do usuário. (Herdado de NSObject)
Bind(NSString, NSObject, String, NSDictionary)	Dicionário que fornece mapeamento de chaves para valores. (Herdado de NSObject)
Bind(String, NSObject, String, NSDictionary)	Dicionário que fornece mapeamento de chaves para valores. (Herdado de NSObject)
BindingInfo(String)	Dicionário que fornece mapeamento de chaves para valores. (Herdado de NSObject)
BindingOptionDescriptions(String)	Dicionário que fornece mapeamento de chaves para valores. (Herdado de NSObject)
BindingValueClass(String)	Dicionário que fornece mapeamento de chaves para valores. (Herdado de NSObject)
CommitEditing()	Dicionário que fornece mapeamento de chaves para valores. (Herdado de NSObject)
CommitEditing(NSObject, Selector, IntPtr)	Dicionário que fornece mapeamento de chaves para valores. (Herdado de NSObject)
ConformsToProtocol(IntPtr)	Invocado para determinar se esse objeto implementa o protocolo especificado. (Herdado de NSObject)
ContainsKey(NSObject)	Determina se a chave especificada existe no dicionário.
Copy()	Executa uma cópia do objeto Objective-C subjacente. (Herdado de NSObject)
Copy(NSZone)	Executa uma cópia do objeto Objective-C subjacente.
DangerousAutorelease()	Dicionário que fornece mapeamento de chaves para valores. (Herdado de NSObject)
DangerousRelease()	Dicionário que fornece mapeamento de chaves para valores. (Herdado de NSObject)
DangerousRetain()	Dicionário que fornece mapeamento de chaves para valores. (Herdado de NSObject)
DidChange(NSKeyValueChange, NSIndexSet, NSString)	Indica que ocorreu uma alteração nos índices de uma relação para muitos. (Herdado de NSObject)
DidChange(NSString, NSKeyValueSetMutationKind, NSSet)	Dicionário que fornece mapeamento de chaves para valores. (Herdado de NSObject)
DidChangeValue(String)	Indica que ocorreu uma alteração na chave especificada. (Herdado de NSObject)
Dispose()	Libera os recursos usados pelo objeto NSObject. (Herdado de NSObject)
Dispose(Boolean)	Libera os recursos usados pelo objeto NSObject. (Herdado de NSObject)
DoesNotRecognizeSelector(Selector)	Indica que esse objeto não reconhece o seletor especificado. (Herdado de NSObject)
EncodeTo(NSCoder)	Codifica o estado do objeto no codificador fornecido
Equals(NSObject)	Dicionário que fornece mapeamento de chaves para valores. (Herdado de NSObject)
Equals(Object)	Dicionário que fornece mapeamento de chaves para valores. (Herdado de NSObject)
ExposedBindings()	Dicionário que fornece mapeamento de chaves para valores. (Herdado de NSObject)
FromDictionary(NSDictionary)	Método factory para criar um NSDictionary que é uma cópia do NSDictionary de origem especificado.
FromFile(String)	Cria um novo dicionário do conteúdo de um PropertyList localizado no arquivo especificado.
FromObjectAndKey(NSObject, NSObject)	Método factory para criar um novo NSDictionary inicializado com o obj (valor) e a chave especificados.
FromObjectsAndKeys(NSObject[], NSObject[])	Cria um dicionário de um conjunto de valores e chaves.
FromObjectsAndKeys(NSObject[], NSObject[], nint)	Cria um dicionário de um conjunto de valores e chaves.
FromObjectsAndKeys(Object[], Object[])	Cria um dicionário de um conjunto de valores e chaves.
FromObjectsAndKeys(Object[], Object[], nint)	Cria um dicionário de um conjunto de valores e chaves.
FromUrl(NSUrl)	Cria um novo dicionário do conteúdo de uma PropertyList localizada em uma URL especificada.
FromUrl(NSUrl, NSError)	Dicionário que fornece mapeamento de chaves para valores.
GetBindingInfo(NSString)	Dicionário que fornece mapeamento de chaves para valores. (Herdado de NSObject)
GetBindingOptionDescriptions(NSString)	Dicionário que fornece mapeamento de chaves para valores. (Herdado de NSObject)
GetBindingValueClass(NSString)	Dicionário que fornece mapeamento de chaves para valores. (Herdado de NSObject)
GetDictionaryOfValuesFromKeys(NSString[])	Recupera os valores das chaves especificadas. (Herdado de NSObject)
GetEnumerator()	Dicionário que fornece mapeamento de chaves para valores.
GetHashCode()	Gera um código hash para a instância atual. (Herdado de NSObject)
GetMethodForSelector(Selector)	Dicionário que fornece mapeamento de chaves para valores. (Herdado de NSObject)
GetNativeField(String)	Obsoleto. Dicionário que fornece mapeamento de chaves para valores. (Herdado de NSObject)
GetNativeHash()	Dicionário que fornece mapeamento de chaves para valores. (Herdado de NSObject)
GetSharedKeySetForKeys(NSObject[])	Cria um conjunto de chaves compartilhadas para as chaves especificadas.
Init()	Dicionário que fornece mapeamento de chaves para valores. (Herdado de NSObject)
InitializeHandle(IntPtr)	Dicionário que fornece mapeamento de chaves para valores. (Herdado de NSObject)
InitializeHandle(IntPtr, String)	Dicionário que fornece mapeamento de chaves para valores. (Herdado de NSObject)
Invoke(Action, Double)	Dicionário que fornece mapeamento de chaves para valores. (Herdado de NSObject)
Invoke(Action, TimeSpan)	Dicionário que fornece mapeamento de chaves para valores. (Herdado de NSObject)
InvokeOnMainThread(Action)	Dicionário que fornece mapeamento de chaves para valores. (Herdado de NSObject)
InvokeOnMainThread(Selector, NSObject)	Invoca de forma síncrona o código especificado no thread principal da interface do usuário. (Herdado de NSObject)
IsEqual(NSObject)	Dicionário que fornece mapeamento de chaves para valores. (Herdado de NSObject)
IsEqualToDictionary(NSDictionary)	True se os dicionários tiverem o mesmo número de entradas e, para todas as chaves, os valores retornarem true para Equals.
IsKindOfClass(Class)	Dicionário que fornece mapeamento de chaves para valores. (Herdado de NSObject)
IsMemberOfClass(Class)	Dicionário que fornece mapeamento de chaves para valores. (Herdado de NSObject)
KeysForObject(NSObject)	Uma matriz, possivelmente vazia, das chaves cujo valor é igual ao obj especificado.
LowlevelObjectForKey(IntPtr)	Pesquisa de chave de baixo nível.
MarkDirty()	Promove um objeto par regular (IsDirectBinding é true) em um objeto toggleref. (Herdado de NSObject)
MutableCopy()	Cria uma cópia mutável do NSObject especificado. (Herdado de NSObject)
MutableCopy(NSZone)	Executa uma cópia do objeto Objective-C subjacente.
ObjectDidEndEditing(NSObject)	Dicionário que fornece mapeamento de chaves para valores. (Herdado de NSObject)
ObjectForKey(NSObject)	O objeto mapeado para a chave especificada ou nulo.
ObjectsForKeys(NSArray, NSObject)	Uma matriz de objetos para as chaves especificadas. Se a chave não for encontrada, o objeto de marcador será colocado na matriz retornada no índice apropriado.
ObserveValue(NSString, NSObject, NSDictionary, IntPtr)	Indica que o valor no keyPath especificado em relação a esse objeto foi alterado. (Herdado de NSObject)
PerformSelector(Selector)	Dicionário que fornece mapeamento de chaves para valores. (Herdado de NSObject)
PerformSelector(Selector, NSObject)	Dicionário que fornece mapeamento de chaves para valores. (Herdado de NSObject)
PerformSelector(Selector, NSObject, Double)	Invoca o seletor na instância atual e, se o obj não for nulo, ele passará isso como seu único parâmetro. (Herdado de NSObject)
PerformSelector(Selector, NSObject, Double, NSString[])	Dicionário que fornece mapeamento de chaves para valores. (Herdado de NSObject)
PerformSelector(Selector, NSObject, NSObject)	Dicionário que fornece mapeamento de chaves para valores. (Herdado de NSObject)
PerformSelector(Selector, NSThread, NSObject, Boolean)	Dicionário que fornece mapeamento de chaves para valores. (Herdado de NSObject)
PerformSelector(Selector, NSThread, NSObject, Boolean, NSString[])	Dicionário que fornece mapeamento de chaves para valores. (Herdado de NSObject)
PrepareForInterfaceBuilder()	Dicionário que fornece mapeamento de chaves para valores. (Herdado de NSObject)
RemoveObserver(NSObject, NSString)	Impede que o observador especificado receba mais notificações de valores alterados para o keyPath especificado. (Herdado de NSObject)
RemoveObserver(NSObject, NSString, IntPtr)	Impede que o observador especificado receba notificações adicionais de valores alterados para o keyPath e o contexto especificados. (Herdado de NSObject)
RemoveObserver(NSObject, String)	Impede que o observador especificado receba mais notificações de valores alterados para o keyPath especificado. (Herdado de NSObject)
RemoveObserver(NSObject, String, IntPtr)	Impede que o observador especificado receba notificações adicionais de valores alterados para o keyPath e o contexto especificados. (Herdado de NSObject)
RespondsToSelector(Selector)	Se esse objeto reconhece o seletor especificado. (Herdado de NSObject)
SetNativeField(String, NSObject)	Obsoleto. Dicionário que fornece mapeamento de chaves para valores. (Herdado de NSObject)
SetNilValueForKey(NSString)	Define o valor da chave especificada como nulo. (Herdado de NSObject)
SetValueForKey(NSObject, NSString)	Define o valor da propriedade especificada pela chave como o valor especificado. (Herdado de NSObject)
SetValueForKeyPath(IntPtr, NSString)	Um construtor usado ao criar representações gerenciadas de objetos não gerenciados; Chamado pelo runtime. (Herdado de NSObject)
SetValueForKeyPath(NSObject, NSString)	Define o valor de uma propriedade que pode ser alcançada usando um keypath. (Herdado de NSObject)
SetValueForUndefinedKey(NSObject, NSString)	Indica uma tentativa de gravar um valor em uma chave indefinida. Se não for substituído, gerará um NSUndefinedKeyException. (Herdado de NSObject)
SetValuesForKeysWithDictionary(NSDictionary)	Define os valores desse NSObject para aqueles no dicionário especificado. (Herdado de NSObject)
ToFileAttributes()	Dicionário que fornece mapeamento de chaves para valores.
ToString()	Retorna uma representação de cadeia de caracteres do valor da instância atual. (Herdado de NSObject)
TryGetValue(NSObject, NSObject)	Dicionário que fornece mapeamento de chaves para valores.
Unbind(NSString)	Dicionário que fornece mapeamento de chaves para valores. (Herdado de NSObject)
Unbind(String)	Dicionário que fornece mapeamento de chaves para valores. (Herdado de NSObject)
ValueForKey(NSString)	Retorna o valor da propriedade associada à chave especificada. (Herdado de NSObject)
ValueForKeyPath(NSString)	Retorna o valor de uma propriedade que pode ser alcançada usando um keypath. (Herdado de NSObject)
ValueForUndefinedKey(NSString)	Indica uma tentativa de ler um valor de uma chave indefinida. Se não for substituído, gerará um NSUndefinedKeyException. (Herdado de NSObject)
WillChange(NSKeyValueChange, NSIndexSet, NSString)	Indica que os valores dos índices especificados na chave especificada estão prestes a ser alterados. (Herdado de NSObject)
WillChange(NSString, NSKeyValueSetMutationKind, NSSet)	Dicionário que fornece mapeamento de chaves para valores. (Herdado de NSObject)
WillChangeValue(String)	Indica que o valor da chave especificada está prestes a ser alterado. (Herdado de NSObject)
WriteToFile(String, Boolean)	Tenta gravar o NSDictionary no caminho especificado. Se useAuxiliaryFile for true, o arquivo será gravado atomicamente. Retorna êxito ou falha.
WriteToUrl(NSUrl, Boolean)	Attemps para gravar o NSDictionary na URL especificada e se deve fazê-lo atomicamente. Retorna êxito ou falha.

Implantações explícitas de interface

ICollection.CopyTo(Array, Int32)	Dicionário que fornece mapeamento de chaves para valores.
ICollection.Count	Dicionário que fornece mapeamento de chaves para valores.
ICollection.IsSynchronized	Dicionário que fornece mapeamento de chaves para valores.
ICollection.SyncRoot	Dicionário que fornece mapeamento de chaves para valores.
ICollection<KeyValuePair<NSObject,NSObject>>.Add(KeyValuePair<NSObject,NSObject>)	Dicionário que fornece mapeamento de chaves para valores.
ICollection<KeyValuePair<NSObject,NSObject>>.Clear()	Dicionário que fornece mapeamento de chaves para valores.
ICollection<KeyValuePair<NSObject,NSObject>>.Contains(KeyValuePair<NSObject,NSObject>)	Dicionário que fornece mapeamento de chaves para valores.
ICollection<KeyValuePair<NSObject,NSObject>>.CopyTo(KeyValuePair<NSObject,NSObject>[], Int32)	Cria uma cópia desse objeto, alocando memória da zona especificada ou da zona padrão se o argumento for nulo.
ICollection<KeyValuePair<NSObject,NSObject>>.Count	Dicionário que fornece mapeamento de chaves para valores.
ICollection<KeyValuePair<NSObject,NSObject>>.IsReadOnly	Dicionário que fornece mapeamento de chaves para valores.
ICollection<KeyValuePair<NSObject,NSObject>>.Remove(KeyValuePair<NSObject,NSObject>)	Dicionário que fornece mapeamento de chaves para valores.
IDictionary.Add(Object, Object)	Dicionário que fornece mapeamento de chaves para valores.
IDictionary.Clear()	Dicionário que fornece mapeamento de chaves para valores.
IDictionary.Contains(Object)	Dicionário que fornece mapeamento de chaves para valores.
IDictionary.GetEnumerator()	Dicionário que fornece mapeamento de chaves para valores.
IDictionary.IsFixedSize	Dicionário que fornece mapeamento de chaves para valores.
IDictionary.IsReadOnly	Dicionário que fornece mapeamento de chaves para valores.
IDictionary.Item[Object]	Dicionário que fornece mapeamento de chaves para valores.
IDictionary.Keys	Dicionário que fornece mapeamento de chaves para valores.
IDictionary.Remove(Object)	Dicionário que fornece mapeamento de chaves para valores.
IDictionary.Values	Dicionário que fornece mapeamento de chaves para valores.
IDictionary<NSObject,NSObject>.Add(NSObject, NSObject)	Dicionário que fornece mapeamento de chaves para valores.
IDictionary<NSObject,NSObject>.Keys	Dicionário que fornece mapeamento de chaves para valores.
IDictionary<NSObject,NSObject>.Remove(NSObject)	Dicionário que fornece mapeamento de chaves para valores.
IDictionary<NSObject,NSObject>.Values	Dicionário que fornece mapeamento de chaves para valores.
IEnumerable.GetEnumerator()	Dicionário que fornece mapeamento de chaves para valores.

Métodos de Extensão

GetDebugDescription(INSObjectProtocol)	Dicionário que fornece mapeamento de chaves para valores.
GetAccessibilityCustomRotors(NSObject)	Obtém a matriz de UIAccessibilityCustomRotor objetos apropriados para this o objeto .
SetAccessibilityCustomRotors(NSObject, UIAccessibilityCustomRotor[])	Define a matriz de UIAccessibilityCustomRotor objetos apropriados para this o objeto .

Confira também

• Documentação da Apple para NSDictionary