NSError Costruttori

Definizione

Spazio dei nomi:

Foundation

Assembly:

Xamarin.iOS.dll

Overload

NSError()	Non usare il costruttore predefinito a meno che non si tratti di un'API di basso livello che inizializzerà l'oggetto.
NSError(NSCoder)	Costruttore che inizializza l'oggetto dai dati archiviati nell'oggetto unrchiver.
NSError(NSObjectFlag)	Costruttore per chiamare classi derivate per ignorare l'inizializzazione e allocare semplicemente l'oggetto.
NSError(IntPtr)	Costruttore usato durante la creazione di rappresentazioni gestite di oggetti non gestiti; Chiamato dal runtime.
NSError(NSString, nint)	Costruttore che inizializza l'oggetto con un dominio specificato e un codice di errore.
NSError(NSString, nint, NSDictionary)

NSError()

Non usare il costruttore predefinito a meno che non si tratti di un'API di basso livello che inizializzerà l'oggetto.

[Foundation.Advice("Always specify a domain and error code when creating an NSError instance")]
public NSError ();

Attributi

AdviceAttribute

Commenti

Il costruttore predefinito per NSError lascia l'oggetto in uno stato parziale che può essere inizializzato solo da una manciata di API Objective-C di basso livello. In generale, non è consigliabile usare questo costruttore, è consigliabile usare il costruttore che accetta un argomento di dominio di errore NSString.

NSError(NSCoder)

Costruttore che inizializza l'oggetto dai dati archiviati nell'oggetto unrchiver.

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

new Foundation.NSError : Foundation.NSCoder -> Foundation.NSError

Parametri

coder

NSCoder

Oggetto unarchiver.

Attributi

ExportAttribute DesignatedInitializerAttribute

Commenti

Questo costruttore viene fornito per consentire l'inizializzazione della classe da un nonrchiver (ad esempio durante la deserializzazione nib). Fa parte del NSCoding protocollo.

Se gli sviluppatori vogliono creare una sottoclasse di questo oggetto e continuare a supportare la deserializzazione da un archivio, devono implementare un costruttore con una firma identica: prendere un singolo parametro di tipo NSCoder e decorarlo con la dichiarazione di attributo [Export("initWithCoder:"].

Lo stato di questo oggetto può essere serializzato anche usando il metodo complementare CodificaTo.

NSError(NSObjectFlag)

Costruttore per chiamare classi derivate per ignorare l'inizializzazione e allocare semplicemente l'oggetto.

protected NSError (Foundation.NSObjectFlag t);

new Foundation.NSError : Foundation.NSObjectFlag -> Foundation.NSError

Parametri

t

NSObjectFlag

Valore sentinel inutilizzato, passare NSObjectFlag.Empty.

Commenti

Questo costruttore deve essere chiamato dalle classi derivate quando costruiscono completamente l'oggetto nel codice gestito e vogliono semplicemente che il runtime alloca e inizializzi NSObject. È necessario implementare il processo di inizializzazione in due passaggi usato da Objective-C, il primo passaggio consiste nell'eseguire l'allocazione dell'oggetto, il secondo passaggio consiste nell'inizializzare l'oggetto. Quando gli sviluppatori richiamano il costruttore che accetta nSObjectFlag.Empty sfruttano un percorso diretto che passa fino a NSObject per allocare semplicemente la memoria dell'oggetto e associare insieme gli oggetti Objective-C e C#. L'inizializzazione effettiva dell'oggetto è fino allo sviluppatore.

Questo costruttore viene in genere usato dal generatore di associazione per allocare l'oggetto, ma impedisce che venga eseguita l'inizializzazione effettiva. Dopo aver eseguito l'allocazione, il costruttore deve inizializzare l'oggetto. Con i costruttori generati dal generatore di binding questo significa che richiama manualmente uno dei metodi "init" per inizializzare l'oggetto.

È responsabilità dello sviluppatore inizializzare completamente l'oggetto se si concatenano usando il percorso NSObjectFlag.Empty.

In generale, se il costruttore dello sviluppatore richiama l'implementazione di base NSObjectFlag.Empty, deve chiamare un metodo Objective-C init. In caso contrario, gli sviluppatori devono invece concatenare il costruttore appropriato nella propria classe.

Il valore dell'argomento viene ignorato e garantisce semplicemente che l'unico codice eseguito sia la fase di costruzione sia l'allocazione NSObject di base e la registrazione del tipo di runtime. In genere il concatenamento sarà simile al seguente:

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

NSError(IntPtr)

Costruttore usato durante la creazione di rappresentazioni gestite di oggetti non gestiti; Chiamato dal runtime.

protected internal NSError (IntPtr handle);

new Foundation.NSError : nativeint -> Foundation.NSError

Parametri

handle

IntPtr

nativeint

Puntatore (handle) all'oggetto non gestito.

Commenti

Questo costruttore viene richiamato dall'infrastruttura di runtime (GetNSObject(IntPtr)) per creare una nuova rappresentazione gestita per un puntatore a un oggetto Objective-C non gestito. Gli sviluppatori non devono richiamare direttamente questo metodo, invece devono chiamare il metodo GetNSObject perché impedirà due istanze di un oggetto gestito per puntare allo stesso oggetto nativo.

NSError(NSString, nint)

Costruttore che inizializza l'oggetto con un dominio specificato e un codice di errore.

public NSError (Foundation.NSString domain, nint code);

new Foundation.NSError : Foundation.NSString * nint -> Foundation.NSError

Parametri

domain

NSString

Dominio di errore

code

System.System.IntPtr System.nativeint

Codice di errore.

NSError(NSString, nint, NSDictionary)

[Foundation.Export("initWithDomain:code:userInfo:")]
[ObjCRuntime.DesignatedInitializer]
public NSError (Foundation.NSString domain, nint code, Foundation.NSDictionary userInfo);

new Foundation.NSError : Foundation.NSString * nint * Foundation.NSDictionary -> Foundation.NSError

Parametri

domain

NSString

code

System.System.IntPtr System.nativeint

userInfo

NSDictionary

Da aggiungere.

Questo parametro può essere null.

Attributi

ExportAttribute DesignatedInitializerAttribute