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

Определение

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

Foundation

Сборка:

Xamarin.iOS.dll

Перегрузки

NSString()	Конструктор по умолчанию, который инициализирует новый экземпляр этого класса без параметров.
NSString(NSCoder)	Конструктор, который инициализирует объект из данных, хранящихся в объекте unarchiver.
NSString(NSObjectFlag)	Конструктор для вызова производных классов для пропуска инициализации и просто выделения объекта.
NSString(IntPtr)	Конструктор, используемый при создании управляемых представлений неуправляемых объектов; Вызывается средой выполнения.
NSString(String)	Создает NSString из строки C#.
NSString(NSData, NSStringEncoding)	Создает строку из указанного большого двоичного объекта данных с использованием определенной кодировки.
NSString(String, Int32, Int32)

NSString()

Конструктор по умолчанию, который инициализирует новый экземпляр этого класса без параметров.

[Foundation.Export("init")]
[ObjCRuntime.DesignatedInitializer]
public NSString ();

Атрибуты

ExportAttribute DesignatedInitializerAttribute

NSString(NSCoder)

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

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

new Foundation.NSString : Foundation.NSCoder -> Foundation.NSString

Параметры

coder

NSCoder

Объект unarchiver.

Атрибуты

ExportAttribute DesignatedInitializerAttribute

Комментарии

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

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

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

NSString(NSObjectFlag)

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

protected NSString (Foundation.NSObjectFlag t);

new Foundation.NSString : Foundation.NSObjectFlag -> Foundation.NSString

Параметры

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

NSString(IntPtr)

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

protected internal NSString (IntPtr handle);

new Foundation.NSString : nativeint -> Foundation.NSString

Параметры

handle

IntPtr

nativeint

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

Комментарии

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

NSString(String)

Создает NSString из строки C#.

public NSString (string str);

new Foundation.NSString : string -> Foundation.NSString

Параметры

str

String

Строка.

NSString(NSData, NSStringEncoding)

Создает строку из указанного большого двоичного объекта данных с использованием определенной кодировки.

[Foundation.Export("initWithData:encoding:")]
public NSString (Foundation.NSData data, Foundation.NSStringEncoding encoding);

new Foundation.NSString : Foundation.NSData * Foundation.NSStringEncoding -> Foundation.NSString

Параметры

data

NSData

Блок данных, заключенный в NSData и закодированный в указанной кодировке.

encoding

NSStringEncoding

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

Атрибуты

ExportAttribute

NSString(String, Int32, Int32)

public NSString (string value, int start, int length);

new Foundation.NSString : string * int * int -> Foundation.NSString

Параметры

value

String

start

Int32

length

Int32