NSString 類別

定義

命名空間:

Foundation

組件:

Xamarin.iOS.dll

Foundation String 類別。

[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# 字串手動建立 NSStrings 時，封送處理的成本會高於讓執行時間封送處理它。

在某些情況下，您將處理 MonoTouch 中的 NSString 物件。 這些是使用 NSString 做為控制碼或權杖的情況。 這表示基礎平臺程式碼使用 NSString 的位址做為特殊控制碼， (程式碼不會依內容來比較字串，但由位址) 。 在這些情況下，NSString 已在 MonoTouch 系結中呈現。 您通常會發現這些常數為通知常數或索引鍵常數。

C# 程式碼中 NSStrings 的另一個用法是當您想要使用 NSStrings 中公開的一些當地語系化 API，而該 API 會直接對應至基礎平臺當地語系化資料表。

與 Objective-C 交互操作的程式碼會自動將內部 C# 字串轉換成 NSString。 雖然執行時間也支援以 NSStrings 的形式封送處理 .NET 字串，但有時候會執行字串的複本，但執行時間也支援以零複製封送處理方式

建構函式

NSString()	預設建構函式，這個建構函式會初始化這個類別的新實例，不含任何參數。
NSString(IntPtr)	建立 Unmanaged 物件的 Managed 標記法時所使用的建構函式;由執行時間呼叫。
NSString(NSCoder)	從儲存在 unarchiver 物件中的資料初始化 物件的建構函式。
NSString(NSData, NSStringEncoding)	使用特定編碼，從指定的資料 Blob 建立字串。
NSString(NSObjectFlag)	在衍生類別上呼叫的建構函式，以略過初始化，並只配置 物件。
NSString(String)	從 C# 字串建立 NSString。
NSString(String, Int32, Int32)	Foundation String 類別。

欄位

Empty

Foundation String 類別。

屬性

Class	Foundation String 類別。 (繼承來源 NSObject)
ClassHandle	這個類別的控制碼。
DebugDescription	此物件的開發人員有意義描述。 (繼承來源 NSObject)
Description	物件的描述，ToString 的 Objective-C 版本。 (繼承來源 NSObject)
Handle	處理 unmanaged 物件標記法) (指標。 (繼承來源 NSObject)
IsAbsolutePath	這是否為絕對路徑。
IsDirectBinding	Foundation String 類別。 (繼承來源 NSObject)
IsProxy	Foundation String 類別。 (繼承來源 NSObject)
Item[nint]	Foundation String 類別。
LastPathComponent	這個字串的最後一個路徑元件。
Length	此字串中的 Unicode 字元數目。
LocalizedCapitalizedString	Foundation String 類別。
LocalizedLowercaseString	Foundation String 類別。
LocalizedUppercaseString	Foundation String 類別。
PathComponents	字串陣列，包含此字串的每個路徑元件的順序。
PathExtension	如果字串有路徑延伸，則傳回此字串的路徑延伸模組。
ReadableTypeIdentifiers	Foundation String 類別。
RetainCount	傳回物件的目前 Objective-C 保留計數。 (繼承來源 NSObject)
Self	Foundation String 類別。 (繼承來源 NSObject)
Superclass	Foundation String 類別。 (繼承來源 NSObject)
SuperHandle	用來表示這個 NSObject 基類中方法的控制碼。 (繼承來源 NSObject)
WritableTypeIdentifiers	Foundation String 類別。
WritableTypeIdentifiersForItemProvider	Foundation String 類別。
Zone	Foundation String 類別。 (繼承來源 NSObject)

方法

AbbreviateTildeInPath()	藉由取代路徑相關部分的波浪線，將 spath 轉換為主目錄相對路徑。
AddObserver(NSObject, NSString, NSKeyValueObservingOptions, IntPtr)	使用 NSString keyPath) ，註冊物件以供外部 (觀察。   觀察到的變更會分派至觀察者的 物件 ObserveValue(NSString, NSObject, NSDictionary, IntPtr) 方法。 (繼承來源 NSObject)
AddObserver(NSObject, String, NSKeyValueObservingOptions, IntPtr)	使用字串 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 檔案載入物件之後呼叫。 覆寫程式必須呼叫基底。AwakeFromNib () 。 (繼承來源 NSObject)
BeginInvokeOnMainThread(Action)	Foundation String 類別。 (繼承來源 NSObject)
BeginInvokeOnMainThread(Selector, NSObject)	在主要 UI 執行緒上以非同步方式叫用指定的程式碼。 (繼承來源 NSObject)
Bind(NSString, NSObject, String, NSDictionary)	Foundation String 類別。 (繼承來源 NSObject)
Bind(String, NSObject, String, NSDictionary)	Foundation String 類別。 (繼承來源 NSObject)
BindingInfo(String)	Foundation String 類別。 (繼承來源 NSObject)
BindingOptionDescriptions(String)	Foundation String 類別。 (繼承來源 NSObject)
BindingValueClass(String)	Foundation String 類別。 (繼承來源 NSObject)
Capitalize(NSLocale)	使用指定地區設定的規則，將字串大寫。
CommitEditing()	Foundation String 類別。 (繼承來源 NSObject)
CommitEditing(NSObject, Selector, IntPtr)	Foundation String 類別。 (繼承來源 NSObject)
CommonPrefix(NSString, NSStringCompareOptions)	Foundation String 類別。
Compare(NSString)	語彙方式會將這個 與指定的字串進行比較。
Compare(NSString, NSStringCompareOptions)	Foundation String 類別。
Compare(NSString, NSStringCompareOptions, NSRange)	Foundation String 類別。
Compare(NSString, NSStringCompareOptions, NSRange, NSLocale)	Foundation String 類別。
ConformsToProtocol(IntPtr)	叫用以判斷這個物件是否實作指定的通訊協定。 (繼承來源 NSObject)
Contains(NSString)	Foundation String 類別。
Copy()	執行基礎 Objective-C 物件的複本。 (繼承來源 NSObject)
Copy(NSZone)	執行基礎 Objective-C 物件的複本。
CreateNative(String)	從 C# 字串建立 Objective-C NSString，並傳回其指標。
CreateNative(String, Boolean)	Foundation String 類別。
CreateNative(String, Int32, Int32)	Foundation String 類別。
CreateNative(String, Int32, Int32, Boolean)	Foundation String 類別。
DangerousAutorelease()	Foundation String 類別。 (繼承來源 NSObject)
DangerousRelease()	Foundation String 類別。 (繼承來源 NSObject)
DangerousRetain()	Foundation String 類別。 (繼承來源 NSObject)
DeleteLastPathComponent()	刪除此字串的最後一個路徑元件，以傳回新的字串。
DeletePathExtension()	從這個字串刪除路徑延伸，以傳回新的字串。
DetectStringEncoding(NSData, EncodingDetectionOptions, String, Boolean)	Foundation String 類別。
DetectStringEncoding(NSData, NSDictionary, String, Boolean)	Foundation String 類別。
DidChange(NSKeyValueChange, NSIndexSet, NSString)	表示對多關聯性的索引發生變更。 (繼承來源 NSObject)
DidChange(NSString, NSKeyValueSetMutationKind, NSSet)	Foundation String 類別。 (繼承來源 NSObject)
DidChangeValue(String)	表示在指定的索引鍵上發生變更。 (繼承來源 NSObject)
Dispose()	釋放 NSObject 物件所使用的資源。 (繼承來源 NSObject)
Dispose(Boolean)	釋放 NSObject 物件所使用的資源。 (繼承來源 NSObject)
DoesNotRecognizeSelector(Selector)	表示這個物件無法辨識指定的選取器。 (繼承來源 NSObject)
Encode(NSStringEncoding, Boolean)	Foundation String 類別。
EncodeTo(NSCoder)	編碼所提供編碼器上物件的狀態
Equals(NSObject)	Foundation String 類別。 (繼承來源 NSObject)
Equals(NSString, NSString)	Foundation String 類別。
Equals(Object)	Foundation String 類別。
ExpandTildeInPath()	傳回新的字串，此字串會展開此字串中的圖格 (指出使用者的主 dir) 為完整路徑。
ExposedBindings()	Foundation String 類別。 (繼承來源 NSObject)
FromData(NSData, NSStringEncoding)	從 NSData 來源建立 NSString。
FromHandle(IntPtr)	公用程式方法，從指向 Objective-C NSString 物件的指標傳回字串。
GetBindingInfo(NSString)	Foundation String 類別。 (繼承來源 NSObject)
GetBindingOptionDescriptions(NSString)	Foundation String 類別。 (繼承來源 NSObject)
GetBindingValueClass(NSString)	Foundation String 類別。 (繼承來源 NSObject)
GetDictionaryOfValuesFromKeys(NSString[])	擷取指定索引鍵的值。 (繼承來源 NSObject)
GetHashCode()	產生目前實例的雜湊碼。
GetItemProviderVisibilityForTypeIdentifier(String)	Foundation String 類別。
GetLineStart(nuint, nuint, nuint, NSRange)	Foundation String 類別。
GetLocalizedUserNotificationString(NSString, NSObject[])	Foundation String 類別。
GetLocalizedUserNotificationString(String, NSObject[])	已淘汰. Foundation String 類別。
GetMethodForSelector(Selector)	Foundation String 類別。 (繼承來源 NSObject)
GetNativeField(String)	已淘汰. Foundation String 類別。 (繼承來源 NSObject)
GetNativeHash()	Foundation String 類別。 (繼承來源 NSObject)
GetObject(NSData, String, NSError)	Foundation String 類別。
GetParagraphPositions(nuint, nuint, nuint, NSRange)	Foundation String 類別。
GetParagraphRange(NSRange)	Foundation String 類別。
GetVariantFittingPresentationWidth(nint)	Foundation String 類別。
HasPrefix(NSString)	Foundation String 類別。
HasSuffix(NSString)	Foundation String 類別。
Init()	Foundation String 類別。 (繼承來源 NSObject)
InitializeHandle(IntPtr)	Foundation String 類別。 (繼承來源 NSObject)
InitializeHandle(IntPtr, String)	Foundation String 類別。 (繼承來源 NSObject)
Invoke(Action, Double)	Foundation String 類別。 (繼承來源 NSObject)
Invoke(Action, TimeSpan)	Foundation String 類別。 (繼承來源 NSObject)
InvokeOnMainThread(Action)	Foundation String 類別。 (繼承來源 NSObject)
InvokeOnMainThread(Selector, NSObject)	在主要 UI 執行緒上，以同步方式叫用指定的程式碼。 (繼承來源 NSObject)
IsEqual(NSObject)	Foundation String 類別。 (繼承來源 NSObject)
IsEqualTo(IntPtr)	Foundation String 類別。
IsKindOfClass(Class)	Foundation String 類別。 (繼承來源 NSObject)
IsMemberOfClass(Class)	Foundation String 類別。 (繼承來源 NSObject)
LineRangeForRange(NSRange)	Foundation String 類別。
LoadData(String, Action<NSData,NSError>)	實作這個方法，以自訂 的 NSItemProvider 載入資料。
LoadDataAsync(String)	Foundation String 類別。
LoadDataAsync(String, NSProgress)	Foundation String 類別。
LocalizedCaseInsensitiveContains(NSString)	Foundation String 類別。
LocalizedFormat(NSString, NSObject[])	Foundation String 類別。
LocalizedFormat(NSString, Object[])	Foundation String 類別。
LocalizedFormat(String, Object[])	Foundation String 類別。
LocalizedStandardContainsString(NSString)	Foundation String 類別。
LocalizedStandardRangeOfString(NSString)	Foundation String 類別。
MarkDirty()	將一般對等物件升階 (IsDirectBinding 為 true) 為 toggleref 物件。 (繼承來源 NSObject)
MutableCopy()	建立指定之 NSObject 的可變動複本。 (繼承來源 NSObject)
MutableCopy(NSZone)	執行基礎 Objective-C 物件的複本。
ObjectDidEndEditing(NSObject)	Foundation String 類別。 (繼承來源 NSObject)
ObserveValue(NSString, NSObject, NSDictionary, IntPtr)	表示相對於這個物件的指定 keyPath 值已變更。 (繼承來源 NSObject)
PathWithComponents(String[])	從指定的元件陣列建構路徑。
PerformSelector(Selector)	Foundation String 類別。 (繼承來源 NSObject)
PerformSelector(Selector, NSObject)	Foundation String 類別。 (繼承來源 NSObject)
PerformSelector(Selector, NSObject, Double)	在目前的實例上叫用選取器，如果 obj 不是 null，它會將這個 當做其單一參數傳遞。 (繼承來源 NSObject)
PerformSelector(Selector, NSObject, Double, NSString[])	Foundation String 類別。 (繼承來源 NSObject)
PerformSelector(Selector, NSObject, NSObject)	Foundation String 類別。 (繼承來源 NSObject)
PerformSelector(Selector, NSThread, NSObject, Boolean)	Foundation String 類別。 (繼承來源 NSObject)
PerformSelector(Selector, NSThread, NSObject, Boolean, NSString[])	Foundation String 類別。 (繼承來源 NSObject)
PrepareForInterfaceBuilder()	Foundation String 類別。 (繼承來源 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)	Foundation String 類別。
SeparateComponents(NSString)	Foundation String 類別。
SetNativeField(String, NSObject)	已淘汰. Foundation String 類別。 (繼承來源 NSObject)
SetNilValueForKey(NSString)	將指定索引鍵的值設定為 null。 (繼承來源 NSObject)
SetValueForKey(NSObject, NSString)	將索引鍵所指定的屬性值設定為指定的值。 (繼承來源 NSObject)
SetValueForKeyPath(IntPtr, NSString)	建立 Unmanaged 物件的 Managed 標記法時所使用的建構函式;由執行時間呼叫。 (繼承來源 NSObject)
SetValueForKeyPath(NSObject, NSString)	設定可以使用索引鍵路徑到達的屬性值。 (繼承來源 NSObject)
SetValueForUndefinedKey(NSObject, NSString)	表示嘗試將值寫入未定義的索引鍵。 如果未覆寫，則會引發 NSUndefinedKeyException。 (繼承來源 NSObject)
SetValuesForKeysWithDictionary(NSDictionary)	將這個 NSObject 的值設定為指定字典中的值。 (繼承來源 NSObject)
StandarizePath()	藉由移除 「/./」 和類似的建構，將此字串標準化為路徑。
ToLower(NSLocale)	根據指定地區設定的規則，傳回此字串小寫版本的新字串。
ToString()	傳回目前實例值的字串表示。
ToUpper(NSLocale)	根據指定地區設定的規則，傳回這個字串的大小寫版本的新字串。
TransliterateString(NSString, Boolean)	Foundation String 類別。
TransliterateString(NSStringTransform, Boolean)	Foundation String 類別。
Unbind(NSString)	Foundation String 類別。 (繼承來源 NSObject)
Unbind(String)	Foundation String 類別。 (繼承來源 NSObject)
ValueForKey(NSString)	傳回與指定索引鍵相關聯的屬性值。 (繼承來源 NSObject)
ValueForKeyPath(NSString)	傳回可以使用索引鍵路徑到達的屬性值。 (繼承來源 NSObject)
ValueForUndefinedKey(NSString)	表示嘗試讀取未定義索引鍵的值。 如果未覆寫，則會引發 NSUndefinedKeyException。 (繼承來源 NSObject)
WillChange(NSKeyValueChange, NSIndexSet, NSString)	表示指定索引鍵中指定索引的值即將變更。 (繼承來源 NSObject)
WillChange(NSString, NSKeyValueSetMutationKind, NSSet)	Foundation String 類別。 (繼承來源 NSObject)
WillChangeValue(String)	表示指定的索引鍵值即將變更。 (繼承來源 NSObject)

運算子

Equality(NSString, NSString)	Foundation String 類別。
Explicit(String to NSString)	Foundation String 類別。
Implicit(NSString to String)	將 NSString 轉換為 CIL/C# 字串。
Inequality(NSString, NSString)	Foundation String 類別。

擴充方法

GetItemProviderVisibilityForTypeIdentifier(INSItemProviderWriting, String)	Foundation String 類別。
GetWritableTypeIdentifiersForItemProvider(INSItemProviderWriting)	Foundation String 類別。
LoadDataAsync(INSItemProviderWriting, String)	Foundation String 類別。
LoadDataAsync(INSItemProviderWriting, String, NSProgress)	Foundation String 類別。
EnumerateLinguisticTags(NSString, NSRange, NSLinguisticTagScheme, NSLinguisticTaggerOptions, NSOrthography, NSEnumerateLinguisticTagsEnumerator)	Foundation String 類別。
EnumerateLinguisticTags(NSString, NSRange, NSString, NSLinguisticTaggerOptions, NSOrthography, NSEnumerateLinguisticTagsEnumerator)	Foundation String 類別。
GetLinguisticTags(NSString, NSRange, NSLinguisticTagScheme, NSLinguisticTaggerOptions, NSOrthography, NSValue[])	Foundation String 類別。
GetLinguisticTags(NSString, NSRange, NSString, NSLinguisticTaggerOptions, NSOrthography, NSValue[])	Foundation String 類別。
GetDebugDescription(INSObjectProtocol)	Foundation String 類別。
CreateStringByAddingPercentEncoding(NSString, NSCharacterSet)	Foundation String 類別。
CreateStringByAddingPercentEscapes(NSString, NSStringEncoding)	Foundation String 類別。
CreateStringByRemovingPercentEncoding(NSString)	Foundation String 類別。
CreateStringByReplacingPercentEscapes(NSString, NSStringEncoding)	Foundation String 類別。
DrawString(NSString, CGRect, NSStringDrawingOptions, UIStringAttributes, NSStringDrawingContext)	Foundation String 類別。
GetBoundingRect(NSString, CGSize, NSStringDrawingOptions, UIStringAttributes, NSStringDrawingContext)	Foundation String 類別。
WeakDrawString(NSString, CGRect, NSStringDrawingOptions, NSDictionary, NSStringDrawingContext)	Foundation String 類別。
WeakGetBoundingRect(NSString, CGSize, NSStringDrawingOptions, NSDictionary, NSStringDrawingContext)	Foundation String 類別。
GetAccessibilityCustomRotors(NSObject)	取得適用于 this 物件的陣列 UIAccessibilityCustomRotor 。
SetAccessibilityCustomRotors(NSObject, UIAccessibilityCustomRotor[])	設定適用于 this 物件的陣列 UIAccessibilityCustomRotor 。
DrawString(NSString, CGPoint, UIStringAttributes)	Foundation String 類別。
DrawString(NSString, CGRect, UIStringAttributes)	Foundation String 類別。
GetSizeUsingAttributes(NSString, UIStringAttributes)	如果以指定的 attributes 呈現，則為字串的 SizeF。
WeakDrawString(NSString, CGPoint, NSDictionary)	Foundation String 類別。
WeakDrawString(NSString, CGRect, NSDictionary)	Foundation String 類別。
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