NSException Constructores

Definición

Espacio de nombres:

Foundation

Ensamblado:

Xamarin.iOS.dll

Sobrecargas

NSException(NSCoder)	Constructor que inicializa el objeto a partir de los datos almacenados en el objeto unarchiver.
NSException(NSObjectFlag)	Constructor para llamar a las clases derivadas para omitir la inicialización y simplemente asignar el objeto.
NSException(IntPtr)	Constructor utilizado al crear representaciones administradas de objetos no administrados; Llamado por el entorno de ejecución.
NSException(String, String, NSDictionary)

NSException(NSCoder)

Constructor que inicializa el objeto a partir de los datos almacenados en el objeto unarchiver.

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

new Foundation.NSException : Foundation.NSCoder -> Foundation.NSException

Parámetros

coder

NSCoder

Objeto unarchiver.

Atributos

ExportAttribute DesignatedInitializerAttribute

Comentarios

Este constructor se proporciona para permitir que la clase se inicialice desde un archivador (por ejemplo, durante la deserialización de NIB). Esto forma parte del NSCoding protocolo.

Si los desarrolladores quieren crear una subclase de este objeto y seguir admitiendo la deserialización desde un archivo, deben implementar un constructor con una firma idéntica: tomar un único parámetro de tipo NSCoder y decorarlo con la declaración de atributo [Export("initWithCoder:"].

El estado de este objeto también se puede serializar mediante el método complementario EncodeTo.

NSException(NSObjectFlag)

Constructor para llamar a las clases derivadas para omitir la inicialización y simplemente asignar el objeto.

protected NSException (Foundation.NSObjectFlag t);

new Foundation.NSException : Foundation.NSObjectFlag -> Foundation.NSException

Parámetros

t

NSObjectFlag

Valor de sentinel sin usar, pase NSObjectFlag.Empty.

Comentarios

Las clases derivadas deben llamar a este constructor cuando construyen completamente el objeto en código administrado y simplemente quieren que el entorno de ejecución asigne e inicialice el NSObject. Esto es necesario para implementar el proceso de inicialización en dos pasos que usa Objective-C, el primer paso es realizar la asignación de objetos, el segundo paso consiste en inicializar el objeto. Cuando los desarrolladores invocan al constructor que toma NSObjectFlag.Empty aprovechan una ruta de acceso directa que va hasta NSObject para asignar simplemente la memoria del objeto y enlazar los objetos Objective-C y C# juntos. La inicialización real del objeto es para el desarrollador.

Normalmente, el generador de enlaces usa este constructor para asignar el objeto, pero impide que se produzca la inicialización real. Una vez realizada la asignación, el constructor tiene que inicializar el objeto. Con los constructores generados por el generador de enlaces, esto significa que invoca manualmente uno de los métodos "init" para inicializar el objeto.

Es responsabilidad del desarrollador inicializar completamente el objeto si se encadenan mediante la ruta de acceso NSObjectFlag.Empty.

En general, si el constructor del desarrollador invoca la implementación base NSObjectFlag.Empty, debe llamar a un método init de Objective-C. Si no es así, los desarrolladores deben encadenar al constructor adecuado en su clase.

El valor del argumento se omite y simplemente garantiza que el único código que se ejecuta es la fase de construcción es la asignación básica de NSObject y el registro de tipo en tiempo de ejecución. Normalmente, el encadenamiento tendría este aspecto:

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

NSException(IntPtr)

Constructor utilizado al crear representaciones administradas de objetos no administrados; Llamado por el entorno de ejecución.

protected internal NSException (IntPtr handle);

new Foundation.NSException : nativeint -> Foundation.NSException

Parámetros

handle

IntPtr

nativeint

Puntero (identificador) al objeto no administrado.

Comentarios

La infraestructura en tiempo de ejecución (GetNSObject(IntPtr)) invoca este constructor para crear una nueva representación administrada para un puntero a un objeto Objective-C no administrado. Los desarrolladores no deben invocar este método directamente, sino que deben llamar al método GetNSObject, ya que impedirá que dos instancias de un objeto administrado apunten al mismo objeto nativo.

NSException(String, String, NSDictionary)

[Foundation.Export("initWithName:reason:userInfo:")]
[ObjCRuntime.DesignatedInitializer]
public NSException (string name, string reason, Foundation.NSDictionary userInfo);

new Foundation.NSException : string * string * Foundation.NSDictionary -> Foundation.NSException

Parámetros

name

String

reason

String

userInfo

NSDictionary

Se agregará.

Este parámetro puede ser null.

Atributos

ExportAttribute DesignatedInitializerAttribute