NSObject Clase

Definición

[Foundation.Register("NSObject", true)]
public class NSObject : Foundation.INSObjectProtocol, IDisposable, IEquatable<Foundation.NSObject>

type NSObject = class
    interface INSObjectProtocol
    interface INativeObject
    interface IDisposable
    interface IEquatable<NSObject>

Herencia

Object

NSObject

Derivado

Accounts.ACAccount

Accounts.ACAccountCredential

Accounts.ACAccountStore

Accounts.ACAccountType

AddressBookUI.ABNewPersonViewControllerDelegate

Más…

Atributos

RegisterAttribute

Implementaciones

INSObjectProtocol INativeObject IDisposable IEquatable<NSObject>

Comentarios

Esta es la clase base que se usa para enlazar clases objective-C a clases de C#. Simplemente la subclases de NSObject generará una clase que se puede pasar a Objective-C.

La clase NSObject de C# y sus subclases son representaciones administradas de las instancias subyacentes de Objective-C. El puntero al objeto Objective-C de código no administrado se almacena en la Handle propiedad .

Es importante tener en cuenta que actualmente, el compilador no admite subclases genéricas de NSObject.

Registro de clases

Al crear una subclase de NSObject, esta subclase se registra con el runtime de Objective-C con un nombre basado en el nombre de tipo completo de .NET, que es un detalle de implementación. Si necesita asegurarse de que una clase de C# se expone con un nombre específico en el runtime de Objective-C, puede aplicar el T:ObjCRuntime.RegisterAttribute a la clase y especificar el nombre que desea que tenga la clase.

Lo anterior se suele usar en los casos en los que se quiere hacer referencia a la clase por su nombre en algún código objective-C, cuando se usan archivos XIB y Storyboard del Generador de interfaz o cuando se usa una configuración de serialización de Objective-C (por ejemplo, al usar NSCoder).

//
// This exposes the C# class _MySampleView as the Objective-C MyView
//
[Export ("MyView")]
public class _MySampleView : UIView {

}

Métodos objective-C

En general, las clases MonoTouch asignan una a una a las clases de Objective-C subyacentes. Por ejemplo, la clase de C# "MonoTouch.Foundation.NSObject" se asigna a la clase Objective-C "NSObject". Pero los métodos son diferentes. Los métodos de Objective-C no se traducen bien en métodos de C#, por lo que se han modificado en general para que coincidan con el lenguaje C#, las expresiones de C# y las directrices de diseño de .NET Framework.

Los métodos objective-C se exponen a C# como métodos virtuales que tienen aplicados los métodos T:ObjCRuntime.ExportAttribute . El compilador usa este atributo para asignar nombres de C# a nombres de Objective-C. Estos atributos se muestran en la documentación de la API sobre cada función, para ayudarle a identificar a qué método Objective-C llama a un método de C# determinado.

Para modificar el comportamiento de una clase, use las expresiones estándar de C#: cree una subclase e invalide los métodos que desea modificar y usar la "base". característica de idioma para llamar opcionalmente a la clase base.

public class MyView : UISlider {
	public override void Draw (RectangleF rect)
	{
		// Let the base class draw first
		base.Draw (rect);

		// Our custom code
		var ctx = UIGraphics.GetCurrentContext ();
		UIColor.Gray.SetColor ();
		ctx.StrokeEllipseInRect (rect);
	}
}

De forma predeterminada, solo los métodos que se han sobrescrito se exponen al mundo objective-C. Si desea exponer un método arbitrario de C# al mundo de Objective-C, debe aplicar T:ObjCRuntime.ExportAttribute al método público. Y esto se puede hacer tanto en métodos estáticos como en métodos de instancia. Una vez aplicado el atributo, el método se expondrá a Objective-C y las operaciones de serialización de tipos de datos estándar compatibles con el runtime estarán disponibles para esos métodos.

//
// Exposes the class StringUtilities to Objective-C with the 
// method:
//    - (NSString *) joinArray:(NSArray *) stringArray withSeparator:(NSString *sep);
//
// Used like this:
//   id utilities = [[StringUtilities alloc] init];
//   NSLog (@"Joined: %@", [utilities joinArray:users withSeparator:@", "]);
//
public class StringUtilities : NSObject {
	[Export ("joinArray:withSeparator:")]
	public string Join (string [] array, string separator)
	{
		return string.Join (separator, array);
	}
}

Ciclo de vida

El NSObject de C# y sus subclases son contenedores administrados para el objeto Objective-C subyacente. Se crean a partir de C#, cuando se crea una nueva instancia mediante el operador "new" o cuando se muestra un objeto no administrado existente en el mundo de C#.

Al crear un objeto a partir de C# con el operador "new", el objeto será propiedad inicial de C#, y C# conservará una referencia al objeto. Esta referencia solo se quitará cuando el recolector de elementos no utilizados determine que no hay referencias administradas pendientes a ella o cuando se llama manualmente al método Dispose en el objeto .

Los NSObject de C# también se crean a petición cuando se invoca un método o una propiedad que devuelve un NSObject. En este momento, el entorno de ejecución examinará una memoria caché de objetos y determinará si ya se ha expuesto un NSObject de Objective-C determinado al mundo administrado o no. Si se ha expuesto el objeto, se devolverá el objeto existente; de lo contrario, se invocará un constructor que tome intPtr como parámetro para construir el objeto.

Los "elementos del mismo nivel" puros para los objetos de marco (aquellos objetos que son meramente representaciones de C# de un objeto Objective-C y que no tienen ningún estado asociado administrado adicional) se pueden volver a crear mediante el tiempo de ejecución a petición mediante el constructor mencionado antes.

Las subclases de usuario de NSObjects a menudo contienen estado de C#, por lo que cada vez que el tiempo de ejecución de Objective-C realiza una operación de "retención" en uno de estos objetos, el tiempo de ejecución crea un GCHandle que mantiene activo el objeto administrado, incluso si no hay referencias visibles de C# al objeto. Esto simplifica la reserva de un montón, ya que el estado se conservará automáticamente para usted.

La operación Dispose en un NSObject siempre quitará la referencia al objeto Objective-C subyacente, pero no destruirá el estado administrado, esto solo ocurrirá cuando tanto el código administrado como el código no administrado hayan liberado los objetos. Esto es ligeramente diferente de .NET, porque en .NET una vez que se elimina un objeto, no es posible invocar ningún método en el objeto, ya que se considera inútil. No es el caso de NSObjects.

Adopción de protocolos

En MonoTouch, la mayoría de los protocolos objective-C se asignan a clases que tienen aplicado t T:ObjCRuntime.ModelAttribute . Y la forma en que adopta un protocolo es mediante la subclases y sobrescribir los métodos que desea adoptar.

Hay algunos casos excepcionales en los que quiere adoptar un protocolo ad hoc por su cuenta. Si necesita adoptar un protocolo Objective-C, debe usar en la AdoptsAttribute clase y proporcionar el nombre del protocolo que desea adoptar. Normalmente, al adoptar un protocolo, también tendrá que enumerar todos los selectores de Objective-C que está adoptando mediante T T:ObjCRuntime.ExportAttribute.

[Adopts ("NSLocking")]
public class MyLockeingObject : NSObject {
	[Export ("lock")]
	public void Lock ()
	{
		// ...
	}

	[Export ("unlock")]
	public void Unlock ()
	{
		// ...
	}
}

Codificación de valor de clave

La codificación key Value es un mecanismo que permite acceder a las propiedades de un objeto por su nombre, en lugar de acceder a ellos directamente con un método de C#.

Para exponer una propiedad de C# al sistema de codificación de Key-Value lo único que necesita hacer es agregar T T:ObjCRuntime.ExportAttribute a la propiedad. Los nombres solo deben contener caracteres ASCII, empezar con una letra minúscula y no deben contener espacios.

public class CircleLayer : CALayer {
	[Export ("radius")]
	public double Radius { get; set; }

	// ...
}

Use los métodos M:Foundation.ValueForKey(Foundation.NSString);* para buscar una propiedad con un nombre y usar las funciones M:Foundation.SetValueForKey(Foundation.NSObject, Foundation.NSString);*" métodos para establecer el valor de la propiedad especificada. Por ejemplo, podría llamar a foo. ValueForKey ("user") para obtener el valor de la propiedad user en un objeto .

Además, puede usar rutas de acceso de clave para que el tiempo de ejecución llame repetidamente a ValueForKey o SetValueForKey. Las claves se separan mediante un punto. Por ejemplo, la ruta de acceso clave "user.address.phone.mobile" solicitaría la propiedad user y, a continuación, solicitaría la propiedad address en el usuario, solicitaría la propiedad phone en la dirección y, por último, solicitaría la propiedad móvil en el teléfono y, por último, usaría el resultado como valor. Se usa M:Foundation.ValueForKeyPath(Foundation.NSString);* para buscar una propiedad mediante una ruta de acceso clave y se usa M:Foundation.SetValueForKeyPath(Foundation.NSObject, Foundation.NSString);* para establecer un valor mediante una ruta de acceso clave.

Cuando se usan rutas de acceso clave, si se produce un error en una búsqueda, SetValueForUndefinedKey(NSObject, NSString) se invocará al establecer un valor y ValueForUndefinedKey(NSString) se invocará al buscar un valor. Ambos métodos generan de forma predeterminada una excepción objective-C, puede modificar ese comportamiento reemplazando los métodos.

Observación de valor clave

La observación del valor de clave es un mecanismo implementado por NSObject que se puede usar para supervisar los cambios realizados en un NSObject a través del sistema de codificación de valores de clave.

Para que la clase observe una notificación, debe invalidar el ObserveValue(NSString, NSObject, NSDictionary, IntPtr) método que se invocará con la información sobre los cambios de valor de una ruta de acceso de clave específica. A continuación, use AddObserver(NSObject, NSString, NSKeyValueObservingOptions, IntPtr) para empezar a observar los cambios y el RemoveObserver(NSObject, NSString, IntPtr) método para dejar de recibir notificaciones.

Constructores

Campos

Propiedades

Métodos

Métodos de extensión

Se aplica a

Consulte también

• Documentación de Apple para NSObject