Поделиться через


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

Определение

Перегрузки

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 ();
Атрибуты

Применяется к

NSString(NSCoder)

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

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

Параметры

coder
NSCoder

Объект unarchiver.

Атрибуты

Комментарии

Этот конструктор предоставляется для инициализации класса из неархиватора (например, во время десериализации 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

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

Атрибуты

Применяется к

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

Применяется к