NSString 类

定义

命名空间:

Foundation

程序集:

Xamarin.iOS.dll

基础字符串类。

[Foundation.Register("NSString", true)]
public class NSString : Foundation.NSObject, AppKit.INSPasteboardReading, AppKit.INSPasteboardWriting, CloudKit.ICKRecordValue, Foundation.INSItemProviderReading, Foundation.INSItemProviderWriting, Foundation.INSMutableCopying, Foundation.INSSecureCoding, IDisposable

type NSString = class
    inherit NSObject
    interface INSCoding
    interface INativeObject
    interface IDisposable
    interface INSCopying
    interface INSItemProviderReading
    interface INSItemProviderWriting
    interface INSMutableCopying
    interface INSSecureCoding
    interface INSPasteboardReading
    interface INSPasteboardWriting
    interface ICKRecordValue

继承

Object

NSObject

NSString

派生

CoreSpotlight.CSLocalizedString

Foundation.NSMutableString

属性

RegisterAttribute

实现

INSPasteboardReading INSPasteboardWriting ICKRecordValue INSCoding INSCopying INSItemProviderReading INSItemProviderWriting INSMutableCopying INSSecureCoding INativeObject IDisposable

注解

这是到 Objective-C NSString 类的映射。 通常，在 .NET 语言中，在代码中使用本机 T：System.String 类型。 通常，在 C#/Mono 代码中使用 NSString 是不值得的，因为从 C# 字符串手动创建 NSString 时，封送处理的成本比让运行时封送它的成本更高。

在一些情况下，你将在 MonoTouch 中处理 NSString 对象。 在这些情况下，NSString 用作句柄或令牌。 这意味着基础平台代码使用 NSString 的地址作为特殊句柄， (代码不按内容比较字符串，而是按地址) 。 在这些情况下，NSString 已显示在 MonoTouch 绑定中。 通常会找到通知常量或键常量。

C# 代码中的 NSString 的另一个用途是，要使用 NSStrings 中公开的某些直接映射到基础平台本地化表的本地化 API。

与 Objective-C 互操作的代码会自动将内部 C# 字符串转换为 NSString。 有时通过执行字符串的副本，但运行时也支持将 .NET 字符串作为 NSString 进行零副本封送处理

构造函数

NSString()	不带参数初始化此类的新实例的默认构造函数。
NSString(IntPtr)	创建非托管对象的托管表示形式时使用的构造函数;由运行时调用。
NSString(NSCoder)	从 unarchiver 对象中存储的数据初始化 对象的构造函数。
NSString(NSData, NSStringEncoding)	使用特定编码从指定的数据 Blob 创建字符串。
NSString(NSObjectFlag)	用于调用派生类的构造函数，以跳过初始化并仅分配 对象。
NSString(String)	从 C# 字符串创建 NSString。
NSString(String, Int32, Int32)	基础字符串类。

字段

Empty

基础字符串类。

属性

Class	基础字符串类。 (继承自 NSObject)
ClassHandle	此类的句柄。
DebugDescription	此对象的开发人员有意义的说明。 (继承自 NSObject)
Description	对象的说明，即 ToString 的 Objective-C 版本。 (继承自 NSObject)
Handle	处理指向非托管对象表示形式的 (指针) 。 (继承自 NSObject)
IsAbsolutePath	这是否是绝对路径。
IsDirectBinding	基础字符串类。 (继承自 NSObject)
IsProxy	基础字符串类。 (继承自 NSObject)
Item[nint]	基础字符串类。
LastPathComponent	此字符串的最后一个路径组件。
Length	此字符串中的 Unicode 字符数。
LocalizedCapitalizedString	基础字符串类。
LocalizedLowercaseString	基础字符串类。
LocalizedUppercaseString	基础字符串类。
PathComponents	字符串数组，按顺序包含此字符串的每个路径组件。
PathExtension	返回此字符串的路径扩展（如果有）。
ReadableTypeIdentifiers	基础字符串类。
RetainCount	返回对象的当前 Objective-C 保留计数。 (继承自 NSObject)
Self	基础字符串类。 (继承自 NSObject)
Superclass	基础字符串类。 (继承自 NSObject)
SuperHandle	用于表示此 NSObject 基类中方法的句柄。 (继承自 NSObject)
WritableTypeIdentifiers	基础字符串类。
WritableTypeIdentifiersForItemProvider	基础字符串类。
Zone	基础字符串类。 (继承自 NSObject)

方法

AbbreviateTildeInPath()	通过将平铺替换为路径的相关部分，将 spath 转换为主目录相对路径。
AddObserver(NSObject, NSString, NSKeyValueObservingOptions, IntPtr)	使用 NSString keyPath) 注册在外部 (观察到的对象。   观察到的更改将调度到观察者的 对象 ObserveValue(NSString, NSObject, NSDictionary, IntPtr) 方法。 (继承自 NSObject)
AddObserver(NSObject, String, NSKeyValueObservingOptions, IntPtr)	使用 string keyPath) 注册在外部 (观察到的对象。   观察到的更改将调度到观察者的 对象 ObserveValue(NSString, NSObject, NSDictionary, IntPtr) 方法。 (继承自 NSObject)
AddObserver(NSString, NSKeyValueObservingOptions, Action<NSObservedChange>)	注册一个对象，以便使用任意方法在外部观察到。 (继承自 NSObject)
AddObserver(String, NSKeyValueObservingOptions, Action<NSObservedChange>)	注册一个对象，以便使用任意方法在外部观察到。 (继承自 NSObject)
AppendPathComponent(NSString)	以生成路径的方式追加指定的 str。
AppendPathExtension(NSString)	通过附加路径扩展分隔符和指定的 str 作为文件扩展名来创建路径。
AppendPaths(String[])	返回通过将此 NSString 追加到每个指定输入路径而创建的字符串数组。
AwakeFromNib()	从 nib 文件加载对象后调用。 重写程序必须调用 base。AwakeFromNib () 。 (继承自 NSObject)
BeginInvokeOnMainThread(Action)	基础字符串类。 (继承自 NSObject)
BeginInvokeOnMainThread(Selector, NSObject)	在主 UI 线程上异步调用指定的代码。 (继承自 NSObject)
Bind(NSString, NSObject, String, NSDictionary)	基础字符串类。 (继承自 NSObject)
Bind(String, NSObject, String, NSDictionary)	基础字符串类。 (继承自 NSObject)
BindingInfo(String)	基础字符串类。 (继承自 NSObject)
BindingOptionDescriptions(String)	基础字符串类。 (继承自 NSObject)
BindingValueClass(String)	基础字符串类。 (继承自 NSObject)
Capitalize(NSLocale)	使用指定区域设置的规则将字符串大写。
CommitEditing()	基础字符串类。 (继承自 NSObject)
CommitEditing(NSObject, Selector, IntPtr)	基础字符串类。 (继承自 NSObject)
CommonPrefix(NSString, NSStringCompareOptions)	基础字符串类。
Compare(NSString)	词法将此与指定的字符串进行比较。
Compare(NSString, NSStringCompareOptions)	基础字符串类。
Compare(NSString, NSStringCompareOptions, NSRange)	基础字符串类。
Compare(NSString, NSStringCompareOptions, NSRange, NSLocale)	基础字符串类。
ConformsToProtocol(IntPtr)	调用 以确定此对象是否实现指定的协议。 (继承自 NSObject)
Contains(NSString)	基础字符串类。
Copy()	执行基础 Objective-C 对象的副本。 (继承自 NSObject)
Copy(NSZone)	执行基础 Objective-C 对象的副本。
CreateNative(String)	从 C# 字符串创建 Objective-C NSString 并返回指向它的指针。
CreateNative(String, Boolean)	基础字符串类。
CreateNative(String, Int32, Int32)	基础字符串类。
CreateNative(String, Int32, Int32, Boolean)	基础字符串类。
DangerousAutorelease()	基础字符串类。 (继承自 NSObject)
DangerousRelease()	基础字符串类。 (继承自 NSObject)
DangerousRetain()	基础字符串类。 (继承自 NSObject)
DeleteLastPathComponent()	通过删除此字符串的最后一个路径组件返回新字符串。
DeletePathExtension()	通过从此字符串中删除路径扩展来返回新字符串。
DetectStringEncoding(NSData, EncodingDetectionOptions, String, Boolean)	基础字符串类。
DetectStringEncoding(NSData, NSDictionary, String, Boolean)	基础字符串类。
DidChange(NSKeyValueChange, NSIndexSet, NSString)	指示对多关系的索引发生了更改。 (继承自 NSObject)
DidChange(NSString, NSKeyValueSetMutationKind, NSSet)	基础字符串类。 (继承自 NSObject)
DidChangeValue(String)	指示在指定的键上发生了更改。 (继承自 NSObject)
Dispose()	释放 NSObject 对象使用的资源。 (继承自 NSObject)
Dispose(Boolean)	释放 NSObject 对象使用的资源。 (继承自 NSObject)
DoesNotRecognizeSelector(Selector)	指示此对象无法识别指定的选择器。 (继承自 NSObject)
Encode(NSStringEncoding, Boolean)	基础字符串类。
EncodeTo(NSCoder)	在提供的编码器上对对象的状态进行编码
Equals(NSObject)	基础字符串类。 (继承自 NSObject)
Equals(NSString, NSString)	基础字符串类。
Equals(Object)	基础字符串类。
ExpandTildeInPath()	返回一个新字符串，该字符串扩展此字符串中的平铺 (指示用户的主页 dir) 完整路径。
ExposedBindings()	基础字符串类。 (继承自 NSObject)
FromData(NSData, NSStringEncoding)	从 NSData 源创建 NSString。
FromHandle(IntPtr)	从指向 Objective-C NSString 对象的指针返回字符串的实用工具方法。
GetBindingInfo(NSString)	基础字符串类。 (继承自 NSObject)
GetBindingOptionDescriptions(NSString)	基础字符串类。 (继承自 NSObject)
GetBindingValueClass(NSString)	基础字符串类。 (继承自 NSObject)
GetDictionaryOfValuesFromKeys(NSString[])	检索指定键的值。 (继承自 NSObject)
GetHashCode()	为当前实例生成哈希代码。
GetItemProviderVisibilityForTypeIdentifier(String)	基础字符串类。
GetLineStart(nuint, nuint, nuint, NSRange)	基础字符串类。
GetLocalizedUserNotificationString(NSString, NSObject[])	基础字符串类。
GetLocalizedUserNotificationString(String, NSObject[])	已过时. 基础字符串类。
GetMethodForSelector(Selector)	基础字符串类。 (继承自 NSObject)
GetNativeField(String)	已过时. 基础字符串类。 (继承自 NSObject)
GetNativeHash()	基础字符串类。 (继承自 NSObject)
GetObject(NSData, String, NSError)	基础字符串类。
GetParagraphPositions(nuint, nuint, nuint, NSRange)	基础字符串类。
GetParagraphRange(NSRange)	基础字符串类。
GetVariantFittingPresentationWidth(nint)	基础字符串类。
HasPrefix(NSString)	基础字符串类。
HasSuffix(NSString)	基础字符串类。
Init()	基础字符串类。 (继承自 NSObject)
InitializeHandle(IntPtr)	基础字符串类。 (继承自 NSObject)
InitializeHandle(IntPtr, String)	基础字符串类。 (继承自 NSObject)
Invoke(Action, Double)	基础字符串类。 (继承自 NSObject)
Invoke(Action, TimeSpan)	基础字符串类。 (继承自 NSObject)
InvokeOnMainThread(Action)	基础字符串类。 (继承自 NSObject)
InvokeOnMainThread(Selector, NSObject)	在主 UI 线程上同步调用指定的代码。 (继承自 NSObject)
IsEqual(NSObject)	基础字符串类。 (继承自 NSObject)
IsEqualTo(IntPtr)	基础字符串类。
IsKindOfClass(Class)	基础字符串类。 (继承自 NSObject)
IsMemberOfClass(Class)	基础字符串类。 (继承自 NSObject)
LineRangeForRange(NSRange)	基础字符串类。
LoadData(String, Action<NSData,NSError>)	实现此方法以自定义 通过 NSItemProvider加载数据。
LoadDataAsync(String)	基础字符串类。
LoadDataAsync(String, NSProgress)	基础字符串类。
LocalizedCaseInsensitiveContains(NSString)	基础字符串类。
LocalizedFormat(NSString, NSObject[])	基础字符串类。
LocalizedFormat(NSString, Object[])	基础字符串类。
LocalizedFormat(String, Object[])	基础字符串类。
LocalizedStandardContainsString(NSString)	基础字符串类。
LocalizedStandardRangeOfString(NSString)	基础字符串类。
MarkDirty()	将常规对等对象 (IsDirectBinding 为 true) 提升为 toggleref 对象。 (继承自 NSObject)
MutableCopy()	创建指定 NSObject 的可变副本。 (继承自 NSObject)
MutableCopy(NSZone)	执行基础 Objective-C 对象的副本。
ObjectDidEndEditing(NSObject)	基础字符串类。 (继承自 NSObject)
ObserveValue(NSString, NSObject, NSDictionary, IntPtr)	指示指定 keyPath 相对于此对象的值已更改。 (继承自 NSObject)
PathWithComponents(String[])	从指定的组件数组构造路径。
PerformSelector(Selector)	基础字符串类。 (继承自 NSObject)
PerformSelector(Selector, NSObject)	基础字符串类。 (继承自 NSObject)
PerformSelector(Selector, NSObject, Double)	在当前实例上调用选择器，如果 obj 不为 null，则将其作为单个参数传递。 (继承自 NSObject)
PerformSelector(Selector, NSObject, Double, NSString[])	基础字符串类。 (继承自 NSObject)
PerformSelector(Selector, NSObject, NSObject)	基础字符串类。 (继承自 NSObject)
PerformSelector(Selector, NSThread, NSObject, Boolean)	基础字符串类。 (继承自 NSObject)
PerformSelector(Selector, NSThread, NSObject, Boolean, NSString[])	基础字符串类。 (继承自 NSObject)
PrepareForInterfaceBuilder()	基础字符串类。 (继承自 NSObject)
ReleaseNative(IntPtr)	释放本机 Objective-C 字符串。
RemoveObserver(NSObject, NSString)	阻止指定的观察程序接收指定 keyPath 的更改值的进一步通知。 (继承自 NSObject)
RemoveObserver(NSObject, NSString, IntPtr)	阻止指定的观察程序接收指定 keyPath 和上下文的更改值的进一步通知。 (继承自 NSObject)
RemoveObserver(NSObject, String)	阻止指定的观察程序接收指定 keyPath 的更改值的进一步通知。 (继承自 NSObject)
RemoveObserver(NSObject, String, IntPtr)	阻止指定的观察程序接收指定 keyPath 和上下文的更改值的进一步通知。 (继承自 NSObject)
Replace(NSRange, NSString)	在指定范围内返回一个新字符串，该字符串将替换字符串替换为此字符串。
ResolveSymlinksInPath()	解析此中的所有符号链接并返回标准化路径结果。
RespondsToSelector(Selector)	此对象是否识别指定的选择器。 (继承自 NSObject)
SeparateComponents(NSCharacterSet)	基础字符串类。
SeparateComponents(NSString)	基础字符串类。
SetNativeField(String, NSObject)	已过时. 基础字符串类。 (继承自 NSObject)
SetNilValueForKey(NSString)	将指定键的值设置为 null。 (继承自 NSObject)
SetValueForKey(NSObject, NSString)	将键指定的属性的值设置为指定值。 (继承自 NSObject)
SetValueForKeyPath(IntPtr, NSString)	创建非托管对象的托管表示形式时使用的构造函数;由运行时调用。 (继承自 NSObject)
SetValueForKeyPath(NSObject, NSString)	设置可使用键路径访问的属性的值。 (继承自 NSObject)
SetValueForUndefinedKey(NSObject, NSString)	指示尝试将值写入未定义的键。 如果未重写，则引发 NSUndefinedKeyException。 (继承自 NSObject)
SetValuesForKeysWithDictionary(NSDictionary)	将此 NSObject 的值设置为指定字典中的值。 (继承自 NSObject)
StandarizePath()	通过删除“/./”和类似的构造，将此字符串标准化为路径。
ToLower(NSLocale)	根据指定区域设置的规则返回此字符串的小写版本的新字符串。
ToString()	返回当前实例值的字符串表示形式。
ToUpper(NSLocale)	根据指定区域设置的规则返回此字符串的大写版本的新字符串。
TransliterateString(NSString, Boolean)	基础字符串类。
TransliterateString(NSStringTransform, Boolean)	基础字符串类。
Unbind(NSString)	基础字符串类。 (继承自 NSObject)
Unbind(String)	基础字符串类。 (继承自 NSObject)
ValueForKey(NSString)	返回与指定键关联的属性的值。 (继承自 NSObject)
ValueForKeyPath(NSString)	返回可使用键路径访问的属性的值。 (继承自 NSObject)
ValueForUndefinedKey(NSString)	指示尝试读取未定义键的值。 如果未重写，则引发 NSUndefinedKeyException。 (继承自 NSObject)
WillChange(NSKeyValueChange, NSIndexSet, NSString)	指示指定键中指定索引的值即将更改。 (继承自 NSObject)
WillChange(NSString, NSKeyValueSetMutationKind, NSSet)	基础字符串类。 (继承自 NSObject)
WillChangeValue(String)	指示指定键的值即将更改。 (继承自 NSObject)

运算符

Equality(NSString, NSString)	基础字符串类。
Explicit(String to NSString)	基础字符串类。
Implicit(NSString to String)	将 NSString 转换为 CIL/C# 字符串。
Inequality(NSString, NSString)	基础字符串类。

扩展方法

GetItemProviderVisibilityForTypeIdentifier(INSItemProviderWriting, String)	基础字符串类。
GetWritableTypeIdentifiersForItemProvider(INSItemProviderWriting)	基础字符串类。
LoadDataAsync(INSItemProviderWriting, String)	基础字符串类。
LoadDataAsync(INSItemProviderWriting, String, NSProgress)	基础字符串类。
EnumerateLinguisticTags(NSString, NSRange, NSLinguisticTagScheme, NSLinguisticTaggerOptions, NSOrthography, NSEnumerateLinguisticTagsEnumerator)	基础字符串类。
EnumerateLinguisticTags(NSString, NSRange, NSString, NSLinguisticTaggerOptions, NSOrthography, NSEnumerateLinguisticTagsEnumerator)	基础字符串类。
GetLinguisticTags(NSString, NSRange, NSLinguisticTagScheme, NSLinguisticTaggerOptions, NSOrthography, NSValue[])	基础字符串类。
GetLinguisticTags(NSString, NSRange, NSString, NSLinguisticTaggerOptions, NSOrthography, NSValue[])	基础字符串类。
GetDebugDescription(INSObjectProtocol)	基础字符串类。
CreateStringByAddingPercentEncoding(NSString, NSCharacterSet)	基础字符串类。
CreateStringByAddingPercentEscapes(NSString, NSStringEncoding)	基础字符串类。
CreateStringByRemovingPercentEncoding(NSString)	基础字符串类。
CreateStringByReplacingPercentEscapes(NSString, NSStringEncoding)	基础字符串类。
DrawString(NSString, CGRect, NSStringDrawingOptions, UIStringAttributes, NSStringDrawingContext)	基础字符串类。
GetBoundingRect(NSString, CGSize, NSStringDrawingOptions, UIStringAttributes, NSStringDrawingContext)	基础字符串类。
WeakDrawString(NSString, CGRect, NSStringDrawingOptions, NSDictionary, NSStringDrawingContext)	基础字符串类。
WeakGetBoundingRect(NSString, CGSize, NSStringDrawingOptions, NSDictionary, NSStringDrawingContext)	基础字符串类。
GetAccessibilityCustomRotors(NSObject)	获取适用于 this 对象的 对象的数组UIAccessibilityCustomRotor。
SetAccessibilityCustomRotors(NSObject, UIAccessibilityCustomRotor[])	设置适用于 this 对象的 对象数组UIAccessibilityCustomRotor。
DrawString(NSString, CGPoint, UIStringAttributes)	基础字符串类。
DrawString(NSString, CGRect, UIStringAttributes)	基础字符串类。
GetSizeUsingAttributes(NSString, UIStringAttributes)	字符串的 SizeF（如果使用指定的 attributes呈现）。
WeakDrawString(NSString, CGPoint, NSDictionary)	基础字符串类。
WeakDrawString(NSString, CGRect, NSDictionary)	基础字符串类。
WeakGetSizeUsingAttributes(NSString, NSDictionary)	返回呈现的字符串的大小。
DrawString(NSString, CGPoint, nfloat, UIFont, nfloat, nfloat, UILineBreakMode, UIBaselineAdjustment)	开发人员应使用 M：Foundation.NSString.DrawString (CoreGraphics.CGRect、UIKit.UIStringAttributes) 而不是此弃用的方法。
DrawString(NSString, CGPoint, nfloat, UIFont, nfloat, UILineBreakMode, UIBaselineAdjustment)	开发人员应使用 M：Foundation.NSString.DrawString (CoreGraphics.CGRect、UIKit.UIStringAttributes) 而不是此弃用的方法。
DrawString(NSString, CGPoint, nfloat, UIFont, UILineBreakMode)	开发人员应使用 M：Foundation.NSString.DrawString (CoreGraphics.CGRect、UIKit.UIStringAttributes) 而不是此弃用的方法。
DrawString(NSString, CGPoint, UIFont)	开发人员不应使用此已弃用的方法。 开发人员应改用“NSString.DrawString (CGPoint， UIStringAttributes) ”。
DrawString(NSString, CGRect, UIFont)	开发人员应使用 M：Foundation.NSString.DrawString (CoreGraphics.CGRect、UIKit.UIStringAttributes) 而不是此弃用的方法。
DrawString(NSString, CGRect, UIFont, UILineBreakMode)	开发人员应使用 M：Foundation.NSString.DrawString (CoreGraphics.CGRect、UIKit.UIStringAttributes) 而不是此弃用的方法。
DrawString(NSString, CGRect, UIFont, UILineBreakMode, UITextAlignment)	开发人员应使用 M：Foundation.NSString.DrawString (CoreGraphics.CGRect、UIKit.UIStringAttributes) 而不是此弃用的方法。
StringSize(NSString, UIFont)	开发人员应使用 GetSizeUsingAttributes(NSString, UIStringAttributes) 而不是这种已弃用的方法。
StringSize(NSString, UIFont, CGSize)	如果用 font 或 constrainedToSize呈现，则字符串的计算大小，以较小者为准。
StringSize(NSString, UIFont, CGSize, UILineBreakMode)	CGSize获取显示此 NSString所需的 。
StringSize(NSString, UIFont, nfloat, nfloat, nfloat, UILineBreakMode)	CGSize获取显示此 NSString所需的 。
StringSize(NSString, UIFont, nfloat, UILineBreakMode)	CGSize获取显示此 NSString所需的 。

另请参阅

• NSExtendedStringDrawing
• NSStringDrawing
• Apple 文档 NSString