NSDictionary Clase

Definición

Espacio de nombres:

Foundation

Ensamblado:

Xamarin.iOS.dll

Diccionario que proporciona la asignación de claves a 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>>

Herencia

Object

NSObject

NSDictionary

Derivado

Foundation.NSDictionary<TKey,TValue>

Foundation.NSMutableDictionary

Atributos

RegisterAttribute

Implementaciones

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

Comentarios

Se trata de un diccionario inmutable, para crear mutables, use el NSMutableDictionary tipo .

Hay un constructor práctico que toma al menos una clave y un valor, con valores opcionales que crearán el diccionario emparejando cada clave con un valor. Si usa objetos .NET, primero las claves y los valores se incluirán en NSObjects mediante 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);

A veces, es posible que ya tenga una matriz de claves y valores, por lo que puede usar los siguientes métodos de fábrica:

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

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

El tipo NSDictionary implementa las interfaces ICollection, IDictionary y ICollection y IDictionary genéricas, lo que facilita el uso con las API de .NET existentes y también proporciona indizadores que toman un NSObject, una cadena NSString o una cadena de C#, así como un enumerador.

En algunos casos, donde podría iterar en un bucle o no ha expuesto un tipo enlazado, pero tiene el identificador para la clave, puede usar el LowlevelObjectForKey(IntPtr) que toma un identificador para la clave y devuelve un identificador para el objeto devuelto.

Constructores

NSDictionary()	Constructor predeterminado que inicializa una nueva instancia de esta clase sin parámetros.
NSDictionary(IntPtr)	Constructor utilizado al crear representaciones administradas de objetos no administrados; Lo llama el tiempo de ejecución.
NSDictionary(NSCoder)	Constructor que inicializa el objeto a partir de los datos almacenados en el objeto unarchiver.
NSDictionary(NSDictionary)	Crea un nuevo NSDictionary a partir de un NSDictionary existente.
NSDictionary(NSDictionary, Boolean)	Diccionario que proporciona la asignación de claves a valores.
NSDictionary(NSObject, NSObject, NSObject[])	Crea un NSDictionary a partir de una lista de claves NSObject y valores NSObject.
NSDictionary(NSObjectFlag)	Constructor para llamar a en clases derivadas para omitir la inicialización y simplemente asignar el objeto.
NSDictionary(NSUrl)	Crea un nuevo diccionario a partir del contenido de un PropertyList ubicado en una dirección URL especificada.
NSDictionary(NSUrl, NSError)	Diccionario que proporciona la asignación de claves a valores.
NSDictionary(Object, Object, Object[])	Crea un NSDictionary a partir de una lista de claves y valores.
NSDictionary(String)	Crea un nuevo diccionario a partir del contenido de un PropertyList ubicado en el archivo especificado.

Propiedades

Class	Diccionario que proporciona la asignación de claves a valores. (Heredado de NSObject)
ClassHandle	Identificador de esta clase.
Count	Devuelve el número de claves del diccionario.
DebugDescription	Descripción significativa para el desarrollador de este objeto. (Heredado de NSObject)
Description	Descripción del objeto, la versión objective-C de ToString. (Heredado de NSObject)
DescriptionInStringsFileFormat	El contenido del diccionario, con formato en formato de archivo .strings.
Handle	Identificador (puntero) a la representación del objeto no administrado. (Heredado de NSObject)
IsDirectBinding	Diccionario que proporciona la asignación de claves a valores. (Heredado de NSObject)
IsProxy	Diccionario que proporciona la asignación de claves a valores. (Heredado de NSObject)
Item[NSObject]	Devuelve el valor asociado a una clave del diccionario o null si no se encuentra la clave.
Item[NSString]	Devuelve el valor asociado a una clave del diccionario o null si no se encuentra la clave.
Item[String]	Devuelve el valor asociado a una clave del diccionario o null si no se encuentra la clave.
Keys	Conjunto de claves para NSDictionary.
ObjectEnumerator	NSEnumerator de los valores de NSDictionary.
RetainCount	Devuelve el recuento de retención actual de Objective-C para el objeto . (Heredado de NSObject)
Self	Diccionario que proporciona la asignación de claves a valores. (Heredado de NSObject)
Superclass	Diccionario que proporciona la asignación de claves a valores. (Heredado de NSObject)
SuperHandle	Identificador usado para representar los métodos de la clase base para este NSObject. (Heredado de NSObject)
Values	Matriz de valores en NSDictionary.
Zone	Diccionario que proporciona la asignación de claves a valores. (Heredado de NSObject)

Métodos

AddObserver(NSObject, NSString, NSKeyValueObservingOptions, IntPtr)	Registra un objeto para que se observe externamente (mediante NSString keyPath).   Los cambios observados se envían al método de objeto ObserveValue(NSString, NSObject, NSDictionary, IntPtr) del observador. (Heredado de NSObject)
AddObserver(NSObject, String, NSKeyValueObservingOptions, IntPtr)	Registra un objeto para que se observe externamente (mediante keyPath de cadena).   Los cambios observados se envían al método de objeto ObserveValue(NSString, NSObject, NSDictionary, IntPtr) del observador. (Heredado de NSObject)
AddObserver(NSString, NSKeyValueObservingOptions, Action<NSObservedChange>)	Registra un objeto para que se observe externamente mediante un método arbitrario. (Heredado de NSObject)
AddObserver(String, NSKeyValueObservingOptions, Action<NSObservedChange>)	Registra un objeto para que se observe externamente mediante un método arbitrario. (Heredado de NSObject)
AwakeFromNib()	Se llama después de cargar el objeto desde el archivo nib. Los invalidadores deben llamar a base. AwakeFromNib(). (Heredado de NSObject)
BeginInvokeOnMainThread(Action)	Diccionario que proporciona la asignación de claves a valores. (Heredado de NSObject)
BeginInvokeOnMainThread(Selector, NSObject)	Invoca de forma asincrónica el código especificado en el subproceso principal de la interfaz de usuario. (Heredado de NSObject)
Bind(NSString, NSObject, String, NSDictionary)	Diccionario que proporciona la asignación de claves a valores. (Heredado de NSObject)
Bind(String, NSObject, String, NSDictionary)	Diccionario que proporciona la asignación de claves a valores. (Heredado de NSObject)
BindingInfo(String)	Diccionario que proporciona la asignación de claves a valores. (Heredado de NSObject)
BindingOptionDescriptions(String)	Diccionario que proporciona la asignación de claves a valores. (Heredado de NSObject)
BindingValueClass(String)	Diccionario que proporciona la asignación de claves a valores. (Heredado de NSObject)
CommitEditing()	Diccionario que proporciona la asignación de claves a valores. (Heredado de NSObject)
CommitEditing(NSObject, Selector, IntPtr)	Diccionario que proporciona la asignación de claves a valores. (Heredado de NSObject)
ConformsToProtocol(IntPtr)	Se invoca para determinar si este objeto implementa el protocolo especificado. (Heredado de NSObject)
ContainsKey(NSObject)	Determina si la clave especificada existe en el diccionario.
Copy()	Realiza una copia del objeto Objective-C subyacente. (Heredado de NSObject)
Copy(NSZone)	Realiza una copia del objeto Objective-C subyacente.
DangerousAutorelease()	Diccionario que proporciona la asignación de claves a valores. (Heredado de NSObject)
DangerousRelease()	Diccionario que proporciona la asignación de claves a valores. (Heredado de NSObject)
DangerousRetain()	Diccionario que proporciona la asignación de claves a valores. (Heredado de NSObject)
DidChange(NSKeyValueChange, NSIndexSet, NSString)	Indica que se ha producido un cambio en los índices de una relación a varios. (Heredado de NSObject)
DidChange(NSString, NSKeyValueSetMutationKind, NSSet)	Diccionario que proporciona la asignación de claves a valores. (Heredado de NSObject)
DidChangeValue(String)	Indica que se ha producido un cambio en la clave especificada. (Heredado de NSObject)
Dispose()	Libera los recursos utilizados por el objeto NSObject. (Heredado de NSObject)
Dispose(Boolean)	Libera los recursos utilizados por el objeto NSObject. (Heredado de NSObject)
DoesNotRecognizeSelector(Selector)	Indica que este objeto no reconoce el selector especificado. (Heredado de NSObject)
EncodeTo(NSCoder)	Codifica el estado del objeto en el codificador proporcionado.
Equals(NSObject)	Diccionario que proporciona la asignación de claves a valores. (Heredado de NSObject)
Equals(Object)	Diccionario que proporciona la asignación de claves a valores. (Heredado de NSObject)
ExposedBindings()	Diccionario que proporciona la asignación de claves a valores. (Heredado de NSObject)
FromDictionary(NSDictionary)	Método factory para crear un nuevo NSDictionary que sea una copia del NSDictionary de origen especificado.
FromFile(String)	Crea un nuevo diccionario a partir del contenido de un PropertyList ubicado en el archivo especificado.
FromObjectAndKey(NSObject, NSObject)	Método factory para crear un nuevo NSDictionary inicializado con el obj (valor) y la clave especificados.
FromObjectsAndKeys(NSObject[], NSObject[])	Crea un diccionario a partir de un conjunto de valores y claves.
FromObjectsAndKeys(NSObject[], NSObject[], nint)	Crea un diccionario a partir de un conjunto de valores y claves.
FromObjectsAndKeys(Object[], Object[])	Crea un diccionario a partir de un conjunto de valores y claves.
FromObjectsAndKeys(Object[], Object[], nint)	Crea un diccionario a partir de un conjunto de valores y claves.
FromUrl(NSUrl)	Crea un nuevo diccionario a partir del contenido de un PropertyList ubicado en una dirección URL especificada.
FromUrl(NSUrl, NSError)	Diccionario que proporciona la asignación de claves a valores.
GetBindingInfo(NSString)	Diccionario que proporciona la asignación de claves a valores. (Heredado de NSObject)
GetBindingOptionDescriptions(NSString)	Diccionario que proporciona la asignación de claves a valores. (Heredado de NSObject)
GetBindingValueClass(NSString)	Diccionario que proporciona la asignación de claves a valores. (Heredado de NSObject)
GetDictionaryOfValuesFromKeys(NSString[])	Recupera los valores de las claves especificadas. (Heredado de NSObject)
GetEnumerator()	Diccionario que proporciona la asignación de claves a valores.
GetHashCode()	Genera un código hash para la instancia actual. (Heredado de NSObject)
GetMethodForSelector(Selector)	Diccionario que proporciona la asignación de claves a valores. (Heredado de NSObject)
GetNativeField(String)	Obsoletos. Diccionario que proporciona la asignación de claves a valores. (Heredado de NSObject)
GetNativeHash()	Diccionario que proporciona la asignación de claves a valores. (Heredado de NSObject)
GetSharedKeySetForKeys(NSObject[])	Crea un conjunto de claves compartidas para las claves especificadas.
Init()	Diccionario que proporciona la asignación de claves a valores. (Heredado de NSObject)
InitializeHandle(IntPtr)	Diccionario que proporciona la asignación de claves a valores. (Heredado de NSObject)
InitializeHandle(IntPtr, String)	Diccionario que proporciona la asignación de claves a valores. (Heredado de NSObject)
Invoke(Action, Double)	Diccionario que proporciona la asignación de claves a valores. (Heredado de NSObject)
Invoke(Action, TimeSpan)	Diccionario que proporciona la asignación de claves a valores. (Heredado de NSObject)
InvokeOnMainThread(Action)	Diccionario que proporciona la asignación de claves a valores. (Heredado de NSObject)
InvokeOnMainThread(Selector, NSObject)	Invoca sincrónicamente el código especificado en el subproceso principal de la interfaz de usuario. (Heredado de NSObject)
IsEqual(NSObject)	Diccionario que proporciona la asignación de claves a valores. (Heredado de NSObject)
IsEqualToDictionary(NSDictionary)	True si los diccionarios tienen el mismo número de entradas y, para todas las claves, los valores devuelven true para Equals.
IsKindOfClass(Class)	Diccionario que proporciona la asignación de claves a valores. (Heredado de NSObject)
IsMemberOfClass(Class)	Diccionario que proporciona la asignación de claves a valores. (Heredado de NSObject)
KeysForObject(NSObject)	Matriz, posiblemente vacía, de las claves cuyo valor es igual al obj especificado.
LowlevelObjectForKey(IntPtr)	Búsqueda de claves de bajo nivel.
MarkDirty()	Promueve un objeto del mismo nivel normal (IsDirectBinding es true) en un objeto toggleref. (Heredado de NSObject)
MutableCopy()	Crea una copia mutable del NSObject especificado. (Heredado de NSObject)
MutableCopy(NSZone)	Realiza una copia del objeto Objective-C subyacente.
ObjectDidEndEditing(NSObject)	Diccionario que proporciona la asignación de claves a valores. (Heredado de NSObject)
ObjectForKey(NSObject)	Objeto asignado a la clave especificada o null.
ObjectsForKeys(NSArray, NSObject)	Matriz de objetos para las claves especificadas. Si no se encuentra la clave, el objeto de marcador se coloca en la matriz devuelta en el índice adecuado.
ObserveValue(NSString, NSObject, NSDictionary, IntPtr)	Indica que el valor de keyPath especificado en relación con este objeto ha cambiado. (Heredado de NSObject)
PerformSelector(Selector)	Diccionario que proporciona la asignación de claves a valores. (Heredado de NSObject)
PerformSelector(Selector, NSObject)	Diccionario que proporciona la asignación de claves a valores. (Heredado de NSObject)
PerformSelector(Selector, NSObject, Double)	Invoca el selector en la instancia actual y, si no obj es NULL, pasa esto como su único parámetro. (Heredado de NSObject)
PerformSelector(Selector, NSObject, Double, NSString[])	Diccionario que proporciona la asignación de claves a valores. (Heredado de NSObject)
PerformSelector(Selector, NSObject, NSObject)	Diccionario que proporciona la asignación de claves a valores. (Heredado de NSObject)
PerformSelector(Selector, NSThread, NSObject, Boolean)	Diccionario que proporciona la asignación de claves a valores. (Heredado de NSObject)
PerformSelector(Selector, NSThread, NSObject, Boolean, NSString[])	Diccionario que proporciona la asignación de claves a valores. (Heredado de NSObject)
PrepareForInterfaceBuilder()	Diccionario que proporciona la asignación de claves a valores. (Heredado de NSObject)
RemoveObserver(NSObject, NSString)	Impide que el observador especificado reciba más notificaciones de los valores modificados para keyPath especificado. (Heredado de NSObject)
RemoveObserver(NSObject, NSString, IntPtr)	Impide que el observador especificado reciba más notificaciones de valores modificados para el keyPath y el contexto especificados. (Heredado de NSObject)
RemoveObserver(NSObject, String)	Impide que el observador especificado reciba más notificaciones de los valores modificados para keyPath especificado. (Heredado de NSObject)
RemoveObserver(NSObject, String, IntPtr)	Impide que el observador especificado reciba más notificaciones de valores modificados para el keyPath y el contexto especificados. (Heredado de NSObject)
RespondsToSelector(Selector)	Si este objeto reconoce el selector especificado. (Heredado de NSObject)
SetNativeField(String, NSObject)	Obsoletos. Diccionario que proporciona la asignación de claves a valores. (Heredado de NSObject)
SetNilValueForKey(NSString)	Establece el valor de la clave especificada en NULL. (Heredado de NSObject)
SetValueForKey(NSObject, NSString)	Establece el valor de la propiedad especificada por la clave en el valor especificado. (Heredado de NSObject)
SetValueForKeyPath(IntPtr, NSString)	Constructor utilizado al crear representaciones administradas de objetos no administrados; Lo llama el tiempo de ejecución. (Heredado de NSObject)
SetValueForKeyPath(NSObject, NSString)	Establece el valor de una propiedad que se puede alcanzar mediante una ruta de acceso de clave. (Heredado de NSObject)
SetValueForUndefinedKey(NSObject, NSString)	Indica un intento de escribir un valor en una clave no definida. Si no se reemplaza, genera una excepción NSUndefinedKeyException. (Heredado de NSObject)
SetValuesForKeysWithDictionary(NSDictionary)	Establece los valores de este NSObject en los del diccionario especificado. (Heredado de NSObject)
ToFileAttributes()	Diccionario que proporciona la asignación de claves a valores.
ToString()	Devuelve una representación de cadena del valor de la instancia actual. (Heredado de NSObject)
TryGetValue(NSObject, NSObject)	Diccionario que proporciona la asignación de claves a valores.
Unbind(NSString)	Diccionario que proporciona la asignación de claves a valores. (Heredado de NSObject)
Unbind(String)	Diccionario que proporciona la asignación de claves a valores. (Heredado de NSObject)
ValueForKey(NSString)	Devuelve el valor de la propiedad asociada a la clave especificada. (Heredado de NSObject)
ValueForKeyPath(NSString)	Devuelve el valor de una propiedad que se puede alcanzar mediante una ruta de acceso de clave. (Heredado de NSObject)
ValueForUndefinedKey(NSString)	Indica un intento de leer un valor de una clave no definida. Si no se reemplaza, genera una excepción NSUndefinedKeyException. (Heredado de NSObject)
WillChange(NSKeyValueChange, NSIndexSet, NSString)	Indica que los valores de los índices especificados en la clave especificada están a punto de cambiar. (Heredado de NSObject)
WillChange(NSString, NSKeyValueSetMutationKind, NSSet)	Diccionario que proporciona la asignación de claves a valores. (Heredado de NSObject)
WillChangeValue(String)	Indica que el valor de la clave especificada está a punto de cambiar. (Heredado de NSObject)
WriteToFile(String, Boolean)	Intenta escribir el NSDictionary en la ruta de acceso especificada. Si useAuxiliaryFile es true, el archivo se escribe de forma atómica. Devuelve el éxito o el error.
WriteToUrl(NSUrl, Boolean)	Attemps para escribir NSDictionary en la dirección URL especificada y si se debe hacerlo de forma atómica. Devuelve el éxito o el error.

Implementaciones de interfaz explícitas

ICollection.CopyTo(Array, Int32)	Diccionario que proporciona la asignación de claves a valores.
ICollection.Count	Diccionario que proporciona la asignación de claves a valores.
ICollection.IsSynchronized	Diccionario que proporciona la asignación de claves a valores.
ICollection.SyncRoot	Diccionario que proporciona la asignación de claves a valores.
ICollection<KeyValuePair<NSObject,NSObject>>.Add(KeyValuePair<NSObject,NSObject>)	Diccionario que proporciona la asignación de claves a valores.
ICollection<KeyValuePair<NSObject,NSObject>>.Clear()	Diccionario que proporciona la asignación de claves a valores.
ICollection<KeyValuePair<NSObject,NSObject>>.Contains(KeyValuePair<NSObject,NSObject>)	Diccionario que proporciona la asignación de claves a valores.
ICollection<KeyValuePair<NSObject,NSObject>>.CopyTo(KeyValuePair<NSObject,NSObject>[], Int32)	Crea una copia de este objeto, asignando memoria de la zona especificada o de la zona predeterminada si el argumento es NULL.
ICollection<KeyValuePair<NSObject,NSObject>>.Count	Diccionario que proporciona la asignación de claves a valores.
ICollection<KeyValuePair<NSObject,NSObject>>.IsReadOnly	Diccionario que proporciona la asignación de claves a valores.
ICollection<KeyValuePair<NSObject,NSObject>>.Remove(KeyValuePair<NSObject,NSObject>)	Diccionario que proporciona la asignación de claves a valores.
IDictionary.Add(Object, Object)	Diccionario que proporciona la asignación de claves a valores.
IDictionary.Clear()	Diccionario que proporciona la asignación de claves a valores.
IDictionary.Contains(Object)	Diccionario que proporciona la asignación de claves a valores.
IDictionary.GetEnumerator()	Diccionario que proporciona la asignación de claves a valores.
IDictionary.IsFixedSize	Diccionario que proporciona la asignación de claves a valores.
IDictionary.IsReadOnly	Diccionario que proporciona la asignación de claves a valores.
IDictionary.Item[Object]	Diccionario que proporciona la asignación de claves a valores.
IDictionary.Keys	Diccionario que proporciona la asignación de claves a valores.
IDictionary.Remove(Object)	Diccionario que proporciona la asignación de claves a valores.
IDictionary.Values	Diccionario que proporciona la asignación de claves a valores.
IDictionary<NSObject,NSObject>.Add(NSObject, NSObject)	Diccionario que proporciona la asignación de claves a valores.
IDictionary<NSObject,NSObject>.Keys	Diccionario que proporciona la asignación de claves a valores.
IDictionary<NSObject,NSObject>.Remove(NSObject)	Diccionario que proporciona la asignación de claves a valores.
IDictionary<NSObject,NSObject>.Values	Diccionario que proporciona la asignación de claves a valores.
IEnumerable.GetEnumerator()	Diccionario que proporciona la asignación de claves a valores.

Métodos de extensión

GetDebugDescription(INSObjectProtocol)	Diccionario que proporciona la asignación de claves a valores.
GetAccessibilityCustomRotors(NSObject)	Obtiene la matriz de UIAccessibilityCustomRotor objetos adecuados para this el objeto .
SetAccessibilityCustomRotors(NSObject, UIAccessibilityCustomRotor[])	Establece la matriz de UIAccessibilityCustomRotor objetos apropiados para this el objeto .

Consulte también

• Documentación de Apple para NSDictionary