NSNotificationCenter Kelas

Definisi

Ruang nama:

Foundation

Rakitan:

Xamarin.iOS.dll

Hub pemberitahuan untuk aplikasi.

[Foundation.Register("NSNotificationCenter", true)]
public class NSNotificationCenter : Foundation.NSObject

type NSNotificationCenter = class
    inherit NSObject

Warisan

Object

NSObject

NSNotificationCenter

Turunan

Atribut

RegisterAttribute

Keterangan

NSNotificationCenter adalah hub yang digunakan untuk mendengarkan pesan siaran dan memposting pesan siaran dalam aplikasi. Pesan yang diposting sinkron.

NSNotificationCenter.DefaultCenter memainkan peran terpusat dalam aplikasi karena di sinilah pemberitahuan sistem diposting untuk peristiwa tingkat sistem yang menarik.

Memposting pemberitahuan adalah proses sinkron, yang berarti bahwa memanggil salah satu pesan Posting di pusat pemberitahuan akan memblokir eksekusi hingga semua penangan pemberitahuan selesai berjalan.

Pemberitahuan diposting pada utas yang sama dengan utas panggilan yang dapat memiliki efek yang tidak diinginkan. Jika Anda perlu mengirimkan pemberitahuan dari utas latar belakang, gunakan BeginInvokeOnMainThread(Action) metode untuk membungkus posting Anda ke delegasi yang dipanggil pada utas utama.

Saat berlangganan pemberitahuan, dimungkinkan untuk berlangganan hanya ke jenis pemberitahuan tertentu dengan menentukan nama pemberitahuan (atau null untuk mendengarkan semua pemberitahuan yang diposting ke pusat pemberitahuan). Dimungkinkan juga untuk berlangganan hanya ke pemberitahuan yang dikeluarkan oleh objek tertentu. Ini dapat digunakan untuk memfilter jumlah pemberitahuan yang diterima.

Pemberitahuan biasanya adalah bidang NSString yang dihosting di beberapa kelas, misalnya Objective-C UITextViewTextDidChangeNotification ditemukan di kelas UITextView sebagai TextDidChangeNotification. Untuk kenyamanan, ada kelebihan beban yang mengambil string C#.

Untuk mendaftar pemberitahuan, Anda dapat menggunakan metode AddObserver. Kami menyarankan agar Anda menggunakan versi C# dari metode ini, karena Anda dapat langsung menghubungkan delegasi, lambda, dan metode langsung ke dalam kode Anda. Saat Anda menggunakan salah satu metode AddObserver di kelas ini yang mengambil tindakan<NSNotification;> parameter, AddObserver akan mengembalikan token. Token ini kemudian digunakan sebagai parameter untuk RemoveNotification saat Anda ingin berhenti mendengarkan peristiwa tertentu.

NSObject notificationToken;

void Setup ()
{
	notificationToken = NSNotificationCenter.DefaultCenter.AddObserver (FooBar.ClockNotification, OnClockChange);
}

void OnClockChange (NSNotification notification)
{
	Console.WriteLine ("The ClockNotification message was posted");
}

void Teardown ()
{
	NSNotificationCenter.DefaultCenter.RemoveObserver (notificationToken);
}

Dimulai dengan MonoTouch 5.4, memanggil Buang pada token pemberitahuan yang dikembalikan juga akan menghapus pengamat untuk Anda, membuat kode lebih pendek. Contohnya:

NSObject notificationToken;

void Setup ()
{
	notificationToken = NSNotificationCenter.DefaultCenter.AddObserver (FooBar.ClockNotification, OnClockChange);
}

void OnClockChange (NSNotification notification)
{
	Console.WriteLine ("The ClockNotification message was posted");
}

void Teardown ()
{
	notificationToken.Dispose ();
}

Demikian pula, jika objek Anda mengimplementasikan T:System.IDisposable (termasuk objek apa pun yang berasal dari NSObject) yang HARUS Anda panggil RemoveObservers(IEnumerable<NSObject>) atau notificationToken.Dispose() dalam fungsi Anda Dispose :

class MyClass : NSObject
{
      private NSObject notificationToken; 

      MyClass()
      { 
         notificationToken = NSNotificationCenter.DefaultCenter.AddObserver(notificationName, NotificationHandler);
      }

      void NotificationHandler(NSNotification notification)
      {
         // ... etc ...
      }

      private bool disposed = false;
      override protected void Dispose(bool disposing)
      {
         if (!disposed)
         {
               if (disposing)
               {
                  notificationToken.Dispose();
               }
               disposed = true;
               base.Dispose();
         }
      }
}

Konstruktor

NSNotificationCenter()	Konstruktor default yang menginisialisasi instans baru kelas ini tanpa parameter.
NSNotificationCenter(IntPtr)	Konstruktor yang digunakan saat membuat representasi terkelola dari objek yang tidak dikelola; Dipanggil oleh runtime.
NSNotificationCenter(NSObjectFlag)	Konstruktor untuk memanggil kelas turunan untuk melewati inisialisasi dan hanya mengalokasikan objek.

Properti

Class	Hub pemberitahuan untuk aplikasi. (Diperoleh dari NSObject)
ClassHandle	Handel untuk kelas ini.
DebugDescription	Deskripsi yang bermakna pengembang dari objek ini. (Diperoleh dari NSObject)
DefaultCenter	Pusat pemberitahuan default, pemberitahuan sistem, dan peristiwa tingkat sistem diposting ke pusat pemberitahuan ini.
Description	Deskripsi objek, ToString versi Objective-C. (Diperoleh dari NSObject)
Handle	Tangani (penunjuk) ke representasi objek yang tidak dikelola. (Diperoleh dari NSObject)
IsDirectBinding	Hub pemberitahuan untuk aplikasi. (Diperoleh dari NSObject)
IsProxy	Hub pemberitahuan untuk aplikasi. (Diperoleh dari NSObject)
RetainCount	Mengembalikan jumlah penyimpanan Objective-C saat ini untuk objek. (Diperoleh dari NSObject)
Self	Hub pemberitahuan untuk aplikasi. (Diperoleh dari NSObject)
Superclass	Hub pemberitahuan untuk aplikasi. (Diperoleh dari NSObject)
SuperHandle	Handel yang digunakan untuk mewakili metode di kelas dasar untuk NSObject ini. (Diperoleh dari NSObject)
Zone	Hub pemberitahuan untuk aplikasi. (Diperoleh dari NSObject)

Metode

AddObserver(NSObject, NSString, NSKeyValueObservingOptions, IntPtr)	Mendaftarkan objek untuk diamati secara eksternal (menggunakan NSString keyPath).   Perubahan yang diamati dikirim ke metode objek ObserveValue(NSString, NSObject, NSDictionary, IntPtr) pengamat. (Diperoleh dari NSObject)
AddObserver(NSObject, Selector, NSString, NSObject)	API add-observer tingkat rendah
AddObserver(NSObject, String, NSKeyValueObservingOptions, IntPtr)	Mendaftarkan objek untuk diamati secara eksternal (menggunakan string keyPath).   Perubahan yang diamati dikirim ke metode objek ObserveValue(NSString, NSObject, NSDictionary, IntPtr) pengamat. (Diperoleh dari NSObject)
AddObserver(NSString, Action<NSNotification>)	Menambahkan pengamat untuk pemberitahuan yang ditentukan
AddObserver(NSString, Action<NSNotification>, NSObject)	Menambahkan pengamat untuk pemberitahuan yang ditentukan
AddObserver(NSString, NSKeyValueObservingOptions, Action<NSObservedChange>)	Mendaftarkan objek untuk diamati secara eksternal menggunakan metode arbitrer. (Diperoleh dari NSObject)
AddObserver(String, NSKeyValueObservingOptions, Action<NSObservedChange>)	Mendaftarkan objek untuk diamati secara eksternal menggunakan metode arbitrer. (Diperoleh dari NSObject)
AddObserver(String, NSObject, NSOperationQueue, Action<NSNotification>)	Hub pemberitahuan untuk aplikasi.
AwakeFromNib()	Dipanggil setelah objek dimuat dari file nib. Penimpa harus memanggil basis. AwakeFromNib(). (Diperoleh dari NSObject)
BeginInvokeOnMainThread(Action)	Hub pemberitahuan untuk aplikasi. (Diperoleh dari NSObject)
BeginInvokeOnMainThread(Selector, NSObject)	Memanggil secara asinkron kode yang ditentukan pada utas UI utama. (Diperoleh dari NSObject)
Bind(NSString, NSObject, String, NSDictionary)	Hub pemberitahuan untuk aplikasi. (Diperoleh dari NSObject)
Bind(String, NSObject, String, NSDictionary)	Hub pemberitahuan untuk aplikasi. (Diperoleh dari NSObject)
BindingInfo(String)	Hub pemberitahuan untuk aplikasi. (Diperoleh dari NSObject)
BindingOptionDescriptions(String)	Hub pemberitahuan untuk aplikasi. (Diperoleh dari NSObject)
BindingValueClass(String)	Hub pemberitahuan untuk aplikasi. (Diperoleh dari NSObject)
CommitEditing()	Hub pemberitahuan untuk aplikasi. (Diperoleh dari NSObject)
CommitEditing(NSObject, Selector, IntPtr)	Hub pemberitahuan untuk aplikasi. (Diperoleh dari NSObject)
ConformsToProtocol(IntPtr)	Dipanggil untuk menentukan apakah objek ini menerapkan protokol yang ditentukan. (Diperoleh dari NSObject)
Copy()	Melakukan salinan objek Objective-C yang mendasar. (Diperoleh dari NSObject)
DangerousAutorelease()	Hub pemberitahuan untuk aplikasi. (Diperoleh dari NSObject)
DangerousRelease()	Hub pemberitahuan untuk aplikasi. (Diperoleh dari NSObject)
DangerousRetain()	Hub pemberitahuan untuk aplikasi. (Diperoleh dari NSObject)
DidChange(NSKeyValueChange, NSIndexSet, NSString)	Menunjukkan perubahan yang terjadi pada indeks untuk hubungan ke banyak. (Diperoleh dari NSObject)
DidChange(NSString, NSKeyValueSetMutationKind, NSSet)	Hub pemberitahuan untuk aplikasi. (Diperoleh dari NSObject)
DidChangeValue(String)	Menunjukkan bahwa perubahan terjadi pada kunci yang ditentukan. (Diperoleh dari NSObject)
Dispose()	Merilis sumber daya yang digunakan oleh objek NSObject. (Diperoleh dari NSObject)
Dispose(Boolean)	Merilis sumber daya yang digunakan oleh objek NSObject. (Diperoleh dari NSObject)
DoesNotRecognizeSelector(Selector)	Menunjukkan bahwa objek ini tidak mengenali pemilih yang ditentukan. (Diperoleh dari NSObject)
Equals(NSObject)	Hub pemberitahuan untuk aplikasi. (Diperoleh dari NSObject)
Equals(Object)	Hub pemberitahuan untuk aplikasi. (Diperoleh dari NSObject)
ExposedBindings()	Hub pemberitahuan untuk aplikasi. (Diperoleh dari NSObject)
GetBindingInfo(NSString)	Hub pemberitahuan untuk aplikasi. (Diperoleh dari NSObject)
GetBindingOptionDescriptions(NSString)	Hub pemberitahuan untuk aplikasi. (Diperoleh dari NSObject)
GetBindingValueClass(NSString)	Hub pemberitahuan untuk aplikasi. (Diperoleh dari NSObject)
GetDictionaryOfValuesFromKeys(NSString[])	Mengambil nilai kunci yang ditentukan. (Diperoleh dari NSObject)
GetHashCode()	Menghasilkan kode hash untuk instans saat ini. (Diperoleh dari NSObject)
GetMethodForSelector(Selector)	Hub pemberitahuan untuk aplikasi. (Diperoleh dari NSObject)
GetNativeField(String)	Kedaluwarsa. Hub pemberitahuan untuk aplikasi. (Diperoleh dari NSObject)
GetNativeHash()	Hub pemberitahuan untuk aplikasi. (Diperoleh dari NSObject)
Init()	Hub pemberitahuan untuk aplikasi. (Diperoleh dari NSObject)
InitializeHandle(IntPtr)	Hub pemberitahuan untuk aplikasi. (Diperoleh dari NSObject)
InitializeHandle(IntPtr, String)	Hub pemberitahuan untuk aplikasi. (Diperoleh dari NSObject)
Invoke(Action, Double)	Hub pemberitahuan untuk aplikasi. (Diperoleh dari NSObject)
Invoke(Action, TimeSpan)	Hub pemberitahuan untuk aplikasi. (Diperoleh dari NSObject)
InvokeOnMainThread(Action)	Hub pemberitahuan untuk aplikasi. (Diperoleh dari NSObject)
InvokeOnMainThread(Selector, NSObject)	Memanggil kode yang ditentukan secara sinkron pada utas UI utama. (Diperoleh dari NSObject)
IsEqual(NSObject)	Hub pemberitahuan untuk aplikasi. (Diperoleh dari NSObject)
IsKindOfClass(Class)	Hub pemberitahuan untuk aplikasi. (Diperoleh dari NSObject)
IsMemberOfClass(Class)	Hub pemberitahuan untuk aplikasi. (Diperoleh dari NSObject)
MarkDirty()	Mempromosikan objek peer biasa (IsDirectBinding adalah true) ke dalam objek toggleref. (Diperoleh dari NSObject)
MutableCopy()	Membuat salinan yang dapat diubah dari NSObject yang ditentukan. (Diperoleh dari NSObject)
ObjectDidEndEditing(NSObject)	Hub pemberitahuan untuk aplikasi. (Diperoleh dari NSObject)
ObserveValue(NSString, NSObject, NSDictionary, IntPtr)	Menunjukkan bahwa nilai pada keyPath yang ditentukan relatif terhadap objek ini telah berubah. (Diperoleh dari NSObject)
PerformSelector(Selector)	Hub pemberitahuan untuk aplikasi. (Diperoleh dari NSObject)
PerformSelector(Selector, NSObject)	Hub pemberitahuan untuk aplikasi. (Diperoleh dari NSObject)
PerformSelector(Selector, NSObject, Double)	Memanggil pemilih pada instans saat ini dan jika obj tidak null, pemilih meneruskan ini sebagai parameter tunggalnya. (Diperoleh dari NSObject)
PerformSelector(Selector, NSObject, Double, NSString[])	Hub pemberitahuan untuk aplikasi. (Diperoleh dari NSObject)
PerformSelector(Selector, NSObject, NSObject)	Hub pemberitahuan untuk aplikasi. (Diperoleh dari NSObject)
PerformSelector(Selector, NSThread, NSObject, Boolean)	Hub pemberitahuan untuk aplikasi. (Diperoleh dari NSObject)
PerformSelector(Selector, NSThread, NSObject, Boolean, NSString[])	Hub pemberitahuan untuk aplikasi. (Diperoleh dari NSObject)
PostNotification(NSNotification)	Memposting pemberitahuan yang disiarkan ke semua orang yang berlangganan pemberitahuan tersebut.
PostNotificationName(String, NSObject)	Hub pemberitahuan untuk aplikasi.
PostNotificationName(String, NSObject, NSDictionary)	Hub pemberitahuan untuk aplikasi.
PrepareForInterfaceBuilder()	Hub pemberitahuan untuk aplikasi. (Diperoleh dari NSObject)
RemoveObserver(NSObject)	Hub pemberitahuan untuk aplikasi.
RemoveObserver(NSObject, NSString)	Menghentikan pengamat yang ditentukan menerima pemberitahuan lebih lanjut tentang nilai yang diubah untuk keyPath yang ditentukan. (Diperoleh dari NSObject)
RemoveObserver(NSObject, NSString, IntPtr)	Menghentikan pengamat yang ditentukan menerima pemberitahuan lebih lanjut tentang nilai yang diubah untuk keyPath dan konteks yang ditentukan. (Diperoleh dari NSObject)
RemoveObserver(NSObject, String)	Menghentikan pengamat yang ditentukan menerima pemberitahuan lebih lanjut tentang nilai yang diubah untuk keyPath yang ditentukan. (Diperoleh dari NSObject)
RemoveObserver(NSObject, String, IntPtr)	Menghentikan pengamat yang ditentukan menerima pemberitahuan lebih lanjut tentang nilai yang diubah untuk keyPath dan konteks yang ditentukan. (Diperoleh dari NSObject)
RemoveObserver(NSObject, String, NSObject)	Hub pemberitahuan untuk aplikasi.
RemoveObservers(IEnumerable<NSObject>)	Menghapus beberapa pengamat dalam satu panggilan.
RespondsToSelector(Selector)	Apakah objek ini mengenali pemilih yang ditentukan. (Diperoleh dari NSObject)
SetNativeField(String, NSObject)	Kedaluwarsa. Hub pemberitahuan untuk aplikasi. (Diperoleh dari NSObject)
SetNilValueForKey(NSString)	Mengatur nilai kunci yang ditentukan ke null. (Diperoleh dari NSObject)
SetValueForKey(NSObject, NSString)	Mengatur nilai properti yang ditentukan oleh kunci ke nilai yang ditentukan. (Diperoleh dari NSObject)
SetValueForKeyPath(IntPtr, NSString)	Konstruktor yang digunakan saat membuat representasi terkelola dari objek yang tidak dikelola; Dipanggil oleh runtime. (Diperoleh dari NSObject)
SetValueForKeyPath(NSObject, NSString)	Mengatur nilai properti yang dapat dijangkau menggunakan keypath. (Diperoleh dari NSObject)
SetValueForUndefinedKey(NSObject, NSString)	Menunjukkan upaya untuk menulis nilai ke kunci yang tidak terdefinisi. Jika tidak ditimpa, menaikkan NSUndefinedKeyException. (Diperoleh dari NSObject)
SetValuesForKeysWithDictionary(NSDictionary)	Mengatur nilai NSObject ini ke nilai dalam kamus yang ditentukan. (Diperoleh dari NSObject)
ToString()	Mengembalikan representasi string dari nilai instans saat ini. (Diperoleh dari NSObject)
Unbind(NSString)	Hub pemberitahuan untuk aplikasi. (Diperoleh dari NSObject)
Unbind(String)	Hub pemberitahuan untuk aplikasi. (Diperoleh dari NSObject)
ValueForKey(NSString)	Mengembalikan nilai properti yang terkait dengan kunci yang ditentukan. (Diperoleh dari NSObject)
ValueForKeyPath(NSString)	Mengembalikan nilai properti yang dapat dicapai menggunakan keypath. (Diperoleh dari NSObject)
ValueForUndefinedKey(NSString)	Menunjukkan upaya untuk membaca nilai kunci yang tidak terdefinisi. Jika tidak ditimpa, menaikkan NSUndefinedKeyException. (Diperoleh dari NSObject)
WillChange(NSKeyValueChange, NSIndexSet, NSString)	Menunjukkan bahwa nilai indeks yang ditentukan dalam kunci yang ditentukan akan berubah. (Diperoleh dari NSObject)
WillChange(NSString, NSKeyValueSetMutationKind, NSSet)	Hub pemberitahuan untuk aplikasi. (Diperoleh dari NSObject)
WillChangeValue(String)	Menunjukkan bahwa nilai kunci yang ditentukan akan berubah. (Diperoleh dari NSObject)

Metode Ekstensi

GetDebugDescription(INSObjectProtocol)	Hub pemberitahuan untuk aplikasi.
GetAccessibilityCustomRotors(NSObject)	Mendapatkan array UIAccessibilityCustomRotor objek yang sesuai untuk this objek.
SetAccessibilityCustomRotors(NSObject, UIAccessibilityCustomRotor[])	Mengatur array UIAccessibilityCustomRotor objek yang sesuai untuk this objek.

Lihat juga

• AppPrefs
• monocatalog
• Dokumentasi Apple untuk NSNotificationCenter