NSNotificationCenter Klasse

Definition

Namespace:

Foundation

Assembly:

Xamarin.iOS.dll

Ein Notification Hub für die Anwendung.

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

type NSNotificationCenter = class
    inherit NSObject

Vererbung

Object

NSObject

NSNotificationCenter

Abgeleitet

Attribute

RegisterAttribute

Hinweise

Das NSNotificationCenter ist ein Hub, der zum Lauschen von Broadcastnachrichten und zum Posten von Broadcastnachrichten in einer Anwendung verwendet wird. Die Meldungen, die gepostet werden, sind synchron.

Das NSNotificationCenter.DefaultCenter spielt eine zentrale Rolle in der Anwendung, da hier Systembenachrichtigungen für interessante Ereignisse auf Systemebene veröffentlicht werden.

Das Posten einer Benachrichtigung ist ein synchroner Prozess, was bedeutet, dass das Aufrufen einer der Post-Nachrichten im Notification Center die Ausführung blockiert, bis alle Benachrichtigungshandler ausgeführt wurden.

Benachrichtigungen werden im selben Thread wie der aufrufende Thread gepostet, was unerwünschte Auswirkungen haben könnte. Wenn Sie Benachrichtigungen aus einem Hintergrundthread übermitteln müssen, verwenden Sie die BeginInvokeOnMainThread(Action) -Methode, um Ihre Veröffentlichung in einen Delegaten umzuschließen, der im Hauptthread aufgerufen wird.

Wenn Sie eine Benachrichtigung abonnieren, ist es möglich, nur eine bestimmte Art von Benachrichtigung zu abonnieren, indem Sie den Benachrichtigungsnamen angeben (oder NULL, um alle Benachrichtigungen zu lauschen, die an das Notification Center gesendet werden). Es ist auch möglich, nur Benachrichtigungen zu abonnieren, die von einem bestimmten Objekt ausgegeben wurden. Dies kann verwendet werden, um die Menge der empfangenen Benachrichtigungen zu filtern.

Benachrichtigungen sind in der Regel NSString-Felder, die in einer Klasse gehostet werden, z. B. die Objective-C UITextViewTextDidChangeNotification in der Klasse UITextView als TextDidChangeNotificationgefunden wird. Zur Vereinfachung gibt es Überladungen, die C#-Zeichenfolgen verwenden.

Um sich für Benachrichtigungen zu registrieren, können Sie die AddObserver-Methode verwenden. Es wird empfohlen, die C#-Versionen dieser Methoden zu verwenden, da Sie Delegaten, Lambdas und Methoden direkt mit Ihrem Code verbinden können. Wenn Sie eine der AddObserver-Methoden in dieser Klasse verwenden, die einen Action<NSNotification;-> Parameter ausführen, gibt addObserver ein Token zurück. Dieses Token wird dann als Parameter für RemoveNotification verwendet, wenn Sie die Überwachung eines bestimmten Ereignisses beenden möchten.

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

Ab MonoTouch 5.4 entfernt das Aufrufen von Dispose für das zurückgegebene Benachrichtigungstoken auch den Beobachter für Sie, wodurch der Code verkürzt wird. Beispiel:

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

Wenn Ihr Objekt implementiert (einschließlich aller von NSObjectabgeleiteten Objekte), MÜSSEN Sie oder notificationToken.Dispose() in Ihrer Dispose Funktion aufrufenRemoveObservers(IEnumerable<NSObject>):

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

Konstruktoren

NSNotificationCenter()	Standardkonstruktor, der eine neue Instanz dieser Klasse ohne Parameter initialisiert.
NSNotificationCenter(IntPtr)	Ein Konstruktor, der beim Erstellen verwalteter Darstellungen nicht verwalteter Objekte verwendet wird; Wird von der Runtime aufgerufen.
NSNotificationCenter(NSObjectFlag)	Konstruktor, um abgeleitete Klassen aufzurufen, um die Initialisierung zu überspringen und das Objekt nur zuzuweisen.

Eigenschaften

Class	Ein Notification Hub für die Anwendung. (Geerbt von NSObject)
ClassHandle	Das Handle für diese Klasse.
DebugDescription	Eine entwicklerrelevante Beschreibung dieses Objekts. (Geerbt von NSObject)
DefaultCenter	Das Standardbenachrichtigungscenter, Systembenachrichtigungen und Ereignisse auf Systemebene werden an dieses Benachrichtigungscenter gesendet.
Description	Beschreibung des Objekts, der Objective-C-Version von ToString. (Geerbt von NSObject)
Handle	Handle (Zeiger) auf die Darstellung des nicht verwalteten Objekts. (Geerbt von NSObject)
IsDirectBinding	Ein Notification Hub für die Anwendung. (Geerbt von NSObject)
IsProxy	Ein Notification Hub für die Anwendung. (Geerbt von NSObject)
RetainCount	Gibt die aktuelle Objective-C-Aufbewahrungsanzahl für das Objekt zurück. (Geerbt von NSObject)
Self	Ein Notification Hub für die Anwendung. (Geerbt von NSObject)
Superclass	Ein Notification Hub für die Anwendung. (Geerbt von NSObject)
SuperHandle	Handle, der verwendet wird, um die Methoden in der Basisklasse für dieses NSObject darzustellen. (Geerbt von NSObject)
Zone	Ein Notification Hub für die Anwendung. (Geerbt von NSObject)

Methoden

AddObserver(NSObject, NSString, NSKeyValueObservingOptions, IntPtr)	Registriert ein Objekt für die externe Beobachtung (mithilfe von NSString keyPath).   Beobachtete Änderungen werden an die Objektmethode ObserveValue(NSString, NSObject, NSDictionary, IntPtr) des Beobachters gesendet. (Geerbt von NSObject)
AddObserver(NSObject, Selector, NSString, NSObject)	Add-Observer-API auf niedriger Ebene
AddObserver(NSObject, String, NSKeyValueObservingOptions, IntPtr)	Registriert ein Objekt für die externe Beobachtung (mithilfe von string keyPath).   Beobachtete Änderungen werden an die Objektmethode ObserveValue(NSString, NSObject, NSDictionary, IntPtr) des Beobachters gesendet. (Geerbt von NSObject)
AddObserver(NSString, Action<NSNotification>)	Fügt einen Beobachter für die angegebene Benachrichtigung hinzu.
AddObserver(NSString, Action<NSNotification>, NSObject)	Fügt einen Beobachter für die angegebene Benachrichtigung hinzu.
AddObserver(NSString, NSKeyValueObservingOptions, Action<NSObservedChange>)	Registriert ein Objekt für die externe Beobachtung mithilfe einer beliebigen Methode. (Geerbt von NSObject)
AddObserver(String, NSKeyValueObservingOptions, Action<NSObservedChange>)	Registriert ein Objekt für die externe Beobachtung mithilfe einer beliebigen Methode. (Geerbt von NSObject)
AddObserver(String, NSObject, NSOperationQueue, Action<NSNotification>)	Ein Notification Hub für die Anwendung.
AwakeFromNib()	Wird aufgerufen, nachdem das Objekt aus der Nib-Datei geladen wurde. Überschreibungen müssen base aufrufen. AwakeFromNib(). (Geerbt von NSObject)
BeginInvokeOnMainThread(Action)	Ein Notification Hub für die Anwendung. (Geerbt von NSObject)
BeginInvokeOnMainThread(Selector, NSObject)	Ruft den angegebenen Code im Hauptthread der Benutzeroberfläche asynchron auf. (Geerbt von NSObject)
Bind(NSString, NSObject, String, NSDictionary)	Ein Notification Hub für die Anwendung. (Geerbt von NSObject)
Bind(String, NSObject, String, NSDictionary)	Ein Notification Hub für die Anwendung. (Geerbt von NSObject)
BindingInfo(String)	Ein Notification Hub für die Anwendung. (Geerbt von NSObject)
BindingOptionDescriptions(String)	Ein Notification Hub für die Anwendung. (Geerbt von NSObject)
BindingValueClass(String)	Ein Notification Hub für die Anwendung. (Geerbt von NSObject)
CommitEditing()	Ein Notification Hub für die Anwendung. (Geerbt von NSObject)
CommitEditing(NSObject, Selector, IntPtr)	Ein Notification Hub für die Anwendung. (Geerbt von NSObject)
ConformsToProtocol(IntPtr)	Wird aufgerufen, um zu bestimmen, ob dieses Objekt das angegebene Protokoll implementiert. (Geerbt von NSObject)
Copy()	Führt eine Kopie des zugrunde liegenden Objective-C-Objekts aus. (Geerbt von NSObject)
DangerousAutorelease()	Ein Notification Hub für die Anwendung. (Geerbt von NSObject)
DangerousRelease()	Ein Notification Hub für die Anwendung. (Geerbt von NSObject)
DangerousRetain()	Ein Notification Hub für die Anwendung. (Geerbt von NSObject)
DidChange(NSKeyValueChange, NSIndexSet, NSString)	Gibt eine Änderung an den Indizes für eine zu-viele-Beziehung an. (Geerbt von NSObject)
DidChange(NSString, NSKeyValueSetMutationKind, NSSet)	Ein Notification Hub für die Anwendung. (Geerbt von NSObject)
DidChangeValue(String)	Gibt an, dass eine Änderung am angegebenen Schlüssel aufgetreten ist. (Geerbt von NSObject)
Dispose()	Gibt die vom NSObject-Objekt verwendeten Ressourcen frei. (Geerbt von NSObject)
Dispose(Boolean)	Gibt die vom NSObject-Objekt verwendeten Ressourcen frei. (Geerbt von NSObject)
DoesNotRecognizeSelector(Selector)	Gibt an, dass dieses Objekt den angegebenen Selektor nicht erkennt. (Geerbt von NSObject)
Equals(NSObject)	Ein Notification Hub für die Anwendung. (Geerbt von NSObject)
Equals(Object)	Ein Notification Hub für die Anwendung. (Geerbt von NSObject)
ExposedBindings()	Ein Notification Hub für die Anwendung. (Geerbt von NSObject)
GetBindingInfo(NSString)	Ein Notification Hub für die Anwendung. (Geerbt von NSObject)
GetBindingOptionDescriptions(NSString)	Ein Notification Hub für die Anwendung. (Geerbt von NSObject)
GetBindingValueClass(NSString)	Ein Notification Hub für die Anwendung. (Geerbt von NSObject)
GetDictionaryOfValuesFromKeys(NSString[])	Ruft die Werte der angegebenen Schlüssel ab. (Geerbt von NSObject)
GetHashCode()	Generiert einen Hashcode für die aktuelle Instanz. (Geerbt von NSObject)
GetMethodForSelector(Selector)	Ein Notification Hub für die Anwendung. (Geerbt von NSObject)
GetNativeField(String)	Veraltet.. Ein Notification Hub für die Anwendung. (Geerbt von NSObject)
GetNativeHash()	Ein Notification Hub für die Anwendung. (Geerbt von NSObject)
Init()	Ein Notification Hub für die Anwendung. (Geerbt von NSObject)
InitializeHandle(IntPtr)	Ein Notification Hub für die Anwendung. (Geerbt von NSObject)
InitializeHandle(IntPtr, String)	Ein Notification Hub für die Anwendung. (Geerbt von NSObject)
Invoke(Action, Double)	Ein Notification Hub für die Anwendung. (Geerbt von NSObject)
Invoke(Action, TimeSpan)	Ein Notification Hub für die Anwendung. (Geerbt von NSObject)
InvokeOnMainThread(Action)	Ein Notification Hub für die Anwendung. (Geerbt von NSObject)
InvokeOnMainThread(Selector, NSObject)	Ruft den angegebenen Code im Hauptthread der Benutzeroberfläche synchron auf. (Geerbt von NSObject)
IsEqual(NSObject)	Ein Notification Hub für die Anwendung. (Geerbt von NSObject)
IsKindOfClass(Class)	Ein Notification Hub für die Anwendung. (Geerbt von NSObject)
IsMemberOfClass(Class)	Ein Notification Hub für die Anwendung. (Geerbt von NSObject)
MarkDirty()	Erhöht ein reguläres Peerobjekt (IsDirectBinding ist true) in ein toggleref-Objekt. (Geerbt von NSObject)
MutableCopy()	Erstellt eine veränderliche Kopie des angegebenen NSObject. (Geerbt von NSObject)
ObjectDidEndEditing(NSObject)	Ein Notification Hub für die Anwendung. (Geerbt von NSObject)
ObserveValue(NSString, NSObject, NSDictionary, IntPtr)	Gibt an, dass sich der Wert am angegebenen keyPath relativ zu diesem Objekt geändert hat. (Geerbt von NSObject)
PerformSelector(Selector)	Ein Notification Hub für die Anwendung. (Geerbt von NSObject)
PerformSelector(Selector, NSObject)	Ein Notification Hub für die Anwendung. (Geerbt von NSObject)
PerformSelector(Selector, NSObject, Double)	Ruft den Selektor für die aktuelle Instanz auf, und wenn der obj nicht NULL ist, übergibt er dies als seinen einzelnen Parameter. (Geerbt von NSObject)
PerformSelector(Selector, NSObject, Double, NSString[])	Ein Notification Hub für die Anwendung. (Geerbt von NSObject)
PerformSelector(Selector, NSObject, NSObject)	Ein Notification Hub für die Anwendung. (Geerbt von NSObject)
PerformSelector(Selector, NSThread, NSObject, Boolean)	Ein Notification Hub für die Anwendung. (Geerbt von NSObject)
PerformSelector(Selector, NSThread, NSObject, Boolean, NSString[])	Ein Notification Hub für die Anwendung. (Geerbt von NSObject)
PostNotification(NSNotification)	Sendet eine Benachrichtigung, die an alle gesendet wird, die diese Benachrichtigung abonnieren.
PostNotificationName(String, NSObject)	Ein Notification Hub für die Anwendung.
PostNotificationName(String, NSObject, NSDictionary)	Ein Notification Hub für die Anwendung.
PrepareForInterfaceBuilder()	Ein Notification Hub für die Anwendung. (Geerbt von NSObject)
RemoveObserver(NSObject)	Ein Notification Hub für die Anwendung.
RemoveObserver(NSObject, NSString)	Verhindert, dass der angegebene Beobachter weitere Benachrichtigungen über geänderte Werte für den angegebenen keyPath empfängt. (Geerbt von NSObject)
RemoveObserver(NSObject, NSString, IntPtr)	Verhindert, dass der angegebene Beobachter weitere Benachrichtigungen über geänderte Werte für den angegebenen keyPath und den angegebenen Kontext empfängt. (Geerbt von NSObject)
RemoveObserver(NSObject, String)	Verhindert, dass der angegebene Beobachter weitere Benachrichtigungen über geänderte Werte für den angegebenen keyPath empfängt. (Geerbt von NSObject)
RemoveObserver(NSObject, String, IntPtr)	Verhindert, dass der angegebene Beobachter weitere Benachrichtigungen über geänderte Werte für den angegebenen keyPath und den angegebenen Kontext empfängt. (Geerbt von NSObject)
RemoveObserver(NSObject, String, NSObject)	Ein Notification Hub für die Anwendung.
RemoveObservers(IEnumerable<NSObject>)	Entfernt mehrere Beobachter in einem Aufruf.
RespondsToSelector(Selector)	Gibt an, ob dieses Objekt den angegebenen Selektor erkennt. (Geerbt von NSObject)
SetNativeField(String, NSObject)	Veraltet.. Ein Notification Hub für die Anwendung. (Geerbt von NSObject)
SetNilValueForKey(NSString)	Legt den Wert des angegebenen Schlüssels auf NULL fest. (Geerbt von NSObject)
SetValueForKey(NSObject, NSString)	Legt den Wert der vom Schlüssel angegebenen Eigenschaft auf den angegebenen Wert fest. (Geerbt von NSObject)
SetValueForKeyPath(IntPtr, NSString)	Ein Konstruktor, der beim Erstellen verwalteter Darstellungen nicht verwalteter Objekte verwendet wird; Wird von der Runtime aufgerufen. (Geerbt von NSObject)
SetValueForKeyPath(NSObject, NSString)	Legt den Wert einer Eigenschaft fest, die mit einem Schlüsselpfad erreicht werden kann. (Geerbt von NSObject)
SetValueForUndefinedKey(NSObject, NSString)	Gibt einen Versuch an, einen Wert in einen nicht definierten Schlüssel zu schreiben. Wenn sie nicht überschrieben wird, wird eine NSUndefinedKeyException ausgelöst. (Geerbt von NSObject)
SetValuesForKeysWithDictionary(NSDictionary)	Legt die Werte dieses NSObject auf die Werte im angegebenen Wörterbuch fest. (Geerbt von NSObject)
ToString()	Gibt eine Zeichenfolgendarstellung des Werts der aktuellen Instanz zurück. (Geerbt von NSObject)
Unbind(NSString)	Ein Notification Hub für die Anwendung. (Geerbt von NSObject)
Unbind(String)	Ein Notification Hub für die Anwendung. (Geerbt von NSObject)
ValueForKey(NSString)	Gibt den Wert der Eigenschaft zurück, die dem angegebenen Schlüssel zugeordnet ist. (Geerbt von NSObject)
ValueForKeyPath(NSString)	Gibt den Wert einer Eigenschaft zurück, die mithilfe eines Schlüsselpfads erreicht werden kann. (Geerbt von NSObject)
ValueForUndefinedKey(NSString)	Gibt einen Versuch an, einen Wert eines nicht definierten Schlüssels zu lesen. Wenn sie nicht überschrieben wird, wird eine NSUndefinedKeyException ausgelöst. (Geerbt von NSObject)
WillChange(NSKeyValueChange, NSIndexSet, NSString)	Gibt an, dass sich die Werte der angegebenen Indizes im angegebenen Schlüssel ändern. (Geerbt von NSObject)
WillChange(NSString, NSKeyValueSetMutationKind, NSSet)	Ein Notification Hub für die Anwendung. (Geerbt von NSObject)
WillChangeValue(String)	Gibt an, dass sich der Wert des angegebenen Schlüssels ändern wird. (Geerbt von NSObject)

Erweiterungsmethoden

GetDebugDescription(INSObjectProtocol)	Ein Notification Hub für die Anwendung.
GetAccessibilityCustomRotors(NSObject)	Ruft das Array von Objekten ab, die UIAccessibilityCustomRotor für this das Objekt geeignet sind.
SetAccessibilityCustomRotors(NSObject, UIAccessibilityCustomRotor[])	Legt das Array von Objekten fest, die UIAccessibilityCustomRotor für das Objekt geeignet sind this .

Weitere Informationen

• AppPrefs
• monocatalog
• Apple-Dokumentation für NSNotificationCenter