NSError Конструкторы

Определение

Пространство имен:

Foundation

Сборка:

Xamarin.iOS.dll

Перегрузки

NSError()	Не используйте конструктор по умолчанию, если вы не используете низкоуровневый API, который инициализирует объект.
NSError(NSCoder)	Конструктор, который инициализирует объект из данных, хранящихся в объекте unarchiver.
NSError(NSObjectFlag)	Конструктор для вызова производных классов для пропуска инициализации и просто выделения объекта.
NSError(IntPtr)	Конструктор, используемый при создании управляемых представлений неуправляемых объектов; Вызывается средой выполнения.
NSError(NSString, nint)	Конструктор, который инициализирует объект с указанным доменом и кодом ошибки.
NSError(NSString, nint, NSDictionary)

NSError()

Не используйте конструктор по умолчанию, если вы не используете низкоуровневый API, который инициализирует объект.

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

Атрибуты

AdviceAttribute

Комментарии

Конструктор по умолчанию для NSError оставляет объект в частичном состоянии, которое может быть инициализировано только несколькими низкоуровневыми API Objective-C. Как правило, этот конструктор не следует использовать, вместо этого следует использовать конструктор, который принимает аргумент домена ошибки NSString.

NSError(NSCoder)

Конструктор, который инициализирует объект из данных, хранящихся в объекте unarchiver.

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

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

Параметры

coder

NSCoder

Объект unarchiver.

Атрибуты

ExportAttribute DesignatedInitializerAttribute

Комментарии

Этот конструктор предоставляется для инициализации класса из неархиватора (например, во время десериализации NIB). Это часть NSCoding протокола.

Если разработчики хотят создать подкласс этого объекта и продолжать поддерживать десериализацию из архива, они должны реализовать конструктор с идентичной сигнатурой: взяв один параметр типа NSCoder и дополнив его объявлением атрибута [Export("initWithCoder:"].

Состояние этого объекта также можно сериализовать с помощью вспомогательного метода EncodeTo.

NSError(NSObjectFlag)

Конструктор для вызова производных классов для пропуска инициализации и просто выделения объекта.

protected NSError (Foundation.NSObjectFlag t);

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

Параметры

t

NSObjectFlag

Неиспользуемое значение sentinel, передайте NSObjectFlag.Empty.

Комментарии

Этот конструктор должен вызываться производными классами, когда они полностью создают объект в управляемом коде и просто хотят, чтобы среда выполнения выделила и инициализировала NSObject. Это необходимо для реализации двухфакторного процесса инициализации, который использует Objective-C. Первый шаг — выделение объекта, второй шаг — инициализация объекта. Когда разработчики вызывают конструктор, который принимает NSObjectFlag.Empty, они используют прямой путь вплоть до NSObject, чтобы просто выделить память объекта и связать объекты Objective-C и C# вместе. Фактическая инициализация объекта выполняется разработчиком.

Этот конструктор обычно используется генератором привязки для выделения объекта, но предотвращает фактическую инициализацию. После выделения конструктор должен инициализировать объект . При использовании конструкторов, созданных генератором привязки, это означает, что он вручную вызывает один из методов init для инициализации объекта.

Разработчик несет ответственность за полную инициализацию объекта, если они связаны с использованием пути NSObjectFlag.Empty.

Как правило, если конструктор разработчика вызывает базовую реализацию NSObjectFlag.Empty, он должен вызывать метод инициализации Objective-C. Если это не так, разработчики должны вместо этого привязать к соответствующему конструктору в своем классе.

Значение аргумента игнорируется и просто гарантирует, что единственным выполняемым кодом является этап построения, является базовое выделение NSObject и регистрация типа среды выполнения. Обычно цепочка выглядит следующим образом:

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

Конструктор, используемый при создании управляемых представлений неуправляемых объектов; Вызывается средой выполнения.

protected internal NSError (IntPtr handle);

new Foundation.NSError : nativeint -> Foundation.NSError

Параметры

handle

IntPtr

nativeint

Указатель (дескриптор) на неуправляемый объект.

Комментарии

Этот конструктор вызывается инфраструктурой среды выполнения (GetNSObject(IntPtr)) для создания нового управляемого представления указателя на неуправляемый объект Objective-C. Разработчики не должны вызывать этот метод напрямую, вместо этого они должны вызывать метод GetNSObject, так как это не позволит двум экземплярам управляемого объекта указывать на один и тот же собственный объект.

NSError(NSString, nint)

Конструктор, который инициализирует объект с указанным доменом и кодом ошибки.

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

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

Параметры

domain

NSString

Домен ошибки

code

System.System.IntPtr System.nativeint

Код ошибки.

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

Параметры

domain

NSString

code

System.System.IntPtr System.nativeint

userInfo

NSDictionary

Будет добавлено.

Этот параметр может иметь значение null.

Атрибуты

ExportAttribute DesignatedInitializerAttribute